# lianhahaha/school-management-system architecture

> Architecture diagram of the GitHub repository lianhahaha/school-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/lianhahaha/school-management-system
- Repository: https://github.com/lianhahaha/school-management-system

## Overview

Skole is a role-based school management system: users sign in or register, then use role-specific screens to manage school operations or view their own records. The frontend routes those screens to a REST API; the API applies authentication and role checks before handling domain requests, with MySQL as the system of record and Firebase Authentication for identity. The graph preserves the major documented domains and dashboards. Several domain implementations are represented by their exact feature/module directories because their source was not sampled; their internal call chains are therefore not asserted.

Main entry points: [`backend/src/routes.js`](https://github.com/lianhahaha/school-management-system/blob/main/backend/src/routes.js) (API routes), [`frontend/src/app/router.jsx`](https://github.com/lianhahaha/school-management-system/blob/main/frontend/src/app/router.jsx) (Role routes), [`backend/src/middleware/authenticate.js`](https://github.com/lianhahaha/school-management-system/blob/main/backend/src/middleware/authenticate.js) (Token verification), [`frontend/src/app/App.jsx`](https://github.com/lianhahaha/school-management-system/blob/main/frontend/src/app/App.jsx) (Web app)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Web application"]
  node_web_app["Web app<br/>[App.jsx]"]
  node_role_routes["Role routes<br/>[router.jsx]"]
  node_auth_ui["Sign-in screens"]
  node_dash_ui["Role dashboards"]
  node_school_ui["School feature screens"]
  node_api_client["API client<br/>[apiClient.js]"]
end

subgraph group_api["REST API"]
  node_api_entry["API routes<br/>[routes.js]"]
  node_auth_routes["Auth routes<br/>[auth.routes.js]"]
  node_authn["Token verification<br/>[authenticate.js]"]
  node_role_gate["Role authorization<br/>[authorize.js]"]
  node_request_validation["Request validation<br/>[validate.js]"]
end

subgraph group_school["School operations"]
  node_enrollment["Enrollment"]
  node_people["Users and profiles"]
  node_classes_subjects["Classes and subjects"]
  node_teacher_assignment["Teacher assignment"]
  node_attendance["Attendance"]
  node_grades["Assessments and grades"]
  node_schedules["Timetables"]
  node_announcements["Announcements"]
  node_dashboard["Dashboard data"]
end

subgraph group_platform["Identity and state"]
  node_mysql[("MySQL")]
  node_firebase["Firebase Auth"]
end

node_school_user(("School user"))

node_school_user -->|"uses"| node_web_app
node_web_app -->|"routes"| node_role_routes
node_role_routes -->|"loads"| node_auth_ui
node_role_routes -->|"loads"| node_dash_ui
node_role_routes -->|"loads"| node_school_ui
node_school_ui -.->|"requests"| node_api_client
node_api_client -.->|"calls REST API"| node_api_entry
node_api_entry -->|"mounts"| node_auth_routes
node_api_entry -->|"protects resources"| node_authn
node_auth_routes -->|"requires token"| node_authn
node_authn -->|"verifies identity"| node_firebase
node_api_entry -->|"mounts resource"| node_enrollment
node_enrollment -->|"uses database"| node_mysql
node_api_entry -->|"mounts resource"| node_people
node_api_entry -->|"mounts resource"| node_classes_subjects
node_api_entry -->|"mounts resource"| node_teacher_assignment
node_api_entry -->|"mounts resource"| node_attendance
node_api_entry -->|"mounts resource"| node_grades
node_api_entry -->|"mounts resource"| node_schedules
node_api_entry -->|"mounts resource"| node_announcements
node_api_entry -->|"mounts resource"| node_dashboard
node_authn -->|"looks up account"| node_people
node_role_routes -->|"guards by role"| node_school_user
node_api_entry -->|"stores school data"| node_mysql
node_auth_ui -->|"authenticates"| node_firebase

click node_web_app "https://github.com/lianhahaha/school-management-system/blob/main/frontend/src/app/App.jsx"
click node_role_routes "https://github.com/lianhahaha/school-management-system/blob/main/frontend/src/app/router.jsx"
click node_auth_ui "https://github.com/lianhahaha/school-management-system/tree/main/frontend/src/features/auth"
click node_dash_ui "https://github.com/lianhahaha/school-management-system/tree/main/frontend/src/features/dashboard"
click node_school_ui "https://github.com/lianhahaha/school-management-system/tree/main/frontend/src/features"
click node_api_client "https://github.com/lianhahaha/school-management-system/blob/main/frontend/src/lib/apiClient.js"
click node_api_entry "https://github.com/lianhahaha/school-management-system/blob/main/backend/src/routes.js"
click node_auth_routes "https://github.com/lianhahaha/school-management-system/blob/main/backend/src/modules/auth/auth.routes.js"
click node_authn "https://github.com/lianhahaha/school-management-system/blob/main/backend/src/middleware/authenticate.js"
click node_role_gate "https://github.com/lianhahaha/school-management-system/blob/main/backend/src/middleware/authorize.js"
click node_request_validation "https://github.com/lianhahaha/school-management-system/blob/main/backend/src/middleware/validate.js"
click node_enrollment "https://github.com/lianhahaha/school-management-system/blob/main/backend/src/modules/enrollments/enrollments.service.js"
click node_people "https://github.com/lianhahaha/school-management-system/tree/main/backend/src/modules/users"
click node_classes_subjects "https://github.com/lianhahaha/school-management-system/tree/main/backend/src/modules/classes"
click node_teacher_assignment "https://github.com/lianhahaha/school-management-system/tree/main/backend/src/modules/classSubjects"
click node_attendance "https://github.com/lianhahaha/school-management-system/tree/main/backend/src/modules/attendance"
click node_grades "https://github.com/lianhahaha/school-management-system/tree/main/backend/src/modules/grades"
click node_schedules "https://github.com/lianhahaha/school-management-system/tree/main/backend/src/modules/schedules"
click node_announcements "https://github.com/lianhahaha/school-management-system/tree/main/backend/src/modules/announcements"
click node_dashboard "https://github.com/lianhahaha/school-management-system/tree/main/backend/src/modules/dashboard"

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_web_app,node_role_routes,node_auth_ui,node_dash_ui,node_school_ui,node_api_client,node_school_user toneBlue
class node_api_entry,node_auth_routes,node_authn,node_role_gate,node_request_validation toneAmber
class node_enrollment,node_people,node_classes_subjects,node_teacher_assignment,node_attendance,node_grades,node_schedules,node_announcements,node_dashboard toneMint
class node_mysql,node_firebase toneRose
```

## Components

### Web application

- [Web app](https://github.com/lianhahaha/school-management-system/blob/main/frontend/src/app/App.jsx): `frontend/src/app/App.jsx`
- [Role routes](https://github.com/lianhahaha/school-management-system/blob/main/frontend/src/app/router.jsx): `frontend/src/app/router.jsx`
- [Sign-in screens](https://github.com/lianhahaha/school-management-system/tree/main/frontend/src/features/auth): `frontend/src/features/auth`
- [Role dashboards](https://github.com/lianhahaha/school-management-system/tree/main/frontend/src/features/dashboard): `frontend/src/features/dashboard`
- [School feature screens](https://github.com/lianhahaha/school-management-system/tree/main/frontend/src/features): `frontend/src/features`
- [API client](https://github.com/lianhahaha/school-management-system/blob/main/frontend/src/lib/apiClient.js): `frontend/src/lib/apiClient.js`

### REST API

- [API routes](https://github.com/lianhahaha/school-management-system/blob/main/backend/src/routes.js): `backend/src/routes.js`
- [Auth routes](https://github.com/lianhahaha/school-management-system/blob/main/backend/src/modules/auth/auth.routes.js): `backend/src/modules/auth/auth.routes.js`
- [Token verification](https://github.com/lianhahaha/school-management-system/blob/main/backend/src/middleware/authenticate.js): `backend/src/middleware/authenticate.js`
- [Role authorization](https://github.com/lianhahaha/school-management-system/blob/main/backend/src/middleware/authorize.js): `backend/src/middleware/authorize.js`
- [Request validation](https://github.com/lianhahaha/school-management-system/blob/main/backend/src/middleware/validate.js): `backend/src/middleware/validate.js`

### School operations

- [Enrollment](https://github.com/lianhahaha/school-management-system/blob/main/backend/src/modules/enrollments/enrollments.service.js): `backend/src/modules/enrollments/enrollments.service.js`
- [Users and profiles](https://github.com/lianhahaha/school-management-system/tree/main/backend/src/modules/users): `backend/src/modules/users`
- [Classes and subjects](https://github.com/lianhahaha/school-management-system/tree/main/backend/src/modules/classes): `backend/src/modules/classes`
- [Teacher assignment](https://github.com/lianhahaha/school-management-system/tree/main/backend/src/modules/classSubjects): `backend/src/modules/classSubjects`
- [Attendance](https://github.com/lianhahaha/school-management-system/tree/main/backend/src/modules/attendance): `backend/src/modules/attendance`
- [Assessments and grades](https://github.com/lianhahaha/school-management-system/tree/main/backend/src/modules/grades): `backend/src/modules/grades`
- [Timetables](https://github.com/lianhahaha/school-management-system/tree/main/backend/src/modules/schedules): `backend/src/modules/schedules`
- [Announcements](https://github.com/lianhahaha/school-management-system/tree/main/backend/src/modules/announcements): `backend/src/modules/announcements`
- [Dashboard data](https://github.com/lianhahaha/school-management-system/tree/main/backend/src/modules/dashboard): `backend/src/modules/dashboard`

### Identity and state

- **MySQL**
- **Firebase Auth**

### Other components

- **School user**

## Connections

- School user → Web app: uses
- Web app → Role routes: routes (evidence: `frontend/src/app/App.jsx`)
- Role routes → Sign-in screens: loads (evidence: `frontend/src/app/router.jsx`)
- Role routes → Role dashboards: loads (evidence: `frontend/src/app/router.jsx`)
- Role routes → School feature screens: loads (evidence: `frontend/src/app/router.jsx`)
- School feature screens → API client: requests
- API client → API routes: calls REST API
- API routes → Auth routes: mounts (evidence: `backend/src/routes.js`)
- API routes → Token verification: protects resources (evidence: `backend/src/routes.js`)
- Auth routes → Token verification: requires token (evidence: `backend/src/modules/auth/auth.routes.js`)
- Token verification → Firebase Auth: verifies identity
- API routes → Enrollment: mounts resource (evidence: `backend/src/routes.js`)
- Enrollment → MySQL: uses database (evidence: `backend/src/modules/enrollments/enrollments.service.js`)
- API routes → Users and profiles: mounts resource (evidence: `backend/src/routes.js`)
- API routes → Classes and subjects: mounts resource (evidence: `backend/src/routes.js`)
- API routes → Teacher assignment: mounts resource (evidence: `backend/src/routes.js`)
- API routes → Attendance: mounts resource (evidence: `backend/src/routes.js`)
- API routes → Assessments and grades: mounts resource (evidence: `backend/src/routes.js`)
- API routes → Timetables: mounts resource (evidence: `backend/src/routes.js`)
- API routes → Announcements: mounts resource (evidence: `backend/src/routes.js`)
- API routes → Dashboard data: mounts resource (evidence: `backend/src/routes.js`)
- Token verification → Users and profiles: looks up account (evidence: `backend/src/middleware/authenticate.js`)
- Role routes → School user: guards by role (evidence: `frontend/src/app/router.jsx`)
- API routes → MySQL: stores school data
- Sign-in screens → Firebase Auth: authenticates
