How sanskruti0616/hostelfix works
HostelFix is a hostel maintenance complaint-management application. Students sign in, submit complaints, and review their complaint history and details; wardens oversee complaints and assign staff; staff view assigned work and update status; administrators monitor complaints. The React app coordinates role-based views and calls the Express API, which uses MySQL for complaint operations. Source excerpts show the UI/API and server/database boundary, but do not establish every endpoint or frontend-to-backend interaction; unverified links are omitted.
Main entry points: App.tsx App coordinator · index.ts Complaint types · StudentDashboard.tsx Student dashboard · Login.tsx Login
Components 18
Role-based interface
- App coordinator
src/App.tsx - Login
src/pages/Login.tsx - Student dashboard
src/pages/StudentDashboard.tsx - Warden dashboard
src/pages/WardenDashboard.tsx - Staff dashboard
src/pages/StaffDashboard.tsx - Admin dashboard
src/pages/AdminDashboard.tsx
Complaint workflow
- Raise complaint
src/pages/RaiseComplaint.tsx - Complaint history
src/pages/ComplaintHistory.tsx - Complaint details
src/pages/ComplaintDetails.tsx
Backend service
- Complaint API
HostelFix-backend/server.js
Shared data
- MySQL pool
HostelFix-backend/db.js - User records
src/data/users.ts - Complaint types
src/types/index.ts - Complaint data module
src/data/complaints.ts
Other components
- Student
- Warden
- Maintenance staff
- Administrator
Connections 24
- Student → App coordinator: uses
- Warden → App coordinator: uses
- Maintenance staff → App coordinator: uses
- Administrator → App coordinator: uses
- App coordinator → Login: renders
src/App.tsx - App coordinator → Student dashboard: renders
src/App.tsx - App coordinator → Warden dashboard: renders
src/App.tsx - App coordinator → Staff dashboard: renders
src/App.tsx - App coordinator → Admin dashboard: renders
src/App.tsx - App coordinator → Raise complaint: renders
src/App.tsx - App coordinator → Complaint history: renders
src/App.tsx - App coordinator → Complaint details: renders
src/App.tsx - Login → User records: reads
src/pages/Login.tsx - Student dashboard → User records: reads
src/pages/StudentDashboard.tsx - App coordinator → Complaint API: fetches complaints
src/App.tsx - Complaint API → MySQL pool: queries
HostelFix-backend/server.js - App coordinator → Complaint types: uses types
src/App.tsx - Raise complaint → Complaint types: uses types
src/pages/RaiseComplaint.tsx - Complaint history → Complaint types: uses types
src/pages/ComplaintHistory.tsx - Complaint details → Complaint types: uses types
src/pages/ComplaintDetails.tsx - Student dashboard → Complaint types: uses types
src/pages/StudentDashboard.tsx - Warden dashboard → Complaint types: uses types
src/pages/WardenDashboard.tsx - Staff dashboard → Complaint types: uses types
src/pages/StaffDashboard.tsx - Admin dashboard → Complaint types: uses types
src/pages/AdminDashboard.tsx