How ishansirf-ai/smart-campus-complaint-portal works
This is a Smart College Portal for campus issue reporting and resolution. Students authenticate, submit and track complaints with evidence; department staff accept, assign and update work; administrators oversee complaints, users, categories and reports. Notices, notifications, audit history, email-based password resets, and overdue escalation support that workflow. The excerpts establish route ownership and several internal calls; the README is empty and frontend behavior was not sampled, so frontend/API wiring is shown as unverified rather than asserted.
Main entry points: server.js HTTP API · complaintRoutes.js Complaint reporting and tracking · departmentRoutes.js Department work queue · adminRoutes.js Admin operations and reports
Components 22
Portal entry
- Portal interface
assets/js/app.js - Portal pages
index.html - HTTP API
server.js
Identity and access
- Authentication
server/routes/authRoutes.js - User accounts
server/models/User.js - Session authorization
server/middleware/auth.js - Password reset email
server/services/emailService.js
Complaint operations
- Complaint reporting and tracking
server/routes/complaintRoutes.js - Complaint records
server/models/Complaint.js - Department work queue
server/routes/departmentRoutes.js - Overdue escalation
server/jobs/overdueJob.js
Administration
- Admin operations and reports
server/routes/adminRoutes.js - Portal categories and rules
server/config/portal.js - Campus notices
server/routes/noticeRoutes.js
Platform services
- Notifications
server/utils/notifications.js - Notification inbox
server/routes/notificationRoutes.js - Audit history
server/utils/audit.js - Secure attachments
server/utils/secureUploads.js - MongoDB connection
server/config/db.js
Other components
- Student
- Department staff
- Administrator
Connections 40
- Student → Portal interface: uses
- Department staff → Portal interface: uses
- Administrator → Portal interface: uses
- Portal pages → Portal interface: hosts interface
- Portal interface → HTTP API: calls API
- HTTP API → Authentication: mounts routes
server.js - HTTP API → Complaint reporting and tracking: mounts routes
server.js - HTTP API → Department work queue: mounts routes
server.js - HTTP API → Admin operations and reports: mounts routes
server.js - HTTP API → Campus notices: mounts routes
server.js - HTTP API → Notification inbox: mounts routes
server.js - HTTP API → MongoDB connection: connects database
server.js - Authentication → User accounts: reads and updates
server/routes/authRoutes.js - Authentication → Session authorization: uses protection
server/routes/authRoutes.js - Authentication → Password reset email: sends reset email
server/routes/authRoutes.js - Session authorization → User accounts: loads session user
server/middleware/auth.js - Complaint reporting and tracking → Complaint records: creates and queries
server/routes/complaintRoutes.js - Complaint reporting and tracking → Session authorization: protects routes
server/routes/complaintRoutes.js - Complaint reporting and tracking → Notifications: creates alerts
server/routes/complaintRoutes.js - Complaint reporting and tracking → Audit history: records actions
server/routes/complaintRoutes.js - Complaint reporting and tracking → Secure attachments: serves attachments
server/routes/complaintRoutes.js - Department work queue → Complaint records: updates assigned work
server/routes/departmentRoutes.js - Department work queue → User accounts: queries staff
server/routes/departmentRoutes.js - Department work queue → Notifications: creates alerts
server/routes/departmentRoutes.js - Department work queue → Audit history: records actions
server/routes/departmentRoutes.js - Department work queue → Secure attachments: serves attachments
server/routes/departmentRoutes.js - Admin operations and reports → Complaint records: manages complaints
server/routes/adminRoutes.js - Admin operations and reports → User accounts: manages accounts
server/routes/adminRoutes.js - Admin operations and reports → Notifications: creates alerts
server/routes/adminRoutes.js - Admin operations and reports → Audit history: records actions
server/routes/adminRoutes.js - Admin operations and reports → Secure attachments: handles attachments
server/routes/adminRoutes.js - Overdue escalation → Complaint records: checks due complaints
server/jobs/overdueJob.js - Overdue escalation → Notifications: sends escalation alerts
server/jobs/overdueJob.js - Campus notices → Session authorization: protects routes
server/routes/noticeRoutes.js - Notification inbox → Session authorization: protects routes
server/routes/notificationRoutes.js - Notifications → User accounts: finds recipients
server/utils/notifications.js - Notifications → Notification inbox: persists inbox items
server/utils/notifications.js - Audit history → MongoDB connection: persists audit entries
- HTTP API → Overdue escalation: starts job
server.js - HTTP API → Portal categories and rules: bootstraps portal data