# kingsly-jr/learning-management-system architecture

> Architecture diagram of the GitHub repository kingsly-jr/learning-management-system, 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/kingsly-jr/learning-management-system
- Repository: https://github.com/kingsly-jr/learning-management-system

## Overview

LearnSphere is a full-stack learning management system. A learner discovers a course in the React portal, uses the shared API client to browse or enroll, then studies lessons, submits work, discusses course material, and can earn a completion certificate. Instructors create courses and manage learners and grading; administrators oversee users, courses, and payments. The backend exposes Spring services and persists LMS records in MySQL. The graph follows documented capabilities and the sampled frontend/API and course-review wiring; unsampled feature internals are represented at their source directories.

Main entry points: [`backend/src/main/java/com/lms/backend/entity`](https://github.com/kingsly-jr/learning-management-system/tree/main/backend/src/main/java/com/lms/backend/entity) (LMS records), [`frontend/src/App.jsx`](https://github.com/kingsly-jr/learning-management-system/blob/main/frontend/src/App.jsx) (Portal routing), [`backend/src/main/java/com/lms/backend/controller`](https://github.com/kingsly-jr/learning-management-system/tree/main/backend/src/main/java/com/lms/backend/controller) (REST controllers), [`frontend/src/pages/StudentLessonView.jsx`](https://github.com/kingsly-jr/learning-management-system/blob/main/frontend/src/pages/StudentLessonView.jsx) (Lesson workspace)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_portal["Learner and staff portal"]
  node_app["Portal routing<br/>[App.jsx]"]
  node_catalog["Course discovery<br/>[LandingPage.jsx]"]
  node_lessonview["Lesson workspace"]
  node_discussionui["Discussion board UI"]
  node_staffui["Staff dashboards"]
  node_client["API client<br/>[api.js]"]
end

subgraph group_backend["Backend application"]
  node_api["REST controllers"]
  node_records[("LMS records")]
end

subgraph group_learning["Learning domain"]
  node_courseservice["Course management<br/>[CourseService.java]"]
  node_coursereviews["Course reviews"]
  node_studentactions["Enrollment and progress"]
  node_instructorops["Instructor tools"]
  node_discussions["Discussion services"]
  node_analytics["Learning analytics"]
  node_certificates["Certificates"]
end

subgraph group_platform["Platform services"]
  node_auth["Authentication"]
  node_userlookup["User lookup"]
  node_payments["Payments and enrollment"]
  node_email["Email notifications<br/>[EmailService.java]"]
end

node_student(("Student"))
node_instructor(("Instructor"))
node_admin(("Administrator"))
node_mysql[("MySQL")]
node_razorpay["Razorpay"]

node_student -->|"uses portal"| node_app
node_instructor -->|"uses portal"| node_app
node_admin -->|"uses portal"| node_app
node_app -->|"routes to"| node_catalog
node_app -->|"routes to"| node_lessonview
node_app -->|"renders"| node_staffui
node_lessonview -->|"renders"| node_discussionui
node_catalog -->|"requests data"| node_client
node_lessonview -->|"requests data"| node_client
node_client -->|"HTTP requests"| node_api
node_api -->|"delegates"| node_courseservice
node_api -->|"delegates"| node_coursereviews
node_student -->|"browses courses"| node_catalog
node_student -->|"studies lessons"| node_lessonview
node_student -->|"discusses"| node_discussions
node_instructor -->|"creates courses"| node_courseservice
node_instructor -->|"reviews learners"| node_instructorops
node_instructor -->|"tracks performance"| node_analytics
node_admin -->|"manages platform"| node_api
node_api -.->|"authenticates"| node_auth
node_auth -->|"loads identity"| node_userlookup
node_userlookup -->|"looks up users"| node_records
node_courseservice -.->|"persists courses"| node_records
node_coursereviews -.->|"reads and writes"| node_records
node_studentactions -.->|"updates progress"| node_records
node_instructorops -.->|"reads learning data"| node_records
node_discussions -.->|"stores discussions"| node_records
node_analytics -.->|"aggregates activity"| node_records
node_payments -.->|"processes payments"| node_razorpay
node_payments -->|"records transactions"| node_records
node_payments -->|"sends confirmations"| node_email
node_studentactions -->|"generates certificates"| node_certificates
node_certificates -.->|"uses certificate data"| node_records
node_records -->|"stored in"| node_mysql

click node_app "https://github.com/kingsly-jr/learning-management-system/blob/main/frontend/src/App.jsx"
click node_catalog "https://github.com/kingsly-jr/learning-management-system/blob/main/frontend/src/pages/LandingPage.jsx"
click node_lessonview "https://github.com/kingsly-jr/learning-management-system/blob/main/frontend/src/pages/StudentLessonView.jsx"
click node_discussionui "https://github.com/kingsly-jr/learning-management-system/blob/main/frontend/src/components/DiscussionBoard.jsx"
click node_staffui "https://github.com/kingsly-jr/learning-management-system/blob/main/frontend/src/components/AdminDashboardMock.jsx"
click node_client "https://github.com/kingsly-jr/learning-management-system/blob/main/frontend/src/utils/api.js"
click node_api "https://github.com/kingsly-jr/learning-management-system/tree/main/backend/src/main/java/com/lms/backend/controller"
click node_auth "https://github.com/kingsly-jr/learning-management-system/blob/main/backend/src/main/java/com/lms/backend/service/impl/AuthServiceImpl.java"
click node_userlookup "https://github.com/kingsly-jr/learning-management-system/blob/main/backend/src/main/java/com/lms/backend/config/CustomUserDetailsService.java"
click node_courseservice "https://github.com/kingsly-jr/learning-management-system/blob/main/backend/src/main/java/com/lms/backend/service/CourseService.java"
click node_coursereviews "https://github.com/kingsly-jr/learning-management-system/blob/main/backend/src/main/java/com/lms/backend/service/impl/CourseReviewServiceImpl.java"
click node_studentactions "https://github.com/kingsly-jr/learning-management-system/blob/main/backend/src/main/java/com/lms/backend/service/StudentActionService.java"
click node_instructorops "https://github.com/kingsly-jr/learning-management-system/blob/main/backend/src/main/java/com/lms/backend/service/InstructorDashboardService.java"
click node_discussions "https://github.com/kingsly-jr/learning-management-system/blob/main/backend/src/main/java/com/lms/backend/service/DiscussionService.java"
click node_analytics "https://github.com/kingsly-jr/learning-management-system/blob/main/backend/src/main/java/com/lms/backend/service/AnalyticsService.java"
click node_payments "https://github.com/kingsly-jr/learning-management-system/blob/main/backend/src/main/java/com/lms/backend/service/PaymentService.java"
click node_certificates "https://github.com/kingsly-jr/learning-management-system/blob/main/backend/src/main/java/com/lms/backend/service/impl/PdfCertificateServiceImpl.java"
click node_email "https://github.com/kingsly-jr/learning-management-system/blob/main/backend/src/main/java/com/lms/backend/service/EmailService.java"
click node_records "https://github.com/kingsly-jr/learning-management-system/tree/main/backend/src/main/java/com/lms/backend/entity"

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_catalog,node_lessonview,node_discussionui,node_staffui,node_client toneBlue
class node_api,node_records,node_mysql toneAmber
class node_courseservice,node_coursereviews,node_studentactions,node_instructorops,node_discussions,node_analytics,node_certificates toneMint
class node_auth,node_userlookup,node_payments,node_email toneRose
class node_student,node_instructor,node_admin,node_razorpay toneIndigo
```

## Components

### Learner and staff portal

- [Portal routing](https://github.com/kingsly-jr/learning-management-system/blob/main/frontend/src/App.jsx): `frontend/src/App.jsx`
- [Course discovery](https://github.com/kingsly-jr/learning-management-system/blob/main/frontend/src/pages/LandingPage.jsx): `frontend/src/pages/LandingPage.jsx`
- [Lesson workspace](https://github.com/kingsly-jr/learning-management-system/blob/main/frontend/src/pages/StudentLessonView.jsx): `frontend/src/pages/StudentLessonView.jsx`
- [Discussion board UI](https://github.com/kingsly-jr/learning-management-system/blob/main/frontend/src/components/DiscussionBoard.jsx): `frontend/src/components/DiscussionBoard.jsx`
- [Staff dashboards](https://github.com/kingsly-jr/learning-management-system/blob/main/frontend/src/components/AdminDashboardMock.jsx): `frontend/src/components/AdminDashboardMock.jsx`
- [API client](https://github.com/kingsly-jr/learning-management-system/blob/main/frontend/src/utils/api.js): `frontend/src/utils/api.js`

### Backend application

- [REST controllers](https://github.com/kingsly-jr/learning-management-system/tree/main/backend/src/main/java/com/lms/backend/controller): `backend/src/main/java/com/lms/backend/controller`
- [LMS records](https://github.com/kingsly-jr/learning-management-system/tree/main/backend/src/main/java/com/lms/backend/entity): `backend/src/main/java/com/lms/backend/entity`

### Learning domain

- [Course management](https://github.com/kingsly-jr/learning-management-system/blob/main/backend/src/main/java/com/lms/backend/service/CourseService.java): `backend/src/main/java/com/lms/backend/service/CourseService.java`
- [Course reviews](https://github.com/kingsly-jr/learning-management-system/blob/main/backend/src/main/java/com/lms/backend/service/impl/CourseReviewServiceImpl.java): `backend/src/main/java/com/lms/backend/service/impl/CourseReviewServiceImpl.java`
- [Enrollment and progress](https://github.com/kingsly-jr/learning-management-system/blob/main/backend/src/main/java/com/lms/backend/service/StudentActionService.java): `backend/src/main/java/com/lms/backend/service/StudentActionService.java`
- [Instructor tools](https://github.com/kingsly-jr/learning-management-system/blob/main/backend/src/main/java/com/lms/backend/service/InstructorDashboardService.java): `backend/src/main/java/com/lms/backend/service/InstructorDashboardService.java`
- [Discussion services](https://github.com/kingsly-jr/learning-management-system/blob/main/backend/src/main/java/com/lms/backend/service/DiscussionService.java): `backend/src/main/java/com/lms/backend/service/DiscussionService.java`
- [Learning analytics](https://github.com/kingsly-jr/learning-management-system/blob/main/backend/src/main/java/com/lms/backend/service/AnalyticsService.java): `backend/src/main/java/com/lms/backend/service/AnalyticsService.java`
- [Certificates](https://github.com/kingsly-jr/learning-management-system/blob/main/backend/src/main/java/com/lms/backend/service/impl/PdfCertificateServiceImpl.java): `backend/src/main/java/com/lms/backend/service/impl/PdfCertificateServiceImpl.java`

### Platform services

- [Authentication](https://github.com/kingsly-jr/learning-management-system/blob/main/backend/src/main/java/com/lms/backend/service/impl/AuthServiceImpl.java): `backend/src/main/java/com/lms/backend/service/impl/AuthServiceImpl.java`
- [User lookup](https://github.com/kingsly-jr/learning-management-system/blob/main/backend/src/main/java/com/lms/backend/config/CustomUserDetailsService.java): `backend/src/main/java/com/lms/backend/config/CustomUserDetailsService.java`
- [Payments and enrollment](https://github.com/kingsly-jr/learning-management-system/blob/main/backend/src/main/java/com/lms/backend/service/PaymentService.java): `backend/src/main/java/com/lms/backend/service/PaymentService.java`
- [Email notifications](https://github.com/kingsly-jr/learning-management-system/blob/main/backend/src/main/java/com/lms/backend/service/EmailService.java): `backend/src/main/java/com/lms/backend/service/EmailService.java`

### Other components

- **Student**
- **Instructor**
- **Administrator**
- **MySQL**
- **Razorpay**

## Connections

- Student → Portal routing: uses portal (evidence: `README.md`)
- Instructor → Portal routing: uses portal (evidence: `README.md`)
- Administrator → Portal routing: uses portal (evidence: `README.md`)
- Portal routing → Course discovery: routes to (evidence: `frontend/src/App.jsx`)
- Portal routing → Lesson workspace: routes to (evidence: `frontend/src/App.jsx`)
- Portal routing → Staff dashboards: renders (evidence: `frontend/src/App.jsx`)
- Lesson workspace → Discussion board UI: renders (evidence: `frontend/src/pages/StudentLessonView.jsx`)
- Course discovery → API client: requests data (evidence: `frontend/src/pages/LandingPage.jsx`)
- Lesson workspace → API client: requests data (evidence: `frontend/src/pages/StudentLessonView.jsx`)
- API client → REST controllers: HTTP requests (evidence: `frontend/src/utils/api.js`)
- REST controllers → Course management: delegates (evidence: `backend/src/main/java/com/lms/backend/controller/CourseController.java`)
- REST controllers → Course reviews: delegates (evidence: `backend/src/main/java/com/lms/backend/controller/CourseReviewController.java`)
- Student → Course discovery: browses courses (evidence: `README.md`)
- Student → Lesson workspace: studies lessons (evidence: `README.md`)
- Student → Discussion services: discusses (evidence: `README.md`)
- Instructor → Course management: creates courses (evidence: `README.md`)
- Instructor → Instructor tools: reviews learners (evidence: `README.md`)
- Instructor → Learning analytics: tracks performance (evidence: `README.md`)
- Administrator → REST controllers: manages platform (evidence: `README.md`)
- REST controllers → Authentication: authenticates
- Authentication → User lookup: loads identity (evidence: `backend/src/main/java/com/lms/backend/service/impl/AuthServiceImpl.java`)
- User lookup → LMS records: looks up users (evidence: `backend/src/main/java/com/lms/backend/config/CustomUserDetailsService.java`)
- Course management → LMS records: persists courses
- Course reviews → LMS records: reads and writes (evidence: `backend/src/main/java/com/lms/backend/service/impl/CourseReviewServiceImpl.java`)
- Enrollment and progress → LMS records: updates progress
- Instructor tools → LMS records: reads learning data
- Discussion services → LMS records: stores discussions
- Learning analytics → LMS records: aggregates activity
- Payments and enrollment → Razorpay: processes payments
- Payments and enrollment → LMS records: records transactions (evidence: `backend/src/main/java/com/lms/backend/service/PaymentService.java`)
- Payments and enrollment → Email notifications: sends confirmations (evidence: `backend/src/main/java/com/lms/backend/service/PaymentService.java`)
- Enrollment and progress → Certificates: generates certificates
- Certificates → LMS records: uses certificate data
- LMS records → MySQL: stored in (evidence: `README.md`)
