How lianhahaha/school-management-system works
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: routes.js API routes · router.jsx Role routes · authenticate.js Token verification · App.jsx Web app
Components 23
Web application
- Web app
frontend/src/app/App.jsx - Role routes
frontend/src/app/router.jsx - Sign-in screens
frontend/src/features/auth - Role dashboards
frontend/src/features/dashboard - School feature screens
frontend/src/features - API client
frontend/src/lib/apiClient.js
REST API
- API routes
backend/src/routes.js - Auth routes
backend/src/modules/auth/auth.routes.js - Token verification
backend/src/middleware/authenticate.js - Role authorization
backend/src/middleware/authorize.js - Request validation
backend/src/middleware/validate.js
School operations
- Enrollment
backend/src/modules/enrollments/enrollments.service.js - Users and profiles
backend/src/modules/users - Classes and subjects
backend/src/modules/classes - Teacher assignment
backend/src/modules/classSubjects - Attendance
backend/src/modules/attendance - Assessments and grades
backend/src/modules/grades - Timetables
backend/src/modules/schedules - Announcements
backend/src/modules/announcements - Dashboard data
backend/src/modules/dashboard
Identity and state
- MySQL
- Firebase Auth
Other components
- School user
Connections 25
- School user → Web app: uses
- Web app → Role routes: routes
frontend/src/app/App.jsx - Role routes → Sign-in screens: loads
frontend/src/app/router.jsx - Role routes → Role dashboards: loads
frontend/src/app/router.jsx - Role routes → School feature screens: loads
frontend/src/app/router.jsx - School feature screens → API client: requests
- API client → API routes: calls REST API
- API routes → Auth routes: mounts
backend/src/routes.js - API routes → Token verification: protects resources
backend/src/routes.js - Auth routes → Token verification: requires token
backend/src/modules/auth/auth.routes.js - Token verification → Firebase Auth: verifies identity
- API routes → Enrollment: mounts resource
backend/src/routes.js - Enrollment → MySQL: uses database
backend/src/modules/enrollments/enrollments.service.js - API routes → Users and profiles: mounts resource
backend/src/routes.js - API routes → Classes and subjects: mounts resource
backend/src/routes.js - API routes → Teacher assignment: mounts resource
backend/src/routes.js - API routes → Attendance: mounts resource
backend/src/routes.js - API routes → Assessments and grades: mounts resource
backend/src/routes.js - API routes → Timetables: mounts resource
backend/src/routes.js - API routes → Announcements: mounts resource
backend/src/routes.js - API routes → Dashboard data: mounts resource
backend/src/routes.js - Token verification → Users and profiles: looks up account
backend/src/middleware/authenticate.js - Role routes → School user: guards by role
frontend/src/app/router.jsx - API routes → MySQL: stores school data
- Sign-in screens → Firebase Auth: authenticates