# dilip-reddymalla/its-time-to-dsa_server architecture

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

- Interactive diagram: https://gitdiagram.com/dilip-reddymalla/its-time-to-dsa_server
- Repository: https://github.com/dilip-reddymalla/its-time-to-dsa_server

## Overview

Its-Time-To-DSA is an Express/MongoDB backend for personalized DSA roadmaps. A user signs in with Google, completes onboarding, and receives a generated schedule; they can view assignments, record or verify solves, and see progress statistics. Separate capabilities cover problem reports and admin controls for users, pauses, and schedule integrity. The graph follows documented routes and SOURCE INDEX references; unsampled features are represented where documented, but uncertain internal calls are omitted.

Main entry points: [`src/app.js`](https://github.com/dilip-reddymalla/its-time-to-dsa_server/blob/main/src/app.js) (Express app), [`src/controllers/verifyController.js`](https://github.com/dilip-reddymalla/its-time-to-dsa_server/blob/main/src/controllers/verifyController.js) (LeetCode verification), [`src/controllers/scheduleController.js`](https://github.com/dilip-reddymalla/its-time-to-dsa_server/blob/main/src/controllers/scheduleController.js) (Schedule API), [`src/services/streakService.js`](https://github.com/dilip-reddymalla/its-time-to-dsa_server/blob/main/src/services/streakService.js) (Streak service)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["API and identity"]
  node_express["Express app<br/>[app.js]"]
  node_oauth["Google OAuth<br/>[passport.js]"]
  node_auth_routes["Auth routes<br/>[auth.js]"]
  node_auth_guard["Auth guard<br/>[authGuard.js]"]
  node_onboard_route["Onboarding route<br/>[onboarding.js]"]
  node_schedule_route["Schedule routes<br/>[schedule.js]"]
  node_user_route["User routes<br/>[user.js]"]
  node_verify_route["Verify route<br/>[verify.js]"]
  node_progress_route["Progress routes<br/>[progress.js]"]
  node_stats_route["Stats route<br/>[stats.js]"]
  node_problem_route["Problem routes<br/>[problem.js]"]
  node_admin_route["Admin routes<br/>[admin.js]"]
end

subgraph group_roadmap["Roadmap and profile"]
  node_onboard["Onboarding"]
  node_schedule_engine["Schedule engine<br/>[scheduleEngine.js]"]
  node_schedule["Schedule API"]
  node_user_control["Profile and reschedule<br/>[userController.js]"]
  node_schedule_utils["Schedule utilities<br/>[scheduleUtils.js]"]
end

subgraph group_progress["Progress and insights"]
  node_verify["LeetCode verification"]
  node_leetcode["LeetCode client<br/>[leetcodeService.js]"]
  node_progress_control["Progress tracking"]
  node_streak["Streak service<br/>[streakService.js]"]
  node_stats["Statistics<br/>[statsController.js]"]
  node_date_utils["Date utilities<br/>[dateUtils.js]"]
end

subgraph group_moderation["Admin and problem quality"]
  node_problem_control["Problem reports"]
  node_admin["Admin operations<br/>[adminController.js]"]
end

subgraph group_data["Persistent data"]
  node_user_model[("User records<br/>[User.js]")]
  node_problem_model[("Problem catalog<br/>[Problem.js]")]
  node_schedule_model[("Schedule records<br/>[Schedule.js]")]
  node_progress_model[("Progress records<br/>[Progress.js]")]
  node_report_model[("Problem reports<br/>[Report.js]")]
  node_config_model[("Platform config<br/>[PlatformConfig.js]")]
  node_pause_model[("Pause requests<br/>[PauseRequest.js]")]
end

node_user(("Learner"))
node_admin_actor(("Administrator"))

node_user -->|"uses API"| node_express
node_admin_actor -->|"uses API"| node_express
node_express -->|"routes to"| node_auth_routes
node_express -->|"routes to"| node_onboard_route
node_express -->|"routes to"| node_schedule_route
node_express -->|"routes to"| node_user_route
node_express -->|"routes to"| node_verify_route
node_express -->|"routes to"| node_progress_route
node_express -->|"routes to"| node_stats_route
node_express -->|"routes to"| node_problem_route
node_express -->|"routes to"| node_admin_route
node_express -->|"initializes"| node_oauth
node_auth_routes -->|"uses strategy"| node_oauth
node_auth_routes -->|"checks identity"| node_auth_guard
node_auth_guard -->|"loads user"| node_user_model
node_onboard_route -->|"dispatches"| node_onboard
node_onboard -->|"generates roadmap"| node_schedule_engine
node_onboard -->|"reads and updates"| node_user_model
node_onboard -->|"creates schedule"| node_schedule_model
node_schedule_engine -->|"reads preferences"| node_user_model
node_schedule_engine -->|"selects problems"| node_problem_model
node_schedule_engine -->|"stores roadmap"| node_schedule_model
node_schedule_route -->|"dispatches"| node_schedule
node_schedule -->|"reads schedule"| node_schedule_model
node_schedule -->|"reads progress"| node_progress_model
node_schedule -->|"loads problems"| node_problem_model
node_schedule -->|"checks reports"| node_report_model
node_schedule -->|"checks platform state"| node_config_model
node_user_route -->|"dispatches"| node_user_control
node_user_control -->|"regenerates roadmap"| node_schedule_engine
node_user_control -->|"updates profile"| node_user_model
node_user_control -->|"manages schedule"| node_schedule_model
node_verify_route -->|"dispatches"| node_verify
node_verify -->|"checks submissions"| node_leetcode
node_verify -->|"reads assignment"| node_schedule_model
node_verify -->|"loads problems"| node_problem_model
node_verify -->|"records solves"| node_progress_model
node_verify -->|"updates totals"| node_user_model
node_verify -->|"checks pause"| node_config_model
node_verify -->|"updates streak"| node_streak
node_streak -->|"updates streak data"| node_user_model
node_streak -->|"checks solves"| node_progress_model
node_streak -->|"checks rest days"| node_schedule_model
node_streak -->|"checks global pause"| node_config_model
node_streak -->|"uses date rules"| node_date_utils
node_progress_route -->|"dispatches"| node_progress_control
node_progress_control -->|"updates progress"| node_progress_model
node_progress_control -->|"checks problems"| node_problem_model

click node_express "https://github.com/dilip-reddymalla/its-time-to-dsa_server/blob/main/src/app.js"
click node_oauth "https://github.com/dilip-reddymalla/its-time-to-dsa_server/blob/main/src/config/passport.js"
click node_auth_routes "https://github.com/dilip-reddymalla/its-time-to-dsa_server/blob/main/src/routes/auth.js"
click node_auth_guard "https://github.com/dilip-reddymalla/its-time-to-dsa_server/blob/main/src/middleware/authGuard.js"
click node_onboard_route "https://github.com/dilip-reddymalla/its-time-to-dsa_server/blob/main/src/routes/onboarding.js"
click node_onboard "https://github.com/dilip-reddymalla/its-time-to-dsa_server/blob/main/src/controllers/onboardingController.js"
click node_schedule_engine "https://github.com/dilip-reddymalla/its-time-to-dsa_server/blob/main/src/services/scheduleEngine.js"
click node_schedule_route "https://github.com/dilip-reddymalla/its-time-to-dsa_server/blob/main/src/routes/schedule.js"
click node_schedule "https://github.com/dilip-reddymalla/its-time-to-dsa_server/blob/main/src/controllers/scheduleController.js"
click node_user_route "https://github.com/dilip-reddymalla/its-time-to-dsa_server/blob/main/src/routes/user.js"
click node_user_control "https://github.com/dilip-reddymalla/its-time-to-dsa_server/blob/main/src/controllers/userController.js"
click node_verify_route "https://github.com/dilip-reddymalla/its-time-to-dsa_server/blob/main/src/routes/verify.js"
click node_verify "https://github.com/dilip-reddymalla/its-time-to-dsa_server/blob/main/src/controllers/verifyController.js"
click node_leetcode "https://github.com/dilip-reddymalla/its-time-to-dsa_server/blob/main/src/services/leetcodeService.js"
click node_progress_route "https://github.com/dilip-reddymalla/its-time-to-dsa_server/blob/main/src/routes/progress.js"
click node_progress_control "https://github.com/dilip-reddymalla/its-time-to-dsa_server/blob/main/src/controllers/progressController.js"
click node_streak "https://github.com/dilip-reddymalla/its-time-to-dsa_server/blob/main/src/services/streakService.js"
click node_stats_route "https://github.com/dilip-reddymalla/its-time-to-dsa_server/blob/main/src/routes/stats.js"
click node_stats "https://github.com/dilip-reddymalla/its-time-to-dsa_server/blob/main/src/controllers/statsController.js"
click node_problem_route "https://github.com/dilip-reddymalla/its-time-to-dsa_server/blob/main/src/routes/problem.js"
click node_problem_control "https://github.com/dilip-reddymalla/its-time-to-dsa_server/blob/main/src/controllers/problemController.js"
click node_admin_route "https://github.com/dilip-reddymalla/its-time-to-dsa_server/blob/main/src/routes/admin.js"
click node_admin "https://github.com/dilip-reddymalla/its-time-to-dsa_server/blob/main/src/controllers/adminController.js"
click node_user_model "https://github.com/dilip-reddymalla/its-time-to-dsa_server/blob/main/src/models/User.js"
click node_problem_model "https://github.com/dilip-reddymalla/its-time-to-dsa_server/blob/main/src/models/Problem.js"
click node_schedule_model "https://github.com/dilip-reddymalla/its-time-to-dsa_server/blob/main/src/models/Schedule.js"
click node_progress_model "https://github.com/dilip-reddymalla/its-time-to-dsa_server/blob/main/src/models/Progress.js"
click node_report_model "https://github.com/dilip-reddymalla/its-time-to-dsa_server/blob/main/src/models/Report.js"
click node_config_model "https://github.com/dilip-reddymalla/its-time-to-dsa_server/blob/main/src/models/PlatformConfig.js"
click node_pause_model "https://github.com/dilip-reddymalla/its-time-to-dsa_server/blob/main/src/models/PauseRequest.js"
click node_date_utils "https://github.com/dilip-reddymalla/its-time-to-dsa_server/blob/main/src/utils/dateUtils.js"
click node_schedule_utils "https://github.com/dilip-reddymalla/its-time-to-dsa_server/blob/main/src/utils/scheduleUtils.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_express,node_oauth,node_auth_routes,node_auth_guard,node_onboard_route,node_schedule_route,node_user_route,node_verify_route,node_progress_route,node_stats_route,node_problem_route,node_admin_route toneBlue
class node_onboard,node_schedule_engine,node_schedule,node_user_control,node_schedule_utils toneAmber
class node_verify,node_leetcode,node_progress_control,node_streak,node_stats,node_date_utils toneMint
class node_problem_control,node_admin toneRose
class node_user_model,node_problem_model,node_schedule_model,node_progress_model,node_report_model,node_config_model,node_pause_model,node_user,node_admin_actor toneIndigo
```

## Components

### API and identity

- [Express app](https://github.com/dilip-reddymalla/its-time-to-dsa_server/blob/main/src/app.js): `src/app.js`
- [Google OAuth](https://github.com/dilip-reddymalla/its-time-to-dsa_server/blob/main/src/config/passport.js): `src/config/passport.js`
- [Auth routes](https://github.com/dilip-reddymalla/its-time-to-dsa_server/blob/main/src/routes/auth.js): `src/routes/auth.js`
- [Auth guard](https://github.com/dilip-reddymalla/its-time-to-dsa_server/blob/main/src/middleware/authGuard.js): `src/middleware/authGuard.js`
- [Onboarding route](https://github.com/dilip-reddymalla/its-time-to-dsa_server/blob/main/src/routes/onboarding.js): `src/routes/onboarding.js`
- [Schedule routes](https://github.com/dilip-reddymalla/its-time-to-dsa_server/blob/main/src/routes/schedule.js): `src/routes/schedule.js`
- [User routes](https://github.com/dilip-reddymalla/its-time-to-dsa_server/blob/main/src/routes/user.js): `src/routes/user.js`
- [Verify route](https://github.com/dilip-reddymalla/its-time-to-dsa_server/blob/main/src/routes/verify.js): `src/routes/verify.js`
- [Progress routes](https://github.com/dilip-reddymalla/its-time-to-dsa_server/blob/main/src/routes/progress.js): `src/routes/progress.js`
- [Stats route](https://github.com/dilip-reddymalla/its-time-to-dsa_server/blob/main/src/routes/stats.js): `src/routes/stats.js`
- [Problem routes](https://github.com/dilip-reddymalla/its-time-to-dsa_server/blob/main/src/routes/problem.js): `src/routes/problem.js`
- [Admin routes](https://github.com/dilip-reddymalla/its-time-to-dsa_server/blob/main/src/routes/admin.js): `src/routes/admin.js`

### Roadmap and profile

- [Onboarding](https://github.com/dilip-reddymalla/its-time-to-dsa_server/blob/main/src/controllers/onboardingController.js): `src/controllers/onboardingController.js`
- [Schedule engine](https://github.com/dilip-reddymalla/its-time-to-dsa_server/blob/main/src/services/scheduleEngine.js): `src/services/scheduleEngine.js`
- [Schedule API](https://github.com/dilip-reddymalla/its-time-to-dsa_server/blob/main/src/controllers/scheduleController.js): `src/controllers/scheduleController.js`
- [Profile and reschedule](https://github.com/dilip-reddymalla/its-time-to-dsa_server/blob/main/src/controllers/userController.js): `src/controllers/userController.js`
- [Schedule utilities](https://github.com/dilip-reddymalla/its-time-to-dsa_server/blob/main/src/utils/scheduleUtils.js): `src/utils/scheduleUtils.js`

### Progress and insights

- [LeetCode verification](https://github.com/dilip-reddymalla/its-time-to-dsa_server/blob/main/src/controllers/verifyController.js): `src/controllers/verifyController.js`
- [LeetCode client](https://github.com/dilip-reddymalla/its-time-to-dsa_server/blob/main/src/services/leetcodeService.js): `src/services/leetcodeService.js`
- [Progress tracking](https://github.com/dilip-reddymalla/its-time-to-dsa_server/blob/main/src/controllers/progressController.js): `src/controllers/progressController.js`
- [Streak service](https://github.com/dilip-reddymalla/its-time-to-dsa_server/blob/main/src/services/streakService.js): `src/services/streakService.js`
- [Statistics](https://github.com/dilip-reddymalla/its-time-to-dsa_server/blob/main/src/controllers/statsController.js): `src/controllers/statsController.js`
- [Date utilities](https://github.com/dilip-reddymalla/its-time-to-dsa_server/blob/main/src/utils/dateUtils.js): `src/utils/dateUtils.js`

### Admin and problem quality

- [Problem reports](https://github.com/dilip-reddymalla/its-time-to-dsa_server/blob/main/src/controllers/problemController.js): `src/controllers/problemController.js`
- [Admin operations](https://github.com/dilip-reddymalla/its-time-to-dsa_server/blob/main/src/controllers/adminController.js): `src/controllers/adminController.js`

### Persistent data

- [User records](https://github.com/dilip-reddymalla/its-time-to-dsa_server/blob/main/src/models/User.js): `src/models/User.js`
- [Problem catalog](https://github.com/dilip-reddymalla/its-time-to-dsa_server/blob/main/src/models/Problem.js): `src/models/Problem.js`
- [Schedule records](https://github.com/dilip-reddymalla/its-time-to-dsa_server/blob/main/src/models/Schedule.js): `src/models/Schedule.js`
- [Progress records](https://github.com/dilip-reddymalla/its-time-to-dsa_server/blob/main/src/models/Progress.js): `src/models/Progress.js`
- [Problem reports](https://github.com/dilip-reddymalla/its-time-to-dsa_server/blob/main/src/models/Report.js): `src/models/Report.js`
- [Platform config](https://github.com/dilip-reddymalla/its-time-to-dsa_server/blob/main/src/models/PlatformConfig.js): `src/models/PlatformConfig.js`
- [Pause requests](https://github.com/dilip-reddymalla/its-time-to-dsa_server/blob/main/src/models/PauseRequest.js): `src/models/PauseRequest.js`

### Other components

- **Learner**
- **Administrator**

## Connections

- Learner → Express app: uses API (evidence: `README.md`)
- Administrator → Express app: uses API (evidence: `README.md`)
- Express app → Auth routes: routes to (evidence: `src/app.js`)
- Express app → Onboarding route: routes to (evidence: `src/app.js`)
- Express app → Schedule routes: routes to (evidence: `src/app.js`)
- Express app → User routes: routes to (evidence: `src/app.js`)
- Express app → Verify route: routes to (evidence: `src/app.js`)
- Express app → Progress routes: routes to (evidence: `src/app.js`)
- Express app → Stats route: routes to (evidence: `src/app.js`)
- Express app → Problem routes: routes to (evidence: `src/app.js`)
- Express app → Admin routes: routes to (evidence: `src/app.js`)
- Express app → Google OAuth: initializes (evidence: `src/app.js`)
- Auth routes → Google OAuth: uses strategy (evidence: `src/routes/auth.js`)
- Auth routes → Auth guard: checks identity (evidence: `src/routes/auth.js`)
- Auth guard → User records: loads user (evidence: `src/middleware/authGuard.js`)
- Onboarding route → Onboarding: dispatches (evidence: `src/routes/onboarding.js`)
- Onboarding → Schedule engine: generates roadmap (evidence: `src/controllers/onboardingController.js`)
- Onboarding → User records: reads and updates (evidence: `src/controllers/onboardingController.js`)
- Onboarding → Schedule records: creates schedule (evidence: `src/controllers/onboardingController.js`)
- Schedule engine → User records: reads preferences (evidence: `src/services/scheduleEngine.js`)
- Schedule engine → Problem catalog: selects problems (evidence: `src/services/scheduleEngine.js`)
- Schedule engine → Schedule records: stores roadmap (evidence: `src/services/scheduleEngine.js`)
- Schedule routes → Schedule API: dispatches (evidence: `src/routes/schedule.js`)
- Schedule API → Schedule records: reads schedule (evidence: `src/controllers/scheduleController.js`)
- Schedule API → Progress records: reads progress (evidence: `src/controllers/scheduleController.js`)
- Schedule API → Problem catalog: loads problems (evidence: `src/controllers/scheduleController.js`)
- Schedule API → Problem reports: checks reports (evidence: `src/controllers/scheduleController.js`)
- Schedule API → Platform config: checks platform state (evidence: `src/controllers/scheduleController.js`)
- User routes → Profile and reschedule: dispatches (evidence: `src/routes/user.js`)
- Profile and reschedule → Schedule engine: regenerates roadmap (evidence: `src/controllers/userController.js`)
- Profile and reschedule → User records: updates profile (evidence: `src/controllers/userController.js`)
- Profile and reschedule → Schedule records: manages schedule (evidence: `src/controllers/userController.js`)
- Verify route → LeetCode verification: dispatches (evidence: `src/routes/verify.js`)
- LeetCode verification → LeetCode client: checks submissions (evidence: `src/controllers/verifyController.js`)
- LeetCode verification → Schedule records: reads assignment (evidence: `src/controllers/verifyController.js`)
- LeetCode verification → Problem catalog: loads problems (evidence: `src/controllers/verifyController.js`)
- LeetCode verification → Progress records: records solves (evidence: `src/controllers/verifyController.js`)
- LeetCode verification → User records: updates totals (evidence: `src/controllers/verifyController.js`)
- LeetCode verification → Platform config: checks pause (evidence: `src/controllers/verifyController.js`)
- LeetCode verification → Streak service: updates streak (evidence: `src/controllers/verifyController.js`)
- Streak service → User records: updates streak data (evidence: `src/services/streakService.js`)
- Streak service → Progress records: checks solves (evidence: `src/services/streakService.js`)
- Streak service → Schedule records: checks rest days (evidence: `src/services/streakService.js`)
- Streak service → Platform config: checks global pause (evidence: `src/services/streakService.js`)
- Streak service → Date utilities: uses date rules (evidence: `src/services/streakService.js`)
- Progress routes → Progress tracking: dispatches (evidence: `src/routes/progress.js`)
- Progress tracking → Progress records: updates progress (evidence: `src/controllers/progressController.js`)
- Progress tracking → Problem catalog: checks problems (evidence: `src/controllers/progressController.js`)
