How vayu-401/hostelmate works
HostelMate is a role-based hostel management platform for students, wardens, and parents. Users sign in, then use role-specific dashboards to manage hostel activity; the documented architecture sends client requests over REST to an Express API, whose routes handle domain operations and persist data. Major capabilities include attendance, complaints, leave, fees, rooms, mess, visitors, notices, lost-and-found, AI, and live notifications. The route inventory is documented by server registration; unsampled feature implementations and most client-to-route mappings are represented at subsystem level rather than inferred individually.
Main entry points: index.js REST API server · attendance.js Attendance · payments.js Fees and payments · auth.js Authentication
Components 19
Role-based client
- Sign in
apps/client/app/(auth)/login/page.tsx - Role dashboards
apps/client/app/(dashboard) - Supabase client
apps/client/lib/supabase/client.ts
API and access
- REST API server
apps/server/src/index.js - Authentication
apps/server/src/middleware/auth.js - Role access
apps/server/src/middleware/rbac.js
Hostel operations
- Attendance
apps/server/src/routes/attendance.js - Complaints and AI
apps/server/src/routes/complaints.js - Leave requests
apps/server/src/routes/leaves.js - Fees and payments
apps/server/src/routes/payments.js - Rooms and transfers
apps/server/src/routes/rooms.js - Community services
apps/server/src/routes
Data and integrations
- Supabase data
apps/server/src/config/supabase.js - Redis cache
apps/server/src/config/redis.js - Live events
apps/server/src/config/socket.js - Notifications
apps/server/src/config/notify.js - Razorpay payments
apps/server/src/config/razorpay.js - AI services
apps/server/src/config/openai.js
Other components
- Hostel user
Connections 23
- Hostel user → Sign in: signs in
apps/client/app/(auth)/login/page.tsx - Sign in → Supabase client: creates client
apps/client/app/(auth)/login/page.tsx - Hostel user → Role dashboards: uses dashboards
- Role dashboards → REST API server: REST requests
- REST API server → Attendance: mounts route
apps/server/src/index.js - REST API server → Complaints and AI: mounts route
apps/server/src/index.js - REST API server → Leave requests: mounts route
apps/server/src/index.js - REST API server → Fees and payments: mounts route
apps/server/src/index.js - REST API server → Rooms and transfers: mounts route
apps/server/src/index.js - REST API server → Community services: mounts routes
apps/server/src/index.js - Attendance → Authentication: authenticates
apps/server/src/routes/attendance.js - Fees and payments → Authentication: authenticates
apps/server/src/routes/payments.js - Rooms and transfers → Authentication: authenticates
apps/server/src/routes/rooms.js - Authentication → Supabase data: checks user
apps/server/src/middleware/auth.js - Attendance → Supabase data: reads and writes
apps/server/src/routes/attendance.js - Fees and payments → Supabase data: reads and writes
apps/server/src/routes/payments.js - Rooms and transfers → Supabase data: reads and writes
apps/server/src/routes/rooms.js - Attendance → Redis cache: uses cache
apps/server/src/routes/attendance.js - Attendance → Live events: emits events
apps/server/src/routes/attendance.js - Attendance → Notifications: creates notifications
apps/server/src/routes/attendance.js - Fees and payments → Notifications: creates notifications
apps/server/src/routes/payments.js - Fees and payments → Razorpay payments: creates and verifies orders
apps/server/src/routes/payments.js - Complaints and AI → AI services: AI support