# developer-yash03/lms architecture

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

- Interactive diagram: https://gitdiagram.com/developer-yash03/lms
- Repository: https://github.com/developer-yash03/lms

## Overview

ScholarHub is a role-based learning platform. Learners browse courses, authenticate and purchase or enroll, then study lessons, complete quizzes and track progress; instructors build courses and review earnings, while administrators manage users and course approvals. The graph shows the React route surface, API boundary, Express route/controller layer, and Mongo-backed domain state. Some page-to-API wiring and unsampled feature internals are not shown; documented capabilities are retained without asserting unverified calls.

Main entry points: [`client/src/App.jsx`](https://github.com/developer-yash03/lms/blob/main/client/src/App.jsx) (React routes), [`server/server.js`](https://github.com/developer-yash03/lms/blob/main/server/server.js) (Express application), [`server/controllers/paymentController.js`](https://github.com/developer-yash03/lms/blob/main/server/controllers/paymentController.js) (Payment services), [`server/middlewares/auth.js`](https://github.com/developer-yash03/lms/blob/main/server/middlewares/auth.js) (JWT and roles)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Learner interface"]
  node_app["React routes<br/>[App.jsx]"]
  node_browse["Course discovery<br/>[Browse.jsx]"]
  node_course_studio["Course studio<br/>[Create.jsx]"]
  node_player["Course player<br/>[Player.jsx]"]
  node_student_quiz["Topic quizzes<br/>[TopicQuiz.jsx]"]
  node_admin_approvals["Course approvals<br/>[Approvals.jsx]"]
  node_admin_users["User management<br/>[Users.jsx]"]
end

subgraph group_identity["Identity and access"]
  node_auth_context["Session state<br/>[AuthContext.jsx]"]
  node_auth_actions["Login actions<br/>[useAuth.js]"]
  node_auth_routes["Authentication routes<br/>[auth.js]"]
  node_signup_routes["Signup routes<br/>[signup.js]"]
  node_auth_controller["Authentication handlers<br/>[authController.js]"]
  node_email_service["Email delivery<br/>[emailService.js]"]
  node_auth_middleware["JWT and roles<br/>[auth.js]"]
end

subgraph group_learning["Learning and courses"]
  node_course_routes["Course routes<br/>[course.js]"]
  node_course_controller["Course services"]
  node_quiz_routes["Quiz routes<br/>[quiz.js]"]
  node_quiz_controller["Quiz services<br/>[quizController.js]"]
end

subgraph group_commerce["Payments and revenue"]
  node_payment_routes["Payment routes<br/>[paymentRoutes.js]"]
  node_payment_controller["Payment services"]
end

subgraph group_platform["API and persistence"]
  node_api_client["API client<br/>[api.js]"]
  node_user_model[("User records<br/>[User.js]")]
  node_course_model[("Course records<br/>[Course.js]")]
  node_quiz_model[("Quiz records<br/>[Quiz.js]")]
  node_progress_model[("Learning progress<br/>[Progress.js]")]
  node_submission_model[("Task submissions<br/>[Submission.js]")]
  node_payment_model[("Payment records<br/>[Payment.js]")]
  node_express_app["Express application<br/>[server.js]"]
  node_admin_routes["Admin routes<br/>[admin.js]"]
  node_admin_controller["Admin handlers<br/>[adminController.js]"]
end

node_visitor(("Platform user"))
node_razorpay["Razorpay"]

node_visitor -->|"uses"| node_app
node_app -->|"routes to"| node_browse
node_app -->|"routes to"| node_course_studio
node_app -->|"routes to"| node_player
node_app -->|"routes to"| node_student_quiz
node_app -->|"routes to"| node_admin_approvals
node_app -->|"routes to"| node_admin_users
node_auth_actions -->|"requests login"| node_api_client
node_auth_actions -->|"updates session"| node_auth_context
node_browse -->|"requests data"| node_api_client
node_course_studio -->|"requests data"| node_api_client
node_visitor -.->|"sends API requests"| node_api_client
node_api_client -.->|"calls API"| node_express_app
node_express_app -->|"mounts"| node_auth_routes
node_express_app -->|"mounts"| node_signup_routes
node_express_app -->|"mounts"| node_course_routes
node_express_app -->|"mounts"| node_payment_routes
node_express_app -->|"mounts"| node_quiz_routes
node_express_app -->|"mounts"| node_admin_routes
node_auth_routes -->|"dispatches"| node_auth_controller
node_signup_routes -.->|"dispatches"| node_auth_controller
node_auth_routes -->|"checks token"| node_auth_middleware
node_course_routes -->|"dispatches"| node_course_controller
node_course_routes -->|"checks token"| node_auth_middleware
node_quiz_routes -->|"dispatches"| node_quiz_controller
node_quiz_routes -->|"checks token"| node_auth_middleware
node_payment_routes -->|"dispatches"| node_payment_controller
node_payment_routes -->|"checks token"| node_auth_middleware
node_admin_routes -->|"dispatches"| node_admin_controller
node_admin_routes -->|"checks token"| node_auth_middleware
node_auth_middleware -->|"loads user"| node_user_model
node_auth_controller -->|"reads and writes"| node_user_model
node_auth_controller -->|"sends OTP"| node_email_service
node_course_controller -->|"reads and writes"| node_course_model
node_course_controller -->|"reads and writes"| node_user_model
node_course_controller -->|"tracks completion"| node_progress_model
node_course_controller -->|"loads submissions"| node_submission_model
node_quiz_controller -->|"reads and writes"| node_quiz_model
node_payment_controller -->|"records payments"| node_payment_model
node_payment_controller -->|"reads course"| node_course_model
node_payment_controller -->|"enrolls learner"| node_user_model
node_payment_controller -->|"creates orders"| node_razorpay
node_payment_controller -->|"sends receipt"| node_email_service
node_admin_controller -->|"manages users"| node_user_model
node_admin_controller -->|"reviews courses"| node_course_model

click node_app "https://github.com/developer-yash03/lms/blob/main/client/src/App.jsx"
click node_browse "https://github.com/developer-yash03/lms/blob/main/client/src/pages/public/Browse.jsx"
click node_course_studio "https://github.com/developer-yash03/lms/blob/main/client/src/pages/instructor/Create.jsx"
click node_player "https://github.com/developer-yash03/lms/blob/main/client/src/pages/student/Player.jsx"
click node_student_quiz "https://github.com/developer-yash03/lms/blob/main/client/src/pages/student/TopicQuiz.jsx"
click node_admin_approvals "https://github.com/developer-yash03/lms/blob/main/client/src/pages/admin/Approvals.jsx"
click node_admin_users "https://github.com/developer-yash03/lms/blob/main/client/src/pages/admin/Users.jsx"
click node_api_client "https://github.com/developer-yash03/lms/blob/main/client/src/services/api.js"
click node_auth_context "https://github.com/developer-yash03/lms/blob/main/client/src/context/AuthContext.jsx"
click node_auth_actions "https://github.com/developer-yash03/lms/blob/main/client/src/hooks/useAuth.js"
click node_auth_routes "https://github.com/developer-yash03/lms/blob/main/server/routes/auth.js"
click node_signup_routes "https://github.com/developer-yash03/lms/blob/main/server/routes/signup.js"
click node_auth_controller "https://github.com/developer-yash03/lms/blob/main/server/controllers/authController.js"
click node_user_model "https://github.com/developer-yash03/lms/blob/main/server/models/User.js"
click node_course_routes "https://github.com/developer-yash03/lms/blob/main/server/routes/course.js"
click node_course_controller "https://github.com/developer-yash03/lms/blob/main/server/controllers/courseController.js"
click node_quiz_routes "https://github.com/developer-yash03/lms/blob/main/server/routes/quiz.js"
click node_quiz_controller "https://github.com/developer-yash03/lms/blob/main/server/controllers/quizController.js"
click node_course_model "https://github.com/developer-yash03/lms/blob/main/server/models/Course.js"
click node_quiz_model "https://github.com/developer-yash03/lms/blob/main/server/models/Quiz.js"
click node_progress_model "https://github.com/developer-yash03/lms/blob/main/server/models/Progress.js"
click node_submission_model "https://github.com/developer-yash03/lms/blob/main/server/models/Submission.js"
click node_payment_routes "https://github.com/developer-yash03/lms/blob/main/server/routes/paymentRoutes.js"
click node_payment_controller "https://github.com/developer-yash03/lms/blob/main/server/controllers/paymentController.js"
click node_payment_model "https://github.com/developer-yash03/lms/blob/main/server/models/Payment.js"
click node_email_service "https://github.com/developer-yash03/lms/blob/main/server/utils/emailService.js"
click node_express_app "https://github.com/developer-yash03/lms/blob/main/server/server.js"
click node_auth_middleware "https://github.com/developer-yash03/lms/blob/main/server/middlewares/auth.js"
click node_admin_routes "https://github.com/developer-yash03/lms/blob/main/server/routes/admin.js"
click node_admin_controller "https://github.com/developer-yash03/lms/blob/main/server/controllers/adminController.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_browse,node_course_studio,node_player,node_student_quiz,node_admin_approvals,node_admin_users,node_visitor toneBlue
class node_auth_context,node_auth_actions,node_auth_routes,node_signup_routes,node_auth_controller,node_email_service,node_auth_middleware toneAmber
class node_course_routes,node_course_controller,node_quiz_routes,node_quiz_controller toneMint
class node_payment_routes,node_payment_controller toneRose
class node_api_client,node_user_model,node_course_model,node_quiz_model,node_progress_model,node_submission_model,node_payment_model,node_express_app,node_admin_routes,node_admin_controller,node_razorpay toneIndigo
```

## Components

### Learner interface

- [React routes](https://github.com/developer-yash03/lms/blob/main/client/src/App.jsx): `client/src/App.jsx`
- [Course discovery](https://github.com/developer-yash03/lms/blob/main/client/src/pages/public/Browse.jsx): `client/src/pages/public/Browse.jsx`
- [Course studio](https://github.com/developer-yash03/lms/blob/main/client/src/pages/instructor/Create.jsx): `client/src/pages/instructor/Create.jsx`
- [Course player](https://github.com/developer-yash03/lms/blob/main/client/src/pages/student/Player.jsx): `client/src/pages/student/Player.jsx`
- [Topic quizzes](https://github.com/developer-yash03/lms/blob/main/client/src/pages/student/TopicQuiz.jsx): `client/src/pages/student/TopicQuiz.jsx`
- [Course approvals](https://github.com/developer-yash03/lms/blob/main/client/src/pages/admin/Approvals.jsx): `client/src/pages/admin/Approvals.jsx`
- [User management](https://github.com/developer-yash03/lms/blob/main/client/src/pages/admin/Users.jsx): `client/src/pages/admin/Users.jsx`

### Identity and access

- [Session state](https://github.com/developer-yash03/lms/blob/main/client/src/context/AuthContext.jsx): `client/src/context/AuthContext.jsx`
- [Login actions](https://github.com/developer-yash03/lms/blob/main/client/src/hooks/useAuth.js): `client/src/hooks/useAuth.js`
- [Authentication routes](https://github.com/developer-yash03/lms/blob/main/server/routes/auth.js): `server/routes/auth.js`
- [Signup routes](https://github.com/developer-yash03/lms/blob/main/server/routes/signup.js): `server/routes/signup.js`
- [Authentication handlers](https://github.com/developer-yash03/lms/blob/main/server/controllers/authController.js): `server/controllers/authController.js`
- [Email delivery](https://github.com/developer-yash03/lms/blob/main/server/utils/emailService.js): `server/utils/emailService.js`
- [JWT and roles](https://github.com/developer-yash03/lms/blob/main/server/middlewares/auth.js): `server/middlewares/auth.js`

### Learning and courses

- [Course routes](https://github.com/developer-yash03/lms/blob/main/server/routes/course.js): `server/routes/course.js`
- [Course services](https://github.com/developer-yash03/lms/blob/main/server/controllers/courseController.js): `server/controllers/courseController.js`
- [Quiz routes](https://github.com/developer-yash03/lms/blob/main/server/routes/quiz.js): `server/routes/quiz.js`
- [Quiz services](https://github.com/developer-yash03/lms/blob/main/server/controllers/quizController.js): `server/controllers/quizController.js`

### Payments and revenue

- [Payment routes](https://github.com/developer-yash03/lms/blob/main/server/routes/paymentRoutes.js): `server/routes/paymentRoutes.js`
- [Payment services](https://github.com/developer-yash03/lms/blob/main/server/controllers/paymentController.js): `server/controllers/paymentController.js`

### API and persistence

- [API client](https://github.com/developer-yash03/lms/blob/main/client/src/services/api.js): `client/src/services/api.js`
- [User records](https://github.com/developer-yash03/lms/blob/main/server/models/User.js): `server/models/User.js`
- [Course records](https://github.com/developer-yash03/lms/blob/main/server/models/Course.js): `server/models/Course.js`
- [Quiz records](https://github.com/developer-yash03/lms/blob/main/server/models/Quiz.js): `server/models/Quiz.js`
- [Learning progress](https://github.com/developer-yash03/lms/blob/main/server/models/Progress.js): `server/models/Progress.js`
- [Task submissions](https://github.com/developer-yash03/lms/blob/main/server/models/Submission.js): `server/models/Submission.js`
- [Payment records](https://github.com/developer-yash03/lms/blob/main/server/models/Payment.js): `server/models/Payment.js`
- [Express application](https://github.com/developer-yash03/lms/blob/main/server/server.js): `server/server.js`
- [Admin routes](https://github.com/developer-yash03/lms/blob/main/server/routes/admin.js): `server/routes/admin.js`
- [Admin handlers](https://github.com/developer-yash03/lms/blob/main/server/controllers/adminController.js): `server/controllers/adminController.js`

### Other components

- **Platform user**
- **Razorpay**

## Connections

- Platform user → React routes: uses (evidence: `client/src/App.jsx`)
- React routes → Course discovery: routes to (evidence: `client/src/App.jsx`)
- React routes → Course studio: routes to (evidence: `client/src/App.jsx`)
- React routes → Course player: routes to (evidence: `client/src/App.jsx`)
- React routes → Topic quizzes: routes to (evidence: `client/src/App.jsx`)
- React routes → Course approvals: routes to (evidence: `client/src/App.jsx`)
- React routes → User management: routes to (evidence: `client/src/App.jsx`)
- Login actions → API client: requests login (evidence: `client/src/hooks/useAuth.js`)
- Login actions → Session state: updates session (evidence: `client/src/hooks/useAuth.js`)
- Course discovery → API client: requests data (evidence: `client/src/pages/public/Browse.jsx`)
- Course studio → API client: requests data (evidence: `client/src/pages/instructor/Create.jsx`)
- Platform user → API client: sends API requests (evidence: `README.md`)
- API client → Express application: calls API (evidence: `README.md`)
- Express application → Authentication routes: mounts (evidence: `server/server.js`)
- Express application → Signup routes: mounts (evidence: `server/server.js`)
- Express application → Course routes: mounts (evidence: `server/server.js`)
- Express application → Payment routes: mounts (evidence: `server/server.js`)
- Express application → Quiz routes: mounts (evidence: `server/server.js`)
- Express application → Admin routes: mounts (evidence: `server/server.js`)
- Authentication routes → Authentication handlers: dispatches (evidence: `server/routes/auth.js`)
- Signup routes → Authentication handlers: dispatches
- Authentication routes → JWT and roles: checks token (evidence: `server/routes/auth.js`)
- Course routes → Course services: dispatches (evidence: `server/routes/course.js`)
- Course routes → JWT and roles: checks token (evidence: `server/routes/course.js`)
- Quiz routes → Quiz services: dispatches (evidence: `server/routes/quiz.js`)
- Quiz routes → JWT and roles: checks token (evidence: `server/routes/quiz.js`)
- Payment routes → Payment services: dispatches (evidence: `server/routes/paymentRoutes.js`)
- Payment routes → JWT and roles: checks token (evidence: `server/routes/paymentRoutes.js`)
- Admin routes → Admin handlers: dispatches (evidence: `server/routes/admin.js`)
- Admin routes → JWT and roles: checks token (evidence: `server/routes/admin.js`)
- JWT and roles → User records: loads user (evidence: `server/middlewares/auth.js`)
- Authentication handlers → User records: reads and writes (evidence: `server/controllers/authController.js`)
- Authentication handlers → Email delivery: sends OTP (evidence: `server/controllers/authController.js`)
- Course services → Course records: reads and writes (evidence: `server/controllers/courseController.js`)
- Course services → User records: reads and writes (evidence: `server/controllers/courseController.js`)
- Course services → Learning progress: tracks completion (evidence: `server/controllers/courseController.js`)
- Course services → Task submissions: loads submissions (evidence: `server/controllers/courseController.js`)
- Quiz services → Quiz records: reads and writes (evidence: `server/controllers/quizController.js`)
- Payment services → Payment records: records payments (evidence: `server/controllers/paymentController.js`)
- Payment services → Course records: reads course (evidence: `server/controllers/paymentController.js`)
- Payment services → User records: enrolls learner (evidence: `server/controllers/paymentController.js`)
- Payment services → Razorpay: creates orders (evidence: `server/controllers/paymentController.js`)
- Payment services → Email delivery: sends receipt (evidence: `server/controllers/paymentController.js`)
- Admin handlers → User records: manages users (evidence: `server/controllers/adminController.js`)
- Admin handlers → Course records: reviews courses (evidence: `server/controllers/adminController.js`)
