How kundanamani-23/hostelcomplaintmanagement works
This repository implements a hostel complaint-management application: students submit and track issues, while wardens and administrators have dashboard, user-management, and analytics screens. The sampled flow confirms complaint submission from the frontend through its API client to the backend, where services validate and persist data. The README is empty and most frontend pages and security configuration were not sampled, so their internal request wiring is not shown.
Main entry points: App.js App Router · ComplaintServicelmpl.java Complaint Service · UserRepository.java User Repository · RegisterComplaint.jsx Register Complaint
Components 22
Frontend
- App Router
hostel-complaint-frontend/src/App.js - Register Complaint
hostel-complaint-frontend/src/pages/RegisterComplaint.jsx - Track Complaints
hostel-complaint-frontend/src/pages/TrackComplaints.jsx - Student Dashboard
hostel-complaint-frontend/src/pages/StudentDashboard.jsx - Warden Dashboard
hostel-complaint-frontend/src/pages/WardenDashboard.jsx - Admin Dashboard
hostel-complaint-frontend/src/pages/AdminDashboard.jsx - Manage Users
hostel-complaint-frontend/src/pages/ManageUsers.jsx - Analytics
hostel-complaint-frontend/src/pages/Analytics.jsx - Login Selection
hostel-complaint-frontend/src/pages/LoginSelection.jsx - Login
hostel-complaint-frontend/src/pages/Login.jsx - API Client
hostel-complaint-frontend/src/services/api.js
Backend API
- Auth Controller
hostel-complaint-backend/src/main/java/com/complaint/hostelcomplaint/controller/AuthController.java - Complaint Controller
hostel-complaint-backend/src/main/java/com/complaint/hostelcomplaint/controller/ComplaintController.java
Services
- Auth Service
hostel-complaint-backend/src/main/java/com/complaint/hostelcomplaint/service/impl/AuthServiceImpl.java - Complaint Service
hostel-complaint-backend/src/main/java/com/complaint/hostelcomplaint/service/impl/ComplaintServicelmpl.java
Persistence
- User Repository
hostel-complaint-backend/src/main/java/com/complaint/hostelcomplaint/repository/UserRepository.java - Complaint Repository
hostel-complaint-backend/src/main/java/com/complaint/hostelcomplaint/repository/ComplaintRepository.java - User Record
hostel-complaint-backend/src/main/java/com/complaint/hostelcomplaint/entity/User.java - Complaint Record
hostel-complaint-backend/src/main/java/com/complaint/hostelcomplaint/entity/Complaint.java
Other components
- Student
- Warden / Admin
- Application Database
Connections 20
- Student → App Router: uses
- Warden / Admin → App Router: uses
- App Router → Login Selection: routes
- App Router → Login: routes
- App Router → Student Dashboard: routes
- App Router → Warden Dashboard: routes
- App Router → Admin Dashboard: routes
- App Router → Register Complaint: routes
- App Router → Track Complaints: routes
- App Router → Manage Users: routes
- App Router → Analytics: routes
- Register Complaint → API Client: posts through
- API Client → Complaint Controller: HTTP request
- Auth Controller → Auth Service: calls
- Complaint Controller → Complaint Service: calls
- Auth Service → User Repository: queries / updates
- Complaint Service → User Repository: looks up
- Complaint Service → Complaint Repository: queries / updates
- User Repository → Application Database: persists
- Complaint Repository → Application Database: persists