# tushar434434/smart-campus-lms architecture

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

- Interactive diagram: https://gitdiagram.com/tushar434434/smart-campus-lms
- Repository: https://github.com/tushar434434/smart-campus-lms

## Overview

Smart Campus LMS is a role-based higher-education learning platform. A user signs in through the React application, then uses its course, enrollment, coursework, quiz, or administrative views against the Fastify API; the API enforces identity and role checks and serves domain operations backed by Prisma/PostgreSQL. The map highlights those user-facing stages and the backend route-to-service layer. The README documents several capabilities whose implementation files were not sampled, so those branches are represented at their exact module paths without speculative internal call edges.

Main entry points: [`backend/src/app.ts`](https://github.com/tushar434434/smart-campus-lms/blob/main/backend/src/app.ts) (Fastify API assembly), [`frontend/src/App.tsx`](https://github.com/tushar434434/smart-campus-lms/blob/main/frontend/src/App.tsx) (React application), [`frontend/src/pages/CoursesPage.tsx`](https://github.com/tushar434434/smart-campus-lms/blob/main/frontend/src/pages/CoursesPage.tsx) (Course views), [`backend/src/modules/quizzes`](https://github.com/tushar434434/smart-campus-lms/tree/main/backend/src/modules/quizzes) (Quiz authoring)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web application"]
  node_webapp["React application<br/>[App.tsx]"]
  node_session["Session context<br/>[AuthContext.tsx]"]
  node_api["API client<br/>[client.ts]"]
  node_courseui["Course views<br/>[CoursesPage.tsx]"]
  node_courseapi["Course API<br/>[courses.api.ts]"]
  node_enrollui["Enrollment panel"]
  node_enrollapi["Enrollment API<br/>[enrollments.api.ts]"]
  node_workui["Coursework views"]
  node_assessui["Quiz views<br/>[QuizzesPage.tsx]"]
end

subgraph group_identity["Identity and access"]
  node_authroutes["Auth routes<br/>[auth.routes.ts]"]
  node_authservice["Authentication service<br/>[auth.service.ts]"]
  node_authrepo[("Auth persistence")]
  node_access["Request access checks<br/>[authenticate.ts]"]
end

subgraph group_learning["Learning operations"]
  node_coursemodule["Course lifecycle and materials"]
  node_studentmodule["Student records<br/>[student.service.ts]"]
  node_enrollroutes["Enrollment routes"]
  node_enrollservice["Enrollment workflow"]
  node_assignmentmodule["Assignments"]
  node_submissionmodule["Submissions and grading"]
end

subgraph group_assessment["Assessment and reporting"]
  node_quizmodule["Quiz authoring"]
  node_attemptmodule["Quiz attempts"]
  node_reports["PDF reports"]
  node_admin["Administration and audit"]
end

subgraph group_platform["API and persistence"]
  node_server["Fastify API assembly<br/>[app.ts]"]
  node_postgres[("PostgreSQL")]
end

node_user(("Campus user"))

node_user -->|"uses"| node_webapp
node_webapp -->|"reads session"| node_session
node_session -->|"authenticates via"| node_api
node_webapp -->|"routes to"| node_courseui
node_courseui -.->|"loads courses"| node_courseapi
node_enrollui -->|"loads requests"| node_enrollapi
node_api -.->|"calls REST API"| node_server
node_server -->|"registers"| node_authroutes
node_server -->|"registers"| node_enrollroutes
node_server -->|"registers routes"| node_quizmodule
node_server -->|"registers routes"| node_attemptmodule
node_server -->|"registers"| node_reports
node_authroutes -->|"calls"| node_authservice
node_access -.->|"revalidates user"| node_authrepo
node_enrollroutes -->|"calls"| node_enrollservice
node_enrollservice -->|"resolves student"| node_studentmodule
node_courseui -.->|"browses catalog"| node_coursemodule
node_workui -.->|"manages work"| node_assignmentmodule
node_workui -.->|"submits work"| node_submissionmodule
node_assessui -.->|"uses quizzes"| node_quizmodule
node_assessui -.->|"takes assessments"| node_attemptmodule
node_assignmentmodule -.->|"exports grades"| node_reports
node_quizmodule -.->|"exports results"| node_reports
node_admin -.->|"approves courses"| node_coursemodule
node_server -.->|"persists data"| node_postgres

click node_webapp "https://github.com/tushar434434/smart-campus-lms/blob/main/frontend/src/App.tsx"
click node_session "https://github.com/tushar434434/smart-campus-lms/blob/main/frontend/src/contexts/AuthContext.tsx"
click node_api "https://github.com/tushar434434/smart-campus-lms/blob/main/frontend/src/api/client.ts"
click node_courseui "https://github.com/tushar434434/smart-campus-lms/blob/main/frontend/src/pages/CoursesPage.tsx"
click node_courseapi "https://github.com/tushar434434/smart-campus-lms/blob/main/frontend/src/api/courses.api.ts"
click node_enrollui "https://github.com/tushar434434/smart-campus-lms/blob/main/frontend/src/components/EnrollmentRequestsPanel.tsx"
click node_enrollapi "https://github.com/tushar434434/smart-campus-lms/blob/main/frontend/src/api/enrollments.api.ts"
click node_workui "https://github.com/tushar434434/smart-campus-lms/blob/main/frontend/src/pages/AssignmentsPage.tsx"
click node_assessui "https://github.com/tushar434434/smart-campus-lms/blob/main/frontend/src/pages/QuizzesPage.tsx"
click node_authroutes "https://github.com/tushar434434/smart-campus-lms/blob/main/backend/src/modules/auth/auth.routes.ts"
click node_authservice "https://github.com/tushar434434/smart-campus-lms/blob/main/backend/src/modules/auth/auth.service.ts"
click node_authrepo "https://github.com/tushar434434/smart-campus-lms/blob/main/backend/src/modules/auth/auth.prisma.repository.ts"
click node_access "https://github.com/tushar434434/smart-campus-lms/blob/main/backend/src/middleware/authenticate.ts"
click node_coursemodule "https://github.com/tushar434434/smart-campus-lms/tree/main/backend/src/modules/courses"
click node_studentmodule "https://github.com/tushar434434/smart-campus-lms/blob/main/backend/src/modules/students/student.service.ts"
click node_enrollroutes "https://github.com/tushar434434/smart-campus-lms/blob/main/backend/src/modules/enrollments/enrollment.routes.ts"
click node_enrollservice "https://github.com/tushar434434/smart-campus-lms/blob/main/backend/src/modules/enrollments/enrollment.service.ts"
click node_assignmentmodule "https://github.com/tushar434434/smart-campus-lms/tree/main/backend/src/modules/assignments"
click node_submissionmodule "https://github.com/tushar434434/smart-campus-lms/tree/main/backend/src/modules/submissions"
click node_quizmodule "https://github.com/tushar434434/smart-campus-lms/tree/main/backend/src/modules/quizzes"
click node_attemptmodule "https://github.com/tushar434434/smart-campus-lms/tree/main/backend/src/modules/quiz-attempts"
click node_reports "https://github.com/tushar434434/smart-campus-lms/tree/main/backend/src/modules/reports"
click node_admin "https://github.com/tushar434434/smart-campus-lms/tree/main/backend/src/modules/admin"
click node_server "https://github.com/tushar434434/smart-campus-lms/blob/main/backend/src/app.ts"

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_session,node_api,node_courseui,node_courseapi,node_enrollui,node_enrollapi,node_workui,node_assessui,node_user toneBlue
class node_authroutes,node_authservice,node_authrepo,node_access toneAmber
class node_coursemodule,node_studentmodule,node_enrollroutes,node_enrollservice,node_assignmentmodule,node_submissionmodule toneMint
class node_quizmodule,node_attemptmodule,node_reports,node_admin toneRose
class node_server,node_postgres toneIndigo
```

## Components

### Web application

- [React application](https://github.com/tushar434434/smart-campus-lms/blob/main/frontend/src/App.tsx): `frontend/src/App.tsx`
- [Session context](https://github.com/tushar434434/smart-campus-lms/blob/main/frontend/src/contexts/AuthContext.tsx): `frontend/src/contexts/AuthContext.tsx`
- [API client](https://github.com/tushar434434/smart-campus-lms/blob/main/frontend/src/api/client.ts): `frontend/src/api/client.ts`
- [Course views](https://github.com/tushar434434/smart-campus-lms/blob/main/frontend/src/pages/CoursesPage.tsx): `frontend/src/pages/CoursesPage.tsx`
- [Course API](https://github.com/tushar434434/smart-campus-lms/blob/main/frontend/src/api/courses.api.ts): `frontend/src/api/courses.api.ts`
- [Enrollment panel](https://github.com/tushar434434/smart-campus-lms/blob/main/frontend/src/components/EnrollmentRequestsPanel.tsx): `frontend/src/components/EnrollmentRequestsPanel.tsx`
- [Enrollment API](https://github.com/tushar434434/smart-campus-lms/blob/main/frontend/src/api/enrollments.api.ts): `frontend/src/api/enrollments.api.ts`
- [Coursework views](https://github.com/tushar434434/smart-campus-lms/blob/main/frontend/src/pages/AssignmentsPage.tsx): `frontend/src/pages/AssignmentsPage.tsx`
- [Quiz views](https://github.com/tushar434434/smart-campus-lms/blob/main/frontend/src/pages/QuizzesPage.tsx): `frontend/src/pages/QuizzesPage.tsx`

### Identity and access

- [Auth routes](https://github.com/tushar434434/smart-campus-lms/blob/main/backend/src/modules/auth/auth.routes.ts): `backend/src/modules/auth/auth.routes.ts`
- [Authentication service](https://github.com/tushar434434/smart-campus-lms/blob/main/backend/src/modules/auth/auth.service.ts): `backend/src/modules/auth/auth.service.ts`
- [Auth persistence](https://github.com/tushar434434/smart-campus-lms/blob/main/backend/src/modules/auth/auth.prisma.repository.ts): `backend/src/modules/auth/auth.prisma.repository.ts`
- [Request access checks](https://github.com/tushar434434/smart-campus-lms/blob/main/backend/src/middleware/authenticate.ts): `backend/src/middleware/authenticate.ts`

### Learning operations

- [Course lifecycle and materials](https://github.com/tushar434434/smart-campus-lms/tree/main/backend/src/modules/courses): `backend/src/modules/courses`
- [Student records](https://github.com/tushar434434/smart-campus-lms/blob/main/backend/src/modules/students/student.service.ts): `backend/src/modules/students/student.service.ts`
- [Enrollment routes](https://github.com/tushar434434/smart-campus-lms/blob/main/backend/src/modules/enrollments/enrollment.routes.ts): `backend/src/modules/enrollments/enrollment.routes.ts`
- [Enrollment workflow](https://github.com/tushar434434/smart-campus-lms/blob/main/backend/src/modules/enrollments/enrollment.service.ts): `backend/src/modules/enrollments/enrollment.service.ts`
- [Assignments](https://github.com/tushar434434/smart-campus-lms/tree/main/backend/src/modules/assignments): `backend/src/modules/assignments`
- [Submissions and grading](https://github.com/tushar434434/smart-campus-lms/tree/main/backend/src/modules/submissions): `backend/src/modules/submissions`

### Assessment and reporting

- [Quiz authoring](https://github.com/tushar434434/smart-campus-lms/tree/main/backend/src/modules/quizzes): `backend/src/modules/quizzes`
- [Quiz attempts](https://github.com/tushar434434/smart-campus-lms/tree/main/backend/src/modules/quiz-attempts): `backend/src/modules/quiz-attempts`
- [PDF reports](https://github.com/tushar434434/smart-campus-lms/tree/main/backend/src/modules/reports): `backend/src/modules/reports`
- [Administration and audit](https://github.com/tushar434434/smart-campus-lms/tree/main/backend/src/modules/admin): `backend/src/modules/admin`

### API and persistence

- [Fastify API assembly](https://github.com/tushar434434/smart-campus-lms/blob/main/backend/src/app.ts): `backend/src/app.ts`
- **PostgreSQL**

### Other components

- **Campus user**

## Connections

- Campus user → React application: uses (evidence: `README.md`)
- React application → Session context: reads session (evidence: `frontend/src/App.tsx`)
- Session context → API client: authenticates via (evidence: `frontend/src/contexts/AuthContext.tsx`)
- React application → Course views: routes to (evidence: `frontend/src/App.tsx`)
- Course views → Course API: loads courses
- Enrollment panel → Enrollment API: loads requests (evidence: `frontend/src/components/EnrollmentRequestsPanel.tsx`)
- API client → Fastify API assembly: calls REST API
- Fastify API assembly → Auth routes: registers
- Fastify API assembly → Enrollment routes: registers
- Fastify API assembly → Quiz authoring: registers routes
- Fastify API assembly → Quiz attempts: registers routes
- Fastify API assembly → PDF reports: registers
- Auth routes → Authentication service: calls
- Request access checks → Auth persistence: revalidates user
- Enrollment routes → Enrollment workflow: calls (evidence: `backend/src/modules/enrollments/enrollment.routes.ts`)
- Enrollment workflow → Student records: resolves student (evidence: `backend/src/modules/enrollments/enrollment.service.ts`)
- Course views → Course lifecycle and materials: browses catalog
- Coursework views → Assignments: manages work
- Coursework views → Submissions and grading: submits work
- Quiz views → Quiz authoring: uses quizzes
- Quiz views → Quiz attempts: takes assessments
- Assignments → PDF reports: exports grades (evidence: `README.md`)
- Quiz authoring → PDF reports: exports results (evidence: `README.md`)
- Administration and audit → Course lifecycle and materials: approves courses (evidence: `README.md`)
- Fastify API assembly → PostgreSQL: persists data
