How thakuramulyasingh16-gif/college-erp-management-system works
College ERP is a full-stack system with Admin, Teacher, and Student portals. Users authenticate, then enter a role-specific dashboard; dashboard features make authenticated REST requests to the backend, whose routes enforce access and dispatch ERP operations backed by MySQL. The sampled ERP controller covers multiple academic and administrative domains, while route excerpts confirm notices, departments, courses, people, and fees. Other dashboard capabilities are grouped because their implementation details were not sampled; the README gives only a high-level product description.
Main entry points: server.js Express API server · authRoutes.js Auth routes · App.jsx Application router · Dashboard.jsx Role dashboard
Components 20
Web portals
- Application router
frontend/src/App.jsx - Login page
frontend/src/pages/Login.jsx - Role dashboard
frontend/src/pages/Dashboard.jsx - Admin portal
frontend/src/components/AdminDashboard.jsx - Teacher portal
frontend/src/components/TeacherDashboard.jsx - Student portal
frontend/src/components/StudentDashboard.jsx
Identity and access
- Client auth state
frontend/src/context/AuthContext.jsx - Auth routes
backend/routes/authRoutes.js - Auth operations
backend/controllers/authController.js - JWT and role guard
backend/middleware/auth.js - SMS service
backend/services/smsService.js - Protected media
backend/middleware/uploadAuth.js
ERP services
- ERP routes
backend/routes/erpRoutes.js - ERP operations
backend/controllers/erpController.js - Upload handling
backend/middleware/upload.js
API and data
- Authenticated fetch
frontend/src/utils/api.js - API client
frontend/src/api/index.js - Express API server
backend/server.js - MySQL database
backend/config/db.js
Other components
- College user
Connections 31
- College user → Application router: opens portal
frontend/src/App.jsx - Application router → Client auth state: provides auth
frontend/src/App.jsx - Application router → Login page: routes login
frontend/src/App.jsx - Application router → Role dashboard: routes dashboard
frontend/src/App.jsx - Login page → Client auth state: uses auth
frontend/src/pages/Login.jsx - Client auth state → Auth routes: verifies session
frontend/src/context/AuthContext.jsx - Client auth state → Auth routes: requests logout
frontend/src/context/AuthContext.jsx - Role dashboard → Admin portal: renders by role
frontend/src/pages/Dashboard.jsx - Role dashboard → Teacher portal: renders by role
frontend/src/pages/Dashboard.jsx - Role dashboard → Student portal: renders by role
frontend/src/pages/Dashboard.jsx - Admin portal → Authenticated fetch: requests data
frontend/src/components/AdminDashboard.jsx - Teacher portal → Authenticated fetch: requests data
frontend/src/components/TeacherDashboard.jsx - Student portal → Authenticated fetch: requests data
frontend/src/components/StudentDashboard.jsx - Admin portal → API client: requests data
frontend/src/components/AdminDashboard.jsx - Teacher portal → API client: requests data
frontend/src/components/TeacherDashboard.jsx - Student portal → API client: requests data
frontend/src/components/StudentDashboard.jsx - Authenticated fetch → Express API server: calls REST API
frontend/src/utils/api.js - API client → Express API server: calls REST API
frontend/src/api/index.js - Express API server → Auth routes: mounts routes
backend/server.js - Express API server → ERP routes: mounts routes
backend/server.js - Auth routes → JWT and role guard: guards routes
backend/routes/authRoutes.js - Auth routes → Auth operations: dispatches auth
backend/routes/authRoutes.js - Auth operations → JWT and role guard: blacklists token
backend/controllers/authController.js - Auth operations → SMS service: sends OTP
backend/controllers/authController.js - Auth operations → MySQL database: reads and writes
backend/controllers/authController.js - JWT and role guard → MySQL database: checks session
backend/middleware/auth.js - ERP routes → JWT and role guard: guards routes
backend/routes/erpRoutes.js - ERP routes → ERP operations: dispatches ERP
backend/routes/erpRoutes.js - ERP operations → MySQL database: reads and writes
backend/controllers/erpController.js - ERP routes → Upload handling: handles uploads
backend/routes/erpRoutes.js - Express API server → Protected media: protects media
backend/server.js