How heyshiivam556/mess-management-system works
This is a role-based mess-management web app. Users sign in and enter student, worker, committee, or super-admin panels; students view routines and request opt-outs, while workers validate meal-entry QR codes and committee staff manage menus and operations. Firebase provides authentication and persistent, live-updating records. The tree and excerpts support the main role and opt-out paths; several page capabilities are represented by their filenames, but their internal wiring was not sampled.
Main entry points: firestoreService.js Firestore services · AuthContext.jsx Auth context · App.jsx App routing · firebase.js Firebase setup
Components 25
Access and navigation
- App routing
src/App.jsx - Login
src/pages/auth/Login.jsx - Auth context
src/context/AuthContext.jsx - Role guards
src/components/ProtectedRoute.jsx - Firestore services
src/lib/firestoreService.js - Firebase setup
src/lib/firebase.js
Student services
- Routine and profile
src/pages/student/Routine.jsx - Opt-out requests
src/pages/student/OptOut.jsx - Meal token
src/components/TokenOverlay.jsx - Wallet history
src/pages/student/WalletHistory.jsx - Student feedback
src/pages/student/Feedback.jsx
Meal operations
- Entry terminal
src/pages/worker/Terminal.jsx - Committee console
src/pages/committee/Dashboard.jsx - Menu manager
src/pages/committee/MenuManager.jsx - Ledger
src/pages/committee/Ledger.jsx - Student management
src/pages/committee/Students.jsx - Announcements
src/pages/committee/Announcements.jsx - Feedback review
Administration
- Super-admin console
src/pages/superadmin/Dashboard.jsx - Committee assignment
src/pages/superadmin/Committee.jsx - Worker assignment
src/pages/superadmin/Workers.jsx - Succession
src/pages/superadmin/Succession.jsx
Other components
- User
- Firebase Auth
- Firestore
Connections 28
- User → App routing: opens
- App routing → Auth context: reads auth state
- App routing → Role guards: guards routes
- App routing → Login: routes to
- Login → Auth context: signs in
- Auth context → Firebase Auth: authenticates
- Auth context → Firestore services: loads profile
- Auth context → Firestore: updates session
- Opt-out requests → Firestore services: submits request
- Meal token → Firestore services: listens for opt-out
- Entry terminal → Firestore services: checks entry
- Entry terminal → Firestore services: logs denied scan
- Menu manager → Firestore services: saves menu
- Worker assignment → Firestore services: changes user role
- Committee console → Firestore services: loads operations data
- Student management → Firestore services: manages students
- Ledger → Firestore services: reads ledger data
- Announcements → Firestore services: manages announcements
- Feedback review → Firestore services: reviews feedback
- Routine and profile → Firestore services: loads routine
- Wallet history → Firestore services: loads history
- Student feedback → Firestore services: sends feedback
- Committee assignment → Firestore services: manages committee
- Succession → Firestore services: manages succession
- Super-admin console → Firestore services: loads admin data
- Firestore services → Firestore: reads and writes
- Firebase setup → Firebase Auth: configures
- Firebase setup → Firestore: configures