How fireproof-zarry/hostel-complaints-ticketing-system works
HostelFix is a student and administrator portal for reporting and managing hostel complaints. Users sign in with Google; the frontend verifies the credential with the backend and routes by role. Students can file and track complaints, while administrators review, filter, assign, and update them. The README documents Google-verified account rules and a Supabase-backed backend. Backend internals are represented by their source paths from the tree; their call relationships are not verified in the provided excerpts.
Main entry points: Login.jsx Sign-in screen · App.jsx Role routing · AdminHome.jsx Admin console · AdminService.java Admin operations
Components 22
Portal frontend
- Role routing
frontend/src/App.jsx - Sign-in screen
frontend/src/pages/Login.jsx - Student portal
frontend/src/pages/StudentHome.jsx - Admin console
frontend/src/pages/AdminHome.jsx - Room validation
frontend/src/utils/hostelLocation.js - Coming-soon view
frontend/src/pages/ComingSoon.jsx
Backend services
- Authentication API
backend/src/main/java/com/example/demo/hostel/controller/AuthController.java - Account authentication
backend/src/main/java/com/example/demo/hostel/service/AuthService.java - Access security
backend/src/main/java/com/example/demo/hostel/config/SecurityConfig.java - Complaint API
backend/src/main/java/com/example/demo/hostel/controller/ComplaintController.java - Student operations
backend/src/main/java/com/example/demo/hostel/service/StudentService.java - Complaint handling
backend/src/main/java/com/example/demo/hostel/service/ComplaintService.java - Status transitions
backend/src/main/java/com/example/demo/hostel/service/ComplaintTransitionService.java - Admin API
backend/src/main/java/com/example/demo/hostel/controller/AdminController.java - Admin operations
backend/src/main/java/com/example/demo/hostel/service/AdminService.java - Complaint filtering
backend/src/main/java/com/example/demo/hostel/specification/ComplaintSpecification.java
Complaint data
- Complaint records
backend/src/main/java/com/example/demo/hostel/repository/ComplaintRepository.java - User records
backend/src/main/java/com/example/demo/hostel/repository/UserRepository.java
Other components
- Student
- Administrator
- Google sign-in
- Supabase database
Connections 25
- Student → Sign-in screen: signs in
frontend/src/pages/Login.jsx - Administrator → Sign-in screen: signs in
frontend/src/pages/Login.jsx - Google sign-in → Sign-in screen: provides credential
frontend/src/pages/Login.jsx - Sign-in screen → Authentication API: verifies token
frontend/src/pages/Login.jsx - Role routing → Authentication API: checks role
frontend/src/App.jsx - Role routing → Sign-in screen: routes to
frontend/src/App.jsx - Role routing → Student portal: routes student
frontend/src/App.jsx - Role routing → Admin console: routes admin
frontend/src/App.jsx - Student portal → Room validation: validates rooms
frontend/src/pages/StudentHome.jsx - Admin console → Room validation: validates rooms
frontend/src/pages/AdminHome.jsx - Admin console → Coming-soon view: shows view
frontend/src/pages/AdminHome.jsx - Student portal → Complaint API: uses complaint API
- Admin console → Admin API: uses admin API
- Complaint API → Student operations: delegates
- Student operations → Complaint handling: handles complaints
- Admin API → Admin operations: delegates
- Admin operations → Status transitions: updates status
- Complaint handling → Complaint records: accesses records
- Admin operations → Complaint records: accesses records
- Admin operations → Complaint filtering: filters complaints
- Authentication API → Account authentication: delegates
- Account authentication → User records: accesses accounts
- Access security → Authentication API: secures endpoints
- Complaint records → Supabase database: stores data
- User records → Supabase database: stores data