How lalbabukumar12/progress_tracker works
Progress Tracker is a full-stack platform for collecting competitive-programming and GitHub progress, presenting student analytics and rankings, and supporting contests, chat, and code execution. The main workflow is student profile and handle management, platform-stat refresh and scoring, then directory, dashboard, leaderboard, and comparison views; separate branches provide contests, chat, and an IDE. The source index and excerpts support the backend routes, refresh orchestration, and selected storage relationships. Several frontend API calls and backend services were not shown, so uncertain connections are omitted or marked dashed.
Main entry points: App.jsx App router · studentController.js Student workflows · studentRoutes.js Student routes · Chat.jsx Community chat UI
Components 30
Web application
- App router
client/src/App.jsx - Student directory
client/src/pages/Home.jsx - Progress dashboard
client/src/pages/Dashboard.jsx - Leaderboard
client/src/pages/Leaderboard.jsx - Student comparison
client/src/pages/Compare.jsx - Profile management
client/src/pages/Profile.jsx - Contest calendar
client/src/pages/Contests.jsx - Community chat UI
client/src/pages/Chat.jsx - Online code IDE
client/src/pages/IDE.jsx - Theme state
client/src/context/ThemeContext.jsx
API and identity
- Auth routes
server/src/routes/authRoutes.js - Authentication
server/src/controllers/authController.js - Student routes
server/src/routes/studentRoutes.js - Contest routes
server/src/routes/contestRoutes.js - Chat history route
server/src/routes/chatRoutes.js - Execution handler
server/src/controllers/executeController.js
Progress data
- Student workflows
server/src/controllers/studentController.js - Platform statistics
server/src/services - Composite scoring
server/src/services/scoringService.js - Student profiles
server/src/models/Student.js - Stats snapshots
server/src/models/StatsSnapshot.js - Monthly records
server/src/models/MonthlyRecord.js - MongoDB
Community and tools
- Contest aggregation
server/src/services/contestService.js - Live chat and presence
server/src/socket.js - Chat messages
server/src/models/ChatMessage.js - Judge0 client
server/src/services/judge0Service.js
Other components
- Student
- Coding platforms and GitHub
- Judge0 service
Connections 35
- App router → Student directory: routes to
client/src/App.jsx - App router → Progress dashboard: routes to
client/src/App.jsx - App router → Leaderboard: routes to
client/src/App.jsx - App router → Student comparison: routes to
client/src/App.jsx - App router → Profile management: routes to
client/src/App.jsx - App router → Contest calendar: routes to
client/src/App.jsx - App router → Community chat UI: routes to
client/src/App.jsx - App router → Online code IDE: routes to
client/src/App.jsx - App router → Theme state: provides
client/src/App.jsx - Student directory → Student routes: loads directory
- Progress dashboard → Student routes: loads analytics
- Leaderboard → Student routes: loads rankings
- Student comparison → Student routes: requests comparison
- Profile management → Student routes: updates profile
- Student routes → Student workflows: dispatches
server/src/routes/studentRoutes.js - Auth routes → Authentication: dispatches
server/src/routes/authRoutes.js - Student → Profile management: manages profile
- Student workflows → Platform statistics: fetches stats
server/src/controllers/studentController.js - Platform statistics → Coding platforms and GitHub: fetches metrics
server/src/services/gfgService.js - Student workflows → Stats snapshots: writes snapshots
server/src/controllers/studentController.js - Student workflows → Student profiles: reads and updates
server/src/controllers/studentController.js - Student workflows → Composite scoring: computes scores
server/src/controllers/studentController.js - Student workflows → Monthly records: reads records
server/src/controllers/studentController.js - Student profiles → MongoDB: persists
- Stats snapshots → MongoDB: persists
- Monthly records → MongoDB: persists
- Contest calendar → Contest routes: loads contests
- Contest routes → Contest aggregation: calls
server/src/routes/contestRoutes.js - Community chat UI → Chat history route: loads history
- Chat history route → Chat messages: reads history
server/src/routes/chatRoutes.js - Community chat UI → Live chat and presence: exchanges messages
- Live chat and presence → Chat messages: uses messages
server/src/socket.js - Online code IDE → Execution handler: submits code
- Execution handler → Judge0 client: calls
server/src/controllers/executeController.js - Judge0 client → Judge0 service: submits execution