# lalbabukumar12/progress_tracker architecture

> Architecture diagram of the GitHub repository lalbabukumar12/progress_tracker, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-04). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/lalbabukumar12/progress_tracker
- Repository: https://github.com/lalbabukumar12/progress_tracker

## Overview

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: [`client/src/App.jsx`](https://github.com/lalbabukumar12/progress_tracker/blob/main/client/src/App.jsx) (App router), [`server/src/controllers/studentController.js`](https://github.com/lalbabukumar12/progress_tracker/blob/main/server/src/controllers/studentController.js) (Student workflows), [`server/src/routes/studentRoutes.js`](https://github.com/lalbabukumar12/progress_tracker/blob/main/server/src/routes/studentRoutes.js) (Student routes), [`client/src/pages/Chat.jsx`](https://github.com/lalbabukumar12/progress_tracker/blob/main/client/src/pages/Chat.jsx) (Community chat UI)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Web application"]
  node_app["App router<br/>[App.jsx]"]
  node_directory["Student directory<br/>[Home.jsx]"]
  node_dashboard["Progress dashboard<br/>[Dashboard.jsx]"]
  node_leaderboard["Leaderboard<br/>[Leaderboard.jsx]"]
  node_compare["Student comparison<br/>[Compare.jsx]"]
  node_profile["Profile management<br/>[Profile.jsx]"]
  node_contests_ui["Contest calendar<br/>[Contests.jsx]"]
  node_chat_ui["Community chat UI<br/>[Chat.jsx]"]
  node_ide_ui["Online code IDE<br/>[IDE.jsx]"]
  node_theme["Theme state<br/>[ThemeContext.jsx]"]
end

subgraph group_api["API and identity"]
  node_auth_routes["Auth routes<br/>[authRoutes.js]"]
  node_auth_controller["Authentication<br/>[authController.js]"]
  node_student_routes["Student routes<br/>[studentRoutes.js]"]
  node_contest_routes["Contest routes<br/>[contestRoutes.js]"]
  node_chat_routes["Chat history route<br/>[chatRoutes.js]"]
  node_execute["Execution handler"]
end

subgraph group_progress["Progress data"]
  node_student_controller["Student workflows"]
  node_platforms["Platform statistics"]
  node_scoring["Composite scoring<br/>[scoringService.js]"]
  node_student_model["Student profiles<br/>[Student.js]"]
  node_snapshots[("Stats snapshots<br/>[StatsSnapshot.js]")]
  node_monthly["Monthly records<br/>[MonthlyRecord.js]"]
  node_mongodb[("MongoDB")]
end

subgraph group_community["Community and tools"]
  node_contest_service["Contest aggregation<br/>[contestService.js]"]
  node_chat_socket["Live chat and presence<br/>[socket.js]"]
  node_chat_messages["Chat messages<br/>[ChatMessage.js]"]
  node_judge0["Judge0 client<br/>[judge0Service.js]"]
end

node_student(("Student"))
node_external_platforms["Coding platforms and GitHub"]
node_judge_service["Judge0 service"]

node_app -->|"routes to"| node_directory
node_app -->|"routes to"| node_dashboard
node_app -->|"routes to"| node_leaderboard
node_app -->|"routes to"| node_compare
node_app -->|"routes to"| node_profile
node_app -->|"routes to"| node_contests_ui
node_app -->|"routes to"| node_chat_ui
node_app -->|"routes to"| node_ide_ui
node_app -->|"provides"| node_theme
node_directory -.->|"loads directory"| node_student_routes
node_dashboard -.->|"loads analytics"| node_student_routes
node_leaderboard -.->|"loads rankings"| node_student_routes
node_compare -.->|"requests comparison"| node_student_routes
node_profile -.->|"updates profile"| node_student_routes
node_student_routes -->|"dispatches"| node_student_controller
node_auth_routes -->|"dispatches"| node_auth_controller
node_student -.->|"manages profile"| node_profile
node_student_controller -->|"fetches stats"| node_platforms
node_platforms -->|"fetches metrics"| node_external_platforms
node_student_controller -->|"writes snapshots"| node_snapshots
node_student_controller -->|"reads and updates"| node_student_model
node_student_controller -->|"computes scores"| node_scoring
node_student_controller -->|"reads records"| node_monthly
node_student_model -.->|"persists"| node_mongodb
node_snapshots -.->|"persists"| node_mongodb
node_monthly -.->|"persists"| node_mongodb
node_contests_ui -.->|"loads contests"| node_contest_routes
node_contest_routes -->|"calls"| node_contest_service
node_chat_ui -.->|"loads history"| node_chat_routes
node_chat_routes -->|"reads history"| node_chat_messages
node_chat_ui -.->|"exchanges messages"| node_chat_socket
node_chat_socket -->|"uses messages"| node_chat_messages
node_ide_ui -.->|"submits code"| node_execute
node_execute -->|"calls"| node_judge0
node_judge0 -.->|"submits execution"| node_judge_service

click node_app "https://github.com/lalbabukumar12/progress_tracker/blob/main/client/src/App.jsx"
click node_directory "https://github.com/lalbabukumar12/progress_tracker/blob/main/client/src/pages/Home.jsx"
click node_dashboard "https://github.com/lalbabukumar12/progress_tracker/blob/main/client/src/pages/Dashboard.jsx"
click node_leaderboard "https://github.com/lalbabukumar12/progress_tracker/blob/main/client/src/pages/Leaderboard.jsx"
click node_compare "https://github.com/lalbabukumar12/progress_tracker/blob/main/client/src/pages/Compare.jsx"
click node_profile "https://github.com/lalbabukumar12/progress_tracker/blob/main/client/src/pages/Profile.jsx"
click node_contests_ui "https://github.com/lalbabukumar12/progress_tracker/blob/main/client/src/pages/Contests.jsx"
click node_chat_ui "https://github.com/lalbabukumar12/progress_tracker/blob/main/client/src/pages/Chat.jsx"
click node_ide_ui "https://github.com/lalbabukumar12/progress_tracker/blob/main/client/src/pages/IDE.jsx"
click node_theme "https://github.com/lalbabukumar12/progress_tracker/blob/main/client/src/context/ThemeContext.jsx"
click node_auth_routes "https://github.com/lalbabukumar12/progress_tracker/blob/main/server/src/routes/authRoutes.js"
click node_auth_controller "https://github.com/lalbabukumar12/progress_tracker/blob/main/server/src/controllers/authController.js"
click node_student_routes "https://github.com/lalbabukumar12/progress_tracker/blob/main/server/src/routes/studentRoutes.js"
click node_student_controller "https://github.com/lalbabukumar12/progress_tracker/blob/main/server/src/controllers/studentController.js"
click node_platforms "https://github.com/lalbabukumar12/progress_tracker/tree/main/server/src/services"
click node_scoring "https://github.com/lalbabukumar12/progress_tracker/blob/main/server/src/services/scoringService.js"
click node_student_model "https://github.com/lalbabukumar12/progress_tracker/blob/main/server/src/models/Student.js"
click node_snapshots "https://github.com/lalbabukumar12/progress_tracker/blob/main/server/src/models/StatsSnapshot.js"
click node_monthly "https://github.com/lalbabukumar12/progress_tracker/blob/main/server/src/models/MonthlyRecord.js"
click node_contest_routes "https://github.com/lalbabukumar12/progress_tracker/blob/main/server/src/routes/contestRoutes.js"
click node_contest_service "https://github.com/lalbabukumar12/progress_tracker/blob/main/server/src/services/contestService.js"
click node_chat_routes "https://github.com/lalbabukumar12/progress_tracker/blob/main/server/src/routes/chatRoutes.js"
click node_chat_socket "https://github.com/lalbabukumar12/progress_tracker/blob/main/server/src/socket.js"
click node_chat_messages "https://github.com/lalbabukumar12/progress_tracker/blob/main/server/src/models/ChatMessage.js"
click node_execute "https://github.com/lalbabukumar12/progress_tracker/blob/main/server/src/controllers/executeController.js"
click node_judge0 "https://github.com/lalbabukumar12/progress_tracker/blob/main/server/src/services/judge0Service.js"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_app,node_directory,node_dashboard,node_leaderboard,node_compare,node_profile,node_contests_ui,node_chat_ui,node_ide_ui,node_theme toneBlue
class node_auth_routes,node_auth_controller,node_student_routes,node_contest_routes,node_chat_routes,node_execute toneAmber
class node_student_controller,node_platforms,node_scoring,node_student_model,node_snapshots,node_monthly,node_mongodb toneMint
class node_contest_service,node_chat_socket,node_chat_messages,node_judge0 toneRose
class node_student,node_external_platforms,node_judge_service toneIndigo
```

## Components

### Web application

- [App router](https://github.com/lalbabukumar12/progress_tracker/blob/main/client/src/App.jsx): `client/src/App.jsx`
- [Student directory](https://github.com/lalbabukumar12/progress_tracker/blob/main/client/src/pages/Home.jsx): `client/src/pages/Home.jsx`
- [Progress dashboard](https://github.com/lalbabukumar12/progress_tracker/blob/main/client/src/pages/Dashboard.jsx): `client/src/pages/Dashboard.jsx`
- [Leaderboard](https://github.com/lalbabukumar12/progress_tracker/blob/main/client/src/pages/Leaderboard.jsx): `client/src/pages/Leaderboard.jsx`
- [Student comparison](https://github.com/lalbabukumar12/progress_tracker/blob/main/client/src/pages/Compare.jsx): `client/src/pages/Compare.jsx`
- [Profile management](https://github.com/lalbabukumar12/progress_tracker/blob/main/client/src/pages/Profile.jsx): `client/src/pages/Profile.jsx`
- [Contest calendar](https://github.com/lalbabukumar12/progress_tracker/blob/main/client/src/pages/Contests.jsx): `client/src/pages/Contests.jsx`
- [Community chat UI](https://github.com/lalbabukumar12/progress_tracker/blob/main/client/src/pages/Chat.jsx): `client/src/pages/Chat.jsx`
- [Online code IDE](https://github.com/lalbabukumar12/progress_tracker/blob/main/client/src/pages/IDE.jsx): `client/src/pages/IDE.jsx`
- [Theme state](https://github.com/lalbabukumar12/progress_tracker/blob/main/client/src/context/ThemeContext.jsx): `client/src/context/ThemeContext.jsx`

### API and identity

- [Auth routes](https://github.com/lalbabukumar12/progress_tracker/blob/main/server/src/routes/authRoutes.js): `server/src/routes/authRoutes.js`
- [Authentication](https://github.com/lalbabukumar12/progress_tracker/blob/main/server/src/controllers/authController.js): `server/src/controllers/authController.js`
- [Student routes](https://github.com/lalbabukumar12/progress_tracker/blob/main/server/src/routes/studentRoutes.js): `server/src/routes/studentRoutes.js`
- [Contest routes](https://github.com/lalbabukumar12/progress_tracker/blob/main/server/src/routes/contestRoutes.js): `server/src/routes/contestRoutes.js`
- [Chat history route](https://github.com/lalbabukumar12/progress_tracker/blob/main/server/src/routes/chatRoutes.js): `server/src/routes/chatRoutes.js`
- [Execution handler](https://github.com/lalbabukumar12/progress_tracker/blob/main/server/src/controllers/executeController.js): `server/src/controllers/executeController.js`

### Progress data

- [Student workflows](https://github.com/lalbabukumar12/progress_tracker/blob/main/server/src/controllers/studentController.js): `server/src/controllers/studentController.js`
- [Platform statistics](https://github.com/lalbabukumar12/progress_tracker/tree/main/server/src/services): `server/src/services`
- [Composite scoring](https://github.com/lalbabukumar12/progress_tracker/blob/main/server/src/services/scoringService.js): `server/src/services/scoringService.js`
- [Student profiles](https://github.com/lalbabukumar12/progress_tracker/blob/main/server/src/models/Student.js): `server/src/models/Student.js`
- [Stats snapshots](https://github.com/lalbabukumar12/progress_tracker/blob/main/server/src/models/StatsSnapshot.js): `server/src/models/StatsSnapshot.js`
- [Monthly records](https://github.com/lalbabukumar12/progress_tracker/blob/main/server/src/models/MonthlyRecord.js): `server/src/models/MonthlyRecord.js`
- **MongoDB**

### Community and tools

- [Contest aggregation](https://github.com/lalbabukumar12/progress_tracker/blob/main/server/src/services/contestService.js): `server/src/services/contestService.js`
- [Live chat and presence](https://github.com/lalbabukumar12/progress_tracker/blob/main/server/src/socket.js): `server/src/socket.js`
- [Chat messages](https://github.com/lalbabukumar12/progress_tracker/blob/main/server/src/models/ChatMessage.js): `server/src/models/ChatMessage.js`
- [Judge0 client](https://github.com/lalbabukumar12/progress_tracker/blob/main/server/src/services/judge0Service.js): `server/src/services/judge0Service.js`

### Other components

- **Student**
- **Coding platforms and GitHub**
- **Judge0 service**

## Connections

- App router → Student directory: routes to (evidence: `client/src/App.jsx`)
- App router → Progress dashboard: routes to (evidence: `client/src/App.jsx`)
- App router → Leaderboard: routes to (evidence: `client/src/App.jsx`)
- App router → Student comparison: routes to (evidence: `client/src/App.jsx`)
- App router → Profile management: routes to (evidence: `client/src/App.jsx`)
- App router → Contest calendar: routes to (evidence: `client/src/App.jsx`)
- App router → Community chat UI: routes to (evidence: `client/src/App.jsx`)
- App router → Online code IDE: routes to (evidence: `client/src/App.jsx`)
- App router → Theme state: provides (evidence: `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 (evidence: `server/src/routes/studentRoutes.js`)
- Auth routes → Authentication: dispatches (evidence: `server/src/routes/authRoutes.js`)
- Student → Profile management: manages profile
- Student workflows → Platform statistics: fetches stats (evidence: `server/src/controllers/studentController.js`)
- Platform statistics → Coding platforms and GitHub: fetches metrics (evidence: `server/src/services/gfgService.js`)
- Student workflows → Stats snapshots: writes snapshots (evidence: `server/src/controllers/studentController.js`)
- Student workflows → Student profiles: reads and updates (evidence: `server/src/controllers/studentController.js`)
- Student workflows → Composite scoring: computes scores (evidence: `server/src/controllers/studentController.js`)
- Student workflows → Monthly records: reads records (evidence: `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 (evidence: `server/src/routes/contestRoutes.js`)
- Community chat UI → Chat history route: loads history
- Chat history route → Chat messages: reads history (evidence: `server/src/routes/chatRoutes.js`)
- Community chat UI → Live chat and presence: exchanges messages
- Live chat and presence → Chat messages: uses messages (evidence: `server/src/socket.js`)
- Online code IDE → Execution handler: submits code
- Execution handler → Judge0 client: calls (evidence: `server/src/controllers/executeController.js`)
- Judge0 client → Judge0 service: submits execution
