How singhamit55/hostel-management-system works
This is a multi-tenant hostel management dashboard for students, hostel administrators, and a system owner. The main workflow is that users enter through the browser UI, authenticate or submit a registration application, and then view or manage hostel operations such as rooms, notices, complaints, leave, visitors, and events. The frontend synchronizes tenant data through the API, with a LocalStorage fallback, while the server applies authentication and routes persistence operations to MongoDB. The README documents key capabilities, but the sampled excerpts do not show every UI/API interaction, so uncertain links are omitted.
Main entry points: database.js MongoDB access · server.js Web/API server · db.js Client data layer · index.html Hostel dashboard
Components 16
Browser experience
- Hostel dashboard
index.html - Role-based UI
js/app.js - Client data layer
js/db.js - Hostel operations
js/app.js
Application services
- Web/API server
server.js - Authentication
server.js - Hostel registration
server.js - Student applications
server.js - Tenant data API
server.js - Owner administration
server.js
Persistence
- MongoDB access
database.js - MongoDB
- LocalStorage cache
js/db.js
Other components
- Student
- Hostel admin
- System owner
Connections 23
- Student → Hostel dashboard: opens
README.md - Hostel admin → Hostel dashboard: opens
README.md - System owner → Hostel dashboard: opens
- Hostel dashboard → Role-based UI: loads
- Role-based UI → Client data layer: reads and writes
js/app.js - Student → Authentication: authenticates
README.md - Hostel admin → Authentication: authenticates
README.md - Authentication → MongoDB access: queries accounts
server.js - Web/API server → Authentication: routes
server.js - Web/API server → Hostel registration: routes
server.js - Web/API server → Student applications: routes
server.js - Web/API server → Tenant data API: routes
server.js - Web/API server → Owner administration: routes
server.js - Hostel registration → MongoDB access: checks and creates
server.js - Student applications → MongoDB access: reads and saves
server.js - Tenant data API → MongoDB access: reads and saves
server.js - Owner administration → MongoDB access: manages accounts
server.js - MongoDB access → MongoDB: persists data
database.js - Role-based UI → Hostel operations: renders operations
js/app.js - Client data layer → Tenant data API: requests tenant data
js/db.js - Client data layer → LocalStorage cache: caches and falls back
js/db.js - Hostel registration → Student applications: creates applications
server.js - Hostel operations → Client data layer: updates state