How utkarshdagur/hostel-complaint-tracker works
HostelCare lets students register and submit hostel complaints, then track their status and manager comments; managers triage, assign, update, and analyze complaints. The browser’s role-based pages use a service layer that can switch between the REST API and mock mode. The API authenticates users, applies server-side complaint priority and validation, and reads and writes MongoDB records. The README also documents photo attachments, student statistics, search/filtering, and analytics. Some feature implementations were not excerpted, so edges for them rely on README documentation rather than inspected source.
Main entry points: api.js API and mock service · server.js Express server · App.jsx Role-based routes · manager Manager workflows
Components 23
Web application
- Role-based routes
frontend/src/App.jsx - Student workflows
frontend/src/pages/student - Manager workflows
frontend/src/pages/manager - Login and profile
frontend/src/pages/auth - Analytics views
frontend/src/pages/manager/Analytics.jsx - API and mock service
frontend/src/services/api.js - Session state
frontend/src/context/AuthContext.jsx - Data fetching
frontend/src/hooks/useFetch.js
REST API
- Complaint routes
backend/routes/complaintRoutes.js - Authentication routes
backend/routes/authRoutes.js - Student directory
backend/routes/studentRoutes.js - Analytics endpoints
backend/routes/analyticsRoutes.js - Express server
backend/server.js - Authentication and roles
backend/middleware/auth.js
Complaint operations
- Account operations
backend/controllers/authController.js - Complaint lifecycle
backend/controllers/complaintController.js - Priority and validation
backend/constants/complaints.js - Student statistics
backend/routes/studentRoutes.js
Persistence
- User records
backend/models/User.js - Complaint records
backend/models/Complaint.js
Other components
- Student
- Manager
- MongoDB
Connections 36
- Student → Role-based routes: uses
frontend/src/App.jsx - Manager → Role-based routes: uses
frontend/src/App.jsx - Role-based routes → Student workflows: routes
frontend/src/App.jsx - Role-based routes → Manager workflows: routes
frontend/src/App.jsx - Role-based routes → Login and profile: routes
frontend/src/App.jsx - Student workflows → API and mock service: requests data
frontend/src/pages/student/MyComplaints.jsx - Manager workflows → API and mock service: requests data
frontend/src/pages/manager/ManagerDashboard.jsx - Manager workflows → Analytics views: routes
frontend/src/App.jsx - Analytics views → API and mock service: requests analytics
README.md - Login and profile → Session state: uses session
frontend/src/context/AuthContext.jsx - Student workflows → Data fetching: loads data
frontend/src/pages/student/MyComplaints.jsx - Manager workflows → Data fetching: loads data
frontend/src/pages/manager/ManagerDashboard.jsx - Data fetching → API and mock service: calls
frontend/src/pages/manager/ManagerDashboard.jsx - API and mock service → Express server: HTTP REST
README.md - API and mock service → Student workflows: mock responses
README.md - Express server → Complaint routes: mounts
backend/server.js - Express server → Authentication routes: mounts
backend/server.js - Express server → Student directory: mounts
backend/server.js - Express server → Analytics endpoints: mounts
backend/server.js - Authentication routes → Account operations: dispatches
backend/routes/authRoutes.js - Complaint routes → Authentication and roles: protects
backend/routes/complaintRoutes.js - Complaint routes → Complaint lifecycle: dispatches
backend/routes/complaintRoutes.js - Authentication routes → Authentication and roles: protects
backend/routes/authRoutes.js - Account operations → User records: reads/writes
backend/controllers/authController.js - Authentication and roles → User records: loads account
backend/middleware/auth.js - Complaint lifecycle → Complaint records: reads/writes
backend/controllers/complaintController.js - Complaint lifecycle → Priority and validation: derives priority
backend/controllers/complaintController.js - Student directory → User records: queries students
backend/routes/studentRoutes.js - Student directory → Complaint records: aggregates counts
backend/routes/studentRoutes.js - Analytics endpoints → Complaint records: queries analytics
backend/routes/analyticsRoutes.js - Analytics endpoints → User records: queries accounts
backend/routes/analyticsRoutes.js - User records → MongoDB: persists
README.md - Complaint records → MongoDB: persists
README.md - Manager → Student statistics: views directory
README.md - Student → Student workflows: submits and tracks
README.md - Manager → Manager workflows: triages complaints
README.md