# sudheerbmb/lms architecture

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

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

## Overview

Acharya-LMS is a multi-tenant learning platform for institution admins, teachers, and students. Users enter through the React application, which loads identity, dashboard, and notification data through its API client; the FastAPI application exposes domain features for course delivery, assessment, assignments, classrooms, and credentials. Those features rely on shared identity, tenancy, and persistence layers. The README documents Zoom classrooms, coding practice, and course publishing as product capabilities. Some feature connections are not visible in sampled source, so they are shown only where documented or left unlinked.

Main entry points: [`app/main.py`](https://github.com/sudheerbmb/lms/blob/master/app/main.py) (FastAPI application), [`app/enrollment/router.py`](https://github.com/sudheerbmb/lms/blob/master/app/enrollment/router.py) (Enrollment), [`app/platform/database.py`](https://github.com/sudheerbmb/lms/blob/master/app/platform/database.py) (PostgreSQL persistence), [`app/courses/router.py`](https://github.com/sudheerbmb/lms/blob/master/app/courses/router.py) (Course catalog)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["User application"]
  node_webapp["Learning app<br/>[App.tsx]"]
  node_api_client["API client<br/>[api.ts]"]
end

subgraph group_access["Identity and tenancy"]
  node_identity["Identity and roles<br/>[service.py]"]
  node_auth["Request authentication<br/>[auth.py]"]
  node_tenancy["Organizations<br/>[service.py]"]
  node_communication["Organization communication<br/>[router.py]"]
end

subgraph group_learning["Course delivery"]
  node_courses["Course catalog<br/>[router.py]"]
  node_content["Course content<br/>[service.py]"]
  node_enrollment["Enrollment<br/>[router.py]"]
  node_learning_progress["Learning progress<br/>[service.py]"]
end

subgraph group_work["Learning activities"]
  node_assessment["Quizzes and grading<br/>[service.py]"]
  node_assignments["Assignments<br/>[service.py]"]
  node_coding["Coding sandbox<br/>[service.py]"]
  node_certificates["Certificates<br/>[service.py]"]
  node_agents["AI agents<br/>[router.py]"]
end

subgraph group_live["Live learning"]
  node_timetable["Timetable<br/>[service.py]"]
  node_classroom["Live classrooms<br/>[router.py]"]
  node_zoom["Zoom integration<br/>[service.py]"]
end

subgraph group_foundation["Platform foundation"]
  node_api_server["FastAPI application<br/>[main.py]"]
  node_notifications["Notifications<br/>[router.py]"]
  node_database[("PostgreSQL persistence<br/>[database.py]")]
  node_config["Platform configuration<br/>[config.py]"]
end

node_user(("Learner or staff"))

node_user -->|"uses"| node_webapp
node_webapp -->|"requests data"| node_api_client
node_api_client -.->|"calls API"| node_api_server
node_api_server -->|"registers routes"| node_identity
node_api_server -->|"registers routes"| node_courses
node_api_server -->|"registers routes"| node_enrollment
node_api_server -->|"registers routes"| node_assessment
node_api_server -->|"registers routes"| node_assignments
node_api_server -->|"registers routes"| node_classroom
node_api_server -->|"registers routes"| node_notifications
node_courses -->|"serves course content"| node_content
node_enrollment -->|"enrolls in courses"| node_courses
node_assessment -->|"checks enrollment"| node_enrollment
node_assignments -->|"checks enrollment"| node_enrollment
node_coding -->|"checks enrollment"| node_enrollment
node_certificates -->|"checks completion"| node_enrollment
node_classroom -->|"uses Zoom services"| node_zoom
node_timetable -.->|"schedules live classes"| node_classroom
node_identity -->|"issues credentials"| node_auth
node_communication -->|"creates notifications"| node_notifications
node_database -->|"loads models"| node_identity
node_database -->|"loads models"| node_courses
node_database -->|"loads models"| node_assessment
node_config -->|"configures connection"| node_database
node_user -->|"manages organizations"| node_tenancy
node_user -->|"views schedules"| node_timetable
node_user -->|"solves problems"| node_coding
node_user -.->|"uses AI tools"| node_agents

click node_webapp "https://github.com/sudheerbmb/lms/blob/master/frontend/src/App.tsx"
click node_api_client "https://github.com/sudheerbmb/lms/blob/master/frontend/src/lib/api.ts"
click node_api_server "https://github.com/sudheerbmb/lms/blob/master/app/main.py"
click node_identity "https://github.com/sudheerbmb/lms/blob/master/app/identity/service.py"
click node_auth "https://github.com/sudheerbmb/lms/blob/master/app/identity/auth.py"
click node_tenancy "https://github.com/sudheerbmb/lms/blob/master/app/tenancy/service.py"
click node_courses "https://github.com/sudheerbmb/lms/blob/master/app/courses/router.py"
click node_content "https://github.com/sudheerbmb/lms/blob/master/app/content/service.py"
click node_enrollment "https://github.com/sudheerbmb/lms/blob/master/app/enrollment/router.py"
click node_learning_progress "https://github.com/sudheerbmb/lms/blob/master/app/learning/service.py"
click node_assessment "https://github.com/sudheerbmb/lms/blob/master/app/assessment/service.py"
click node_assignments "https://github.com/sudheerbmb/lms/blob/master/app/assignments/service.py"
click node_coding "https://github.com/sudheerbmb/lms/blob/master/app/coding/service.py"
click node_certificates "https://github.com/sudheerbmb/lms/blob/master/app/certification/service.py"
click node_timetable "https://github.com/sudheerbmb/lms/blob/master/app/timetable/service.py"
click node_classroom "https://github.com/sudheerbmb/lms/blob/master/app/classroom/router.py"
click node_zoom "https://github.com/sudheerbmb/lms/blob/master/app/integrations/zoom/service.py"
click node_agents "https://github.com/sudheerbmb/lms/blob/master/app/agents/router.py"
click node_notifications "https://github.com/sudheerbmb/lms/blob/master/app/notifications/router.py"
click node_database "https://github.com/sudheerbmb/lms/blob/master/app/platform/database.py"
click node_config "https://github.com/sudheerbmb/lms/blob/master/app/platform/config.py"
click node_communication "https://github.com/sudheerbmb/lms/blob/master/app/communication/router.py"

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_webapp,node_api_client toneBlue
class node_identity,node_auth,node_tenancy,node_communication toneAmber
class node_courses,node_content,node_enrollment,node_learning_progress toneMint
class node_assessment,node_assignments,node_coding,node_certificates,node_agents toneRose
class node_timetable,node_classroom,node_zoom,node_user toneIndigo
class node_api_server,node_notifications,node_database,node_config toneTeal
```

## Components

### User application

- [Learning app](https://github.com/sudheerbmb/lms/blob/master/frontend/src/App.tsx): `frontend/src/App.tsx`
- [API client](https://github.com/sudheerbmb/lms/blob/master/frontend/src/lib/api.ts): `frontend/src/lib/api.ts`

### Identity and tenancy

- [Identity and roles](https://github.com/sudheerbmb/lms/blob/master/app/identity/service.py): `app/identity/service.py`
- [Request authentication](https://github.com/sudheerbmb/lms/blob/master/app/identity/auth.py): `app/identity/auth.py`
- [Organizations](https://github.com/sudheerbmb/lms/blob/master/app/tenancy/service.py): `app/tenancy/service.py`
- [Organization communication](https://github.com/sudheerbmb/lms/blob/master/app/communication/router.py): `app/communication/router.py`

### Course delivery

- [Course catalog](https://github.com/sudheerbmb/lms/blob/master/app/courses/router.py): `app/courses/router.py`
- [Course content](https://github.com/sudheerbmb/lms/blob/master/app/content/service.py): `app/content/service.py`
- [Enrollment](https://github.com/sudheerbmb/lms/blob/master/app/enrollment/router.py): `app/enrollment/router.py`
- [Learning progress](https://github.com/sudheerbmb/lms/blob/master/app/learning/service.py): `app/learning/service.py`

### Learning activities

- [Quizzes and grading](https://github.com/sudheerbmb/lms/blob/master/app/assessment/service.py): `app/assessment/service.py`
- [Assignments](https://github.com/sudheerbmb/lms/blob/master/app/assignments/service.py): `app/assignments/service.py`
- [Coding sandbox](https://github.com/sudheerbmb/lms/blob/master/app/coding/service.py): `app/coding/service.py`
- [Certificates](https://github.com/sudheerbmb/lms/blob/master/app/certification/service.py): `app/certification/service.py`
- [AI agents](https://github.com/sudheerbmb/lms/blob/master/app/agents/router.py): `app/agents/router.py`

### Live learning

- [Timetable](https://github.com/sudheerbmb/lms/blob/master/app/timetable/service.py): `app/timetable/service.py`
- [Live classrooms](https://github.com/sudheerbmb/lms/blob/master/app/classroom/router.py): `app/classroom/router.py`
- [Zoom integration](https://github.com/sudheerbmb/lms/blob/master/app/integrations/zoom/service.py): `app/integrations/zoom/service.py`

### Platform foundation

- [FastAPI application](https://github.com/sudheerbmb/lms/blob/master/app/main.py): `app/main.py`
- [Notifications](https://github.com/sudheerbmb/lms/blob/master/app/notifications/router.py): `app/notifications/router.py`
- [PostgreSQL persistence](https://github.com/sudheerbmb/lms/blob/master/app/platform/database.py): `app/platform/database.py`
- [Platform configuration](https://github.com/sudheerbmb/lms/blob/master/app/platform/config.py): `app/platform/config.py`

### Other components

- **Learner or staff**

## Connections

- Learner or staff → Learning app: uses (evidence: `README.md`)
- Learning app → API client: requests data (evidence: `frontend/src/App.tsx`)
- API client → FastAPI application: calls API
- FastAPI application → Identity and roles: registers routes (evidence: `app/main.py`)
- FastAPI application → Course catalog: registers routes (evidence: `app/main.py`)
- FastAPI application → Enrollment: registers routes (evidence: `app/main.py`)
- FastAPI application → Quizzes and grading: registers routes (evidence: `app/main.py`)
- FastAPI application → Assignments: registers routes (evidence: `app/main.py`)
- FastAPI application → Live classrooms: registers routes (evidence: `app/main.py`)
- FastAPI application → Notifications: registers routes (evidence: `app/main.py`)
- Course catalog → Course content: serves course content (evidence: `app/courses/router.py`)
- Enrollment → Course catalog: enrolls in courses (evidence: `app/enrollment/router.py`)
- Quizzes and grading → Enrollment: checks enrollment (evidence: `app/assessment/service.py`)
- Assignments → Enrollment: checks enrollment (evidence: `app/assignments/service.py`)
- Coding sandbox → Enrollment: checks enrollment (evidence: `app/coding/service.py`)
- Certificates → Enrollment: checks completion (evidence: `app/certification/service.py`)
- Live classrooms → Zoom integration: uses Zoom services (evidence: `app/classroom/router.py`)
- Timetable → Live classrooms: schedules live classes
- Identity and roles → Request authentication: issues credentials (evidence: `app/identity/auth.py`)
- Organization communication → Notifications: creates notifications (evidence: `app/communication/router.py`)
- PostgreSQL persistence → Identity and roles: loads models (evidence: `app/platform/database.py`)
- PostgreSQL persistence → Course catalog: loads models (evidence: `app/platform/database.py`)
- PostgreSQL persistence → Quizzes and grading: loads models (evidence: `app/platform/database.py`)
- Platform configuration → PostgreSQL persistence: configures connection (evidence: `app/platform/database.py`)
- Learner or staff → Organizations: manages organizations (evidence: `README.md`)
- Learner or staff → Timetable: views schedules (evidence: `README.md`)
- Learner or staff → Coding sandbox: solves problems (evidence: `README.md`)
- Learner or staff → AI agents: uses AI tools
