# ahmedakhtar-07/lms architecture

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

- Interactive diagram: https://gitdiagram.com/ahmedakhtar-07/lms
- Repository: https://github.com/ahmedakhtar-07/lms

## Overview

This is a lightweight web LMS for instructor-led courses and student learning. The principal flow is: instructors create courses, modules, materials and quizzes; students browse and enroll, study modules, submit quizzes, and review progress; instructors review enrollment and performance, while eligible students claim certificates. The Express server serves the frontend and mounts the API routes, which use a shared MySQL pool and JWT middleware. The README documents the full feature set, but frontend-to-API wiring is not shown in the supplied source evidence, so those links are omitted.

Main entry points: [`backend/server.js`](https://github.com/ahmedakhtar-07/lms/blob/main/backend/server.js) (Express server), [`backend/db.js`](https://github.com/ahmedakhtar-07/lms/blob/main/backend/db.js) (MySQL pool), [`backend/middleware/auth.js`](https://github.com/ahmedakhtar-07/lms/blob/main/backend/middleware/auth.js) (JWT authorization), [`backend/routes/courses.js`](https://github.com/ahmedakhtar-07/lms/blob/main/backend/routes/courses.js) (Course management)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Web interface"]
  node_student_ui["Student pages"]
  node_course_ui["Course browsing<br/>[courses.js]"]
  node_module_ui["Module learning<br/>[course-modules.js]"]
  node_quiz_ui["Quiz screens<br/>[quiz-view.js]"]
  node_instructor_ui["Instructor tools"]
  node_certificate_ui["Certificate view<br/>[certificate.js]"]
  node_api_client["API client<br/>[api.js]"]
end

subgraph group_identity["Identity"]
  node_auth_routes["Registration and login<br/>[auth.js]"]
  node_auth_middleware["JWT authorization<br/>[auth.js]"]
end

subgraph group_learning["Learning workflows"]
  node_course_routes["Course management<br/>[courses.js]"]
  node_enrollment_routes["Enrollment management<br/>[enrollments.js]"]
  node_module_routes["Modules and materials<br/>[modules.js]"]
  node_materials_routes["Material management<br/>[materials.js]"]
  node_quiz_routes["Quizzes and grading<br/>[quizzes.js]"]
  node_attempt_routes["Quiz attempts<br/>[attempts.js]"]
  node_dashboard_routes["Progress dashboards<br/>[dashboard.js]"]
  node_certificate_routes["Certificates<br/>[certificates.js]"]
end

subgraph group_runtime["Application runtime"]
  node_server["Express server<br/>[server.js]"]
  node_db_pool[("MySQL pool<br/>[db.js]")]
  node_uploads["Uploaded materials"]
end

node_students(("Students"))
node_instructors(("Instructors"))
node_mysql[("MySQL database")]

node_students -->|"uses"| node_student_ui
node_students -->|"browses"| node_course_ui
node_students -->|"studies"| node_module_ui
node_students -->|"attempts"| node_quiz_ui
node_students -->|"views"| node_certificate_ui
node_instructors -->|"manages"| node_instructor_ui
node_server -->|"mounts"| node_auth_routes
node_server -->|"mounts"| node_course_routes
node_server -->|"mounts"| node_enrollment_routes
node_server -->|"mounts"| node_module_routes
node_server -->|"mounts"| node_materials_routes
node_server -->|"mounts"| node_quiz_routes
node_server -->|"mounts"| node_dashboard_routes
node_server -->|"mounts"| node_certificate_routes
node_server -->|"serves static files"| node_student_ui
node_server -->|"serves files"| node_uploads
node_course_routes -->|"queries"| node_db_pool
node_enrollment_routes -->|"queries"| node_db_pool
node_module_routes -->|"queries"| node_db_pool
node_materials_routes -->|"queries"| node_db_pool
node_quiz_routes -->|"queries"| node_db_pool
node_dashboard_routes -->|"queries"| node_db_pool
node_certificate_routes -->|"queries"| node_db_pool
node_auth_routes -->|"queries"| node_db_pool
node_db_pool -->|"connects to"| node_mysql
node_course_routes -->|"uses authorization"| node_auth_middleware
node_enrollment_routes -->|"uses authorization"| node_auth_middleware
node_module_routes -->|"uses authorization"| node_auth_middleware
node_materials_routes -->|"uses authorization"| node_auth_middleware
node_quiz_routes -->|"uses authorization"| node_auth_middleware
node_dashboard_routes -->|"uses authorization"| node_auth_middleware
node_certificate_routes -->|"uses authorization"| node_auth_middleware

click node_student_ui "https://github.com/ahmedakhtar-07/lms/blob/main/frontend/js/student-dashboard.js"
click node_course_ui "https://github.com/ahmedakhtar-07/lms/blob/main/frontend/js/courses.js"
click node_module_ui "https://github.com/ahmedakhtar-07/lms/blob/main/frontend/js/course-modules.js"
click node_quiz_ui "https://github.com/ahmedakhtar-07/lms/blob/main/frontend/js/quiz-view.js"
click node_instructor_ui "https://github.com/ahmedakhtar-07/lms/blob/main/frontend/js/instructor-dashboard.js"
click node_certificate_ui "https://github.com/ahmedakhtar-07/lms/blob/main/frontend/js/certificate.js"
click node_api_client "https://github.com/ahmedakhtar-07/lms/blob/main/frontend/js/api.js"
click node_auth_routes "https://github.com/ahmedakhtar-07/lms/blob/main/backend/routes/auth.js"
click node_auth_middleware "https://github.com/ahmedakhtar-07/lms/blob/main/backend/middleware/auth.js"
click node_course_routes "https://github.com/ahmedakhtar-07/lms/blob/main/backend/routes/courses.js"
click node_enrollment_routes "https://github.com/ahmedakhtar-07/lms/blob/main/backend/routes/enrollments.js"
click node_module_routes "https://github.com/ahmedakhtar-07/lms/blob/main/backend/routes/modules.js"
click node_materials_routes "https://github.com/ahmedakhtar-07/lms/blob/main/backend/routes/materials.js"
click node_quiz_routes "https://github.com/ahmedakhtar-07/lms/blob/main/backend/routes/quizzes.js"
click node_attempt_routes "https://github.com/ahmedakhtar-07/lms/blob/main/backend/routes/attempts.js"
click node_dashboard_routes "https://github.com/ahmedakhtar-07/lms/blob/main/backend/routes/dashboard.js"
click node_certificate_routes "https://github.com/ahmedakhtar-07/lms/blob/main/backend/routes/certificates.js"
click node_server "https://github.com/ahmedakhtar-07/lms/blob/main/backend/server.js"
click node_db_pool "https://github.com/ahmedakhtar-07/lms/blob/main/backend/db.js"
click node_uploads "https://github.com/ahmedakhtar-07/lms/tree/main/backend/uploads"

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_student_ui,node_course_ui,node_module_ui,node_quiz_ui,node_instructor_ui,node_certificate_ui,node_api_client toneBlue
class node_auth_routes,node_auth_middleware,node_mysql toneAmber
class node_course_routes,node_enrollment_routes,node_module_routes,node_materials_routes,node_quiz_routes,node_attempt_routes,node_dashboard_routes,node_certificate_routes toneMint
class node_server,node_db_pool,node_uploads toneRose
class node_students,node_instructors toneIndigo
```

## Components

### Web interface

- [Student pages](https://github.com/ahmedakhtar-07/lms/blob/main/frontend/js/student-dashboard.js): `frontend/js/student-dashboard.js`
- [Course browsing](https://github.com/ahmedakhtar-07/lms/blob/main/frontend/js/courses.js): `frontend/js/courses.js`
- [Module learning](https://github.com/ahmedakhtar-07/lms/blob/main/frontend/js/course-modules.js): `frontend/js/course-modules.js`
- [Quiz screens](https://github.com/ahmedakhtar-07/lms/blob/main/frontend/js/quiz-view.js): `frontend/js/quiz-view.js`
- [Instructor tools](https://github.com/ahmedakhtar-07/lms/blob/main/frontend/js/instructor-dashboard.js): `frontend/js/instructor-dashboard.js`
- [Certificate view](https://github.com/ahmedakhtar-07/lms/blob/main/frontend/js/certificate.js): `frontend/js/certificate.js`
- [API client](https://github.com/ahmedakhtar-07/lms/blob/main/frontend/js/api.js): `frontend/js/api.js`

### Identity

- [Registration and login](https://github.com/ahmedakhtar-07/lms/blob/main/backend/routes/auth.js): `backend/routes/auth.js`
- [JWT authorization](https://github.com/ahmedakhtar-07/lms/blob/main/backend/middleware/auth.js): `backend/middleware/auth.js`

### Learning workflows

- [Course management](https://github.com/ahmedakhtar-07/lms/blob/main/backend/routes/courses.js): `backend/routes/courses.js`
- [Enrollment management](https://github.com/ahmedakhtar-07/lms/blob/main/backend/routes/enrollments.js): `backend/routes/enrollments.js`
- [Modules and materials](https://github.com/ahmedakhtar-07/lms/blob/main/backend/routes/modules.js): `backend/routes/modules.js`
- [Material management](https://github.com/ahmedakhtar-07/lms/blob/main/backend/routes/materials.js): `backend/routes/materials.js`
- [Quizzes and grading](https://github.com/ahmedakhtar-07/lms/blob/main/backend/routes/quizzes.js): `backend/routes/quizzes.js`
- [Quiz attempts](https://github.com/ahmedakhtar-07/lms/blob/main/backend/routes/attempts.js): `backend/routes/attempts.js`
- [Progress dashboards](https://github.com/ahmedakhtar-07/lms/blob/main/backend/routes/dashboard.js): `backend/routes/dashboard.js`
- [Certificates](https://github.com/ahmedakhtar-07/lms/blob/main/backend/routes/certificates.js): `backend/routes/certificates.js`

### Application runtime

- [Express server](https://github.com/ahmedakhtar-07/lms/blob/main/backend/server.js): `backend/server.js`
- [MySQL pool](https://github.com/ahmedakhtar-07/lms/blob/main/backend/db.js): `backend/db.js`
- [Uploaded materials](https://github.com/ahmedakhtar-07/lms/tree/main/backend/uploads): `backend/uploads`

### Other components

- **Students**
- **Instructors**
- **MySQL database**

## Connections

- Students → Student pages: uses (evidence: `README.md`)
- Students → Course browsing: browses (evidence: `README.md`)
- Students → Module learning: studies (evidence: `README.md`)
- Students → Quiz screens: attempts (evidence: `README.md`)
- Students → Certificate view: views (evidence: `README.md`)
- Instructors → Instructor tools: manages (evidence: `README.md`)
- Express server → Registration and login: mounts (evidence: `backend/server.js`)
- Express server → Course management: mounts (evidence: `backend/server.js`)
- Express server → Enrollment management: mounts (evidence: `backend/server.js`)
- Express server → Modules and materials: mounts (evidence: `backend/server.js`)
- Express server → Material management: mounts (evidence: `backend/server.js`)
- Express server → Quizzes and grading: mounts (evidence: `backend/server.js`)
- Express server → Progress dashboards: mounts (evidence: `backend/server.js`)
- Express server → Certificates: mounts (evidence: `backend/server.js`)
- Express server → Student pages: serves static files (evidence: `backend/server.js`)
- Express server → Uploaded materials: serves files (evidence: `backend/server.js`)
- Course management → MySQL pool: queries (evidence: `backend/routes/courses.js`)
- Enrollment management → MySQL pool: queries (evidence: `backend/routes/enrollments.js`)
- Modules and materials → MySQL pool: queries (evidence: `backend/routes/modules.js`)
- Material management → MySQL pool: queries (evidence: `backend/routes/materials.js`)
- Quizzes and grading → MySQL pool: queries (evidence: `backend/routes/quizzes.js`)
- Progress dashboards → MySQL pool: queries (evidence: `backend/routes/dashboard.js`)
- Certificates → MySQL pool: queries (evidence: `backend/routes/certificates.js`)
- Registration and login → MySQL pool: queries (evidence: `backend/routes/auth.js`)
- MySQL pool → MySQL database: connects to (evidence: `backend/db.js`)
- Course management → JWT authorization: uses authorization (evidence: `backend/routes/courses.js`)
- Enrollment management → JWT authorization: uses authorization (evidence: `backend/routes/enrollments.js`)
- Modules and materials → JWT authorization: uses authorization (evidence: `backend/routes/modules.js`)
- Material management → JWT authorization: uses authorization (evidence: `backend/routes/materials.js`)
- Quizzes and grading → JWT authorization: uses authorization (evidence: `backend/routes/quizzes.js`)
- Progress dashboards → JWT authorization: uses authorization (evidence: `backend/routes/dashboard.js`)
- Certificates → JWT authorization: uses authorization (evidence: `backend/routes/certificates.js`)
