How adityachy07/campus-infrastructure-complaint-tracker works
Campus Infrastructure Complaint Tracker supports student registration and complaint submission, administrator review and assignment, and maintenance handling, with role-specific dashboards and notifications. The sampled backend shows authentication, complaint persistence, admin assignment notifications, and dashboard aggregation. The tree also identifies the maintenance and notification subsystems, but their full controller and frontend wiring was not sampled, so uncertain links are omitted.
Main entry points: server.js Express API · App.jsx Route application · Complaint.js Complaint records · User.js User records
Components 24
Web client
- Route application
frontend/src/App.jsx - Login and registration
frontend/src/pages/Auth - Student portal
frontend/src/pages/Student - Admin console
frontend/src/pages/Admin - Maintenance portal
frontend/src/pages/Maintenance - Auth requests
frontend/src/services/authService.js - Admin requests
frontend/src/services/adminService.js
API runtime
- Express API
backend/src/server.js - Authentication routes
backend/src/routes/authRoutes.js - Complaint routes
backend/src/routes/complaintRoutes.js - Admin routes
backend/src/routes/adminRoutes.js - Dashboard routes
backend/src/routes/dashboardRoutes.js - Maintenance routes
backend/src/routes/maintenanceRoutes.js
Complaint workflows
- Account handling
backend/src/controllers/authController.js - Complaint handling
backend/src/controllers/complaintController.js - Review and assignment
backend/src/controllers/adminController.js - Role dashboards
backend/src/controllers/dashboardController.js - Work status handling
backend/src/controllers/maintenanceController.js - Notification handling
backend/src/controllers/notificationController.js
Domain data
- User records
backend/src/models/User.js - Complaint records
backend/src/models/Complaint.js - Notification records
backend/src/models/Notification.js
Other components
- Campus user
- MongoDB
Connections 28
- Campus user → Route application: uses
- Route application → Login and registration: routes to
- Route application → Student portal: routes to
- Route application → Admin console: routes to
- Route application → Maintenance portal: routes to
- Login and registration → Auth requests: requests
- Auth requests → Express API: posts auth
- Express API → Authentication routes: mounts
- Authentication routes → Account handling: dispatches
- Express API → Complaint routes: mounts
- Express API → Admin routes: mounts
- Express API → Dashboard routes: mounts
- Express API → Maintenance routes: mounts
- Dashboard routes → Role dashboards: dispatches
- Maintenance routes → Work status handling: dispatches
- Complaint handling → Complaint records: reads and writes
- Complaint handling → User records: finds admins
- Complaint handling → Notification records: creates alerts
- Review and assignment → Complaint records: reads and writes
- Review and assignment → User records: checks staff
- Review and assignment → Notification records: creates alerts
- Role dashboards → Complaint records: aggregates
- Role dashboards → User records: counts users
- Notification handling → Notification records: handles records
- Work status handling → Complaint records: handles assignments
- User records → MongoDB: persists
- Complaint records → MongoDB: persists
- Notification records → MongoDB: persists