# minnnnno/lms_project architecture

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

- Interactive diagram: https://gitdiagram.com/minnnnno/lms_project
- Repository: https://github.com/minnnnno/lms_project

## Overview

This is a server-rendered learning management system: learners browse and enroll in courses, study module content, complete assessments, and can earn verifiable certificates; instructors create learning materials and grade work, while organisation admins manage members and classes. Actix serves Tera pages and API routes, with PostgreSQL-backed domain data and integrations for payments, uploads, email, and OAuth. The graph captures documented product stages and sampled route/controller/service relationships; some unsampled subsystem links are omitted rather than inferred.

Main entry points: [`backend/src/entity`](https://github.com/minnnnno/lms_project/tree/main/backend/src/entity) (PostgreSQL domain data), [`backend/src/routes`](https://github.com/minnnnno/lms_project/tree/main/backend/src/routes) (API routing), [`backend/src/controller/user_controller.rs`](https://github.com/minnnnno/lms_project/blob/main/backend/src/controller/user_controller.rs) (Accounts and auth), [`backend/src/controller/course_controller.rs`](https://github.com/minnnnno/lms_project/blob/main/backend/src/controller/course_controller.rs) (Course catalogue)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["Web experience"]
  node_ssr["Server-rendered pages<br/>[pages.rs]"]
  node_web_assets["Browser assets"]
  node_routes["API routing"]
end

subgraph group_identity["Identity and access"]
  node_auth["Accounts and auth<br/>[user_controller.rs]"]
  node_auth_helpers["Access helpers<br/>[auth_helpers.rs]"]
end

subgraph group_learning["Learning and assessment"]
  node_courses["Course catalogue"]
  node_modules["Modules and content"]
  node_quizzes["Quiz authoring and attempts"]
  node_quiz_review["Quiz review"]
  node_assignments["Assignments and grading"]
  node_discussions["Course discussions"]
  node_progress["Progress and completion"]
  node_certificates["Certificates"]
end

subgraph group_organisation["Organisation and commerce"]
  node_organisations["Organisations and classes"]
  node_enrollment["Enrollment"]
  node_payments["Paid enrollment<br/>[payment_service.rs]"]
end

subgraph group_platform["Platform services"]
  node_database[("PostgreSQL domain data")]
  node_mailer["Email delivery<br/>[mailer_service.rs]"]
  node_uploads["Cloudinary uploads"]
end

node_learner(("Learner / staff"))
node_stripe{{"Stripe"}}
node_cloudinary{{"Cloudinary"}}
node_google{{"Google OAuth"}}
node_smtp{{"SMTP"}}

node_learner -->|"opens pages"| node_ssr
node_ssr -->|"renders pages"| node_learner
node_learner -.->|"uses API"| node_routes
node_web_assets -.->|"requests API"| node_routes
node_routes -->|"routes requests"| node_auth
node_routes -->|"routes requests"| node_courses
node_routes -->|"routes requests"| node_organisations
node_routes -->|"routes requests"| node_enrollment
node_auth -->|"authenticates with"| node_google
node_auth -.->|"sends account email"| node_mailer
node_auth -.->|"checks access"| node_auth_helpers
node_courses -->|"reads and writes"| node_database
node_courses -.->|"manages course content"| node_modules
node_modules -.->|"reads and writes"| node_database
node_quizzes -.->|"reads and writes"| node_database
node_quiz_review -->|"loads attempt data"| node_database
node_assignments -.->|"reads and writes"| node_database
node_discussions -->|"reads and writes"| node_database
node_progress -.->|"tracks completion"| node_database
node_certificates -.->|"records certificates"| node_database
node_organisations -->|"manages org data"| node_database
node_organisations -.->|"emails invitations"| node_mailer
node_enrollment -->|"creates enrollment"| node_database
node_payments -->|"takes payment"| node_stripe
node_payments -.->|"records payment"| node_database
node_uploads -->|"stores uploads"| node_cloudinary
node_mailer -->|"delivers mail"| node_smtp

click node_ssr "https://github.com/minnnnno/lms_project/blob/main/backend/src/ssr/pages.rs"
click node_web_assets "https://github.com/minnnnno/lms_project/tree/main/frontend/static/js"
click node_routes "https://github.com/minnnnno/lms_project/tree/main/backend/src/routes"
click node_auth "https://github.com/minnnnno/lms_project/blob/main/backend/src/controller/user_controller.rs"
click node_auth_helpers "https://github.com/minnnnno/lms_project/blob/main/backend/src/services/auth_helpers.rs"
click node_courses "https://github.com/minnnnno/lms_project/blob/main/backend/src/controller/course_controller.rs"
click node_modules "https://github.com/minnnnno/lms_project/blob/main/backend/src/controller/module_content_controller.rs"
click node_quizzes "https://github.com/minnnnno/lms_project/tree/main/backend/src/services"
click node_quiz_review "https://github.com/minnnnno/lms_project/blob/main/backend/src/services/quiz_review_service.rs"
click node_assignments "https://github.com/minnnnno/lms_project/tree/main/backend/src/services"
click node_discussions "https://github.com/minnnnno/lms_project/blob/main/backend/src/services/discussion_service.rs"
click node_progress "https://github.com/minnnnno/lms_project/blob/main/backend/src/services/course_completion_service.rs"
click node_certificates "https://github.com/minnnnno/lms_project/blob/main/backend/src/services/certificate_service.rs"
click node_organisations "https://github.com/minnnnno/lms_project/blob/main/backend/src/controller/organisation_controller.rs"
click node_enrollment "https://github.com/minnnnno/lms_project/blob/main/backend/src/services/enrollment_service.rs"
click node_payments "https://github.com/minnnnno/lms_project/blob/main/backend/src/services/payment_service.rs"
click node_database "https://github.com/minnnnno/lms_project/tree/main/backend/src/entity"
click node_mailer "https://github.com/minnnnno/lms_project/blob/main/backend/src/services/mailer_service.rs"
click node_uploads "https://github.com/minnnnno/lms_project/blob/main/backend/src/services/cloudinary_service.rs"

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_ssr,node_web_assets,node_routes toneBlue
class node_auth,node_auth_helpers toneAmber
class node_courses,node_modules,node_quizzes,node_quiz_review,node_assignments,node_discussions,node_progress,node_certificates toneMint
class node_organisations,node_enrollment,node_payments toneRose
class node_database,node_mailer,node_uploads,node_learner,node_stripe,node_cloudinary,node_google,node_smtp toneIndigo
```

## Components

### Web experience

- [Server-rendered pages](https://github.com/minnnnno/lms_project/blob/main/backend/src/ssr/pages.rs): `backend/src/ssr/pages.rs`
- [Browser assets](https://github.com/minnnnno/lms_project/tree/main/frontend/static/js): `frontend/static/js`
- [API routing](https://github.com/minnnnno/lms_project/tree/main/backend/src/routes): `backend/src/routes`

### Identity and access

- [Accounts and auth](https://github.com/minnnnno/lms_project/blob/main/backend/src/controller/user_controller.rs): `backend/src/controller/user_controller.rs`
- [Access helpers](https://github.com/minnnnno/lms_project/blob/main/backend/src/services/auth_helpers.rs): `backend/src/services/auth_helpers.rs`

### Learning and assessment

- [Course catalogue](https://github.com/minnnnno/lms_project/blob/main/backend/src/controller/course_controller.rs): `backend/src/controller/course_controller.rs`
- [Modules and content](https://github.com/minnnnno/lms_project/blob/main/backend/src/controller/module_content_controller.rs): `backend/src/controller/module_content_controller.rs`
- [Quiz authoring and attempts](https://github.com/minnnnno/lms_project/tree/main/backend/src/services): `backend/src/services`
- [Quiz review](https://github.com/minnnnno/lms_project/blob/main/backend/src/services/quiz_review_service.rs): `backend/src/services/quiz_review_service.rs`
- [Assignments and grading](https://github.com/minnnnno/lms_project/tree/main/backend/src/services): `backend/src/services`
- [Course discussions](https://github.com/minnnnno/lms_project/blob/main/backend/src/services/discussion_service.rs): `backend/src/services/discussion_service.rs`
- [Progress and completion](https://github.com/minnnnno/lms_project/blob/main/backend/src/services/course_completion_service.rs): `backend/src/services/course_completion_service.rs`
- [Certificates](https://github.com/minnnnno/lms_project/blob/main/backend/src/services/certificate_service.rs): `backend/src/services/certificate_service.rs`

### Organisation and commerce

- [Organisations and classes](https://github.com/minnnnno/lms_project/blob/main/backend/src/controller/organisation_controller.rs): `backend/src/controller/organisation_controller.rs`
- [Enrollment](https://github.com/minnnnno/lms_project/blob/main/backend/src/services/enrollment_service.rs): `backend/src/services/enrollment_service.rs`
- [Paid enrollment](https://github.com/minnnnno/lms_project/blob/main/backend/src/services/payment_service.rs): `backend/src/services/payment_service.rs`

### Platform services

- [PostgreSQL domain data](https://github.com/minnnnno/lms_project/tree/main/backend/src/entity): `backend/src/entity`
- [Email delivery](https://github.com/minnnnno/lms_project/blob/main/backend/src/services/mailer_service.rs): `backend/src/services/mailer_service.rs`
- [Cloudinary uploads](https://github.com/minnnnno/lms_project/blob/main/backend/src/services/cloudinary_service.rs): `backend/src/services/cloudinary_service.rs`

### Other components

- **Learner / staff**
- **Stripe**
- **Cloudinary**
- **Google OAuth**
- **SMTP**

## Connections

- Learner / staff → Server-rendered pages: opens pages
- Server-rendered pages → Learner / staff: renders pages (evidence: `backend/src/ssr/pages.rs`)
- Learner / staff → API routing: uses API
- Browser assets → API routing: requests API
- API routing → Accounts and auth: routes requests (evidence: `backend/src/routes/user_routes.rs`)
- API routing → Course catalogue: routes requests (evidence: `backend/src/routes/course_routes.rs`)
- API routing → Organisations and classes: routes requests (evidence: `backend/src/routes/organisation_routes.rs`)
- API routing → Enrollment: routes requests (evidence: `backend/src/routes/enrollment_routes.rs`)
- Accounts and auth → Google OAuth: authenticates with (evidence: `backend/src/controller/user_controller.rs`)
- Accounts and auth → Email delivery: sends account email
- Accounts and auth → Access helpers: checks access
- Course catalogue → PostgreSQL domain data: reads and writes (evidence: `backend/src/controller/course_controller.rs`)
- Course catalogue → Modules and content: manages course content
- Modules and content → PostgreSQL domain data: reads and writes (evidence: `backend/src/controller/module_content_controller.rs`)
- Quiz authoring and attempts → PostgreSQL domain data: reads and writes (evidence: `backend/src/services/quiz_review_service.rs`)
- Quiz review → PostgreSQL domain data: loads attempt data (evidence: `backend/src/services/quiz_review_service.rs`)
- Assignments and grading → PostgreSQL domain data: reads and writes (evidence: `backend/src/services/quiz_review_service.rs`)
- Course discussions → PostgreSQL domain data: reads and writes (evidence: `backend/src/services/discussion_service.rs`)
- Progress and completion → PostgreSQL domain data: tracks completion
- Certificates → PostgreSQL domain data: records certificates
- Organisations and classes → PostgreSQL domain data: manages org data (evidence: `backend/src/controller/organisation_controller.rs`)
- Organisations and classes → Email delivery: emails invitations (evidence: `backend/src/controller/organisation_controller.rs`)
- Enrollment → PostgreSQL domain data: creates enrollment (evidence: `backend/src/services/enrollment_service.rs`)
- Paid enrollment → Stripe: takes payment
- Paid enrollment → PostgreSQL domain data: records payment
- Cloudinary uploads → Cloudinary: stores uploads
- Email delivery → SMTP: delivers mail
