How serkanbyx/lms-mern works
Lumen LMS is a full-stack learning platform: learners discover courses, enroll, study lessons, complete server-graded quizzes, and earn certificates; instructors author and submit courses for admin review and publication. The map follows browser routes through the API into domain controllers and MongoDB, with separate identity/security, media, and moderation branches. Relationships use README architecture statements and SOURCE INDEX references plus shown excerpts; unsampled subsystem links are omitted where the caller is not evidenced.
Main entry points: Enrollment.model.js Learning records · App.jsx React application · course.routes.js REST routes · auth.controller.js Identity and RBAC
Components 24
Learner and author UI
- React application
client/src/App.jsx - API client
client/src/api/axios.js - Sign-in and registration
client/src/pages/auth/LoginPage.jsx - Course discovery
client/src/pages/public/CourseCatalogPage.jsx - Learning experience
client/src/pages/student/LessonPlayerPage.jsx - Course authoring
client/src/pages/instructor/CurriculumBuilderPage.jsx - Moderation console
client/src/pages/admin/PendingReviewPage.jsx
API and access
- REST routes
server/routes/course.routes.js - Identity and RBAC
server/controllers/auth.controller.js - JWT access guard
server/middleware/auth.middleware.js
Learning domain
- Course lifecycle
server/controllers/course.controller.js - Enrollment and certificates
server/controllers/enrollment.controller.js - Lessons and progress
server/controllers/lesson.controller.js - Quiz attempts and grading
server/controllers/quiz.controller.js - Admin moderation
server/controllers/admin.controller.js - Learning records
server/models/Enrollment.model.js
Platform services
- MongoDB
- Signed media uploads
server/controllers/upload.controller.js - Rate limiting
server/middleware/rateLimit.middleware.js - Transactional email
server/utils/email.js
Other components
- Browser users
- Cloudinary
- Redis
- SMTP
Connections 23
- Browser users → React application: uses
README.md - React application → API client: requests through
client/src/api/axios.js - API client → REST routes: calls REST API
README.md - React application → Course discovery: routes to
client/src/App.jsx - React application → Learning experience: routes to
client/src/App.jsx - React application → Course authoring: routes to
client/src/App.jsx - React application → Moderation console: routes to
client/src/App.jsx - API client → Identity and RBAC: calls
client/src/api/axios.js - REST routes → Course lifecycle: dispatches
server/routes/course.routes.js - REST routes → Enrollment and certificates: dispatches
server/routes/course.routes.js - REST routes → JWT access guard: protects routes
server/routes/course.routes.js - JWT access guard → Identity and RBAC: loads user
server/middleware/auth.middleware.js - Identity and RBAC → Learning records: reads identity
server/controllers/auth.controller.js - Course lifecycle → Learning records: reads and writes
server/controllers/course.controller.js - Enrollment and certificates → Learning records: reads and writes
server/controllers/enrollment.controller.js - Lessons and progress → Learning records: updates learning state
- Quiz attempts and grading → Learning records: stores attempts
- Admin moderation → Learning records: moderates records
server/controllers/admin.controller.js - Learning records → MongoDB: persists
README.md - Signed media uploads → Cloudinary: signed uploads
README.md - Rate limiting → Redis: uses
server/middleware/rateLimit.middleware.js - Identity and RBAC → Transactional email: sends account mail
server/controllers/auth.controller.js - Transactional email → SMTP: delivers
README.md