How abhigyanmishra219/hotel works
GrandStay is a multi-tenant hotel-management SaaS. Hotel staff authenticate into role-specific portals; front-desk users manage guests, reservations, check-in/out and billing, while managers administer property operations and review reports, and staff fulfill operational tasks. Platform administrators provision hotels and subscriptions. The graph emphasizes documented workflows and sampled booking, authorization, reporting, and persistence relationships; many portal implementations were not sampled, so those connections rely on README statements rather than inspected page code.
Main entry points: bookings/route.ts Booking API · hotels/route.ts Hotel Provisioning · overview/route.ts Reports API · manager Manager Portal
Components 34
Role Portals
- Admin Portal
src/app/admin - Manager Portal
src/app/manager - Front Desk
src/app/receptionist - Staff Portal
src/app/staff - Session Context
src/context/UserContext.tsx
Identity & Tenancy
- JWT Authentication
src/lib/auth.ts - Token Service
src/lib/jwt.ts - Manager Authorization
src/lib/authorization/manager.ts
Hotel Operations
- Booking API
src/app/api/bookings/route.ts - Booking Rules
src/lib/bookingService.ts - Guest Profiles API
src/app/api/customers/route.ts - Room Inventory API
src/app/api/manager/rooms/route.ts - Housekeeping API
src/app/api/housekeeping/route.ts - Room Service API
src/app/api/room-service/route.ts - Maintenance API
src/app/api/maintenance/route.ts - Invoices & Billing
src/app/api/invoices/route.ts - Reservations
src/models/Booking.ts - Guest Records
src/models/Customer.ts - Room Records
src/models/Room.ts - Cleaning Tasks
src/models/HousekeepingTask.ts - Service Requests
src/models/RoomServiceRequest.ts - Maintenance Requests
src/models/MaintenanceRequest.ts - Invoice Records
src/models/Invoice.ts
Platform Administration
- Hotel Provisioning
src/app/api/admin/hotels/route.ts - Hotel Tenants
src/models/Hotel.ts - Subscription Plans
src/models/SubscriptionPlan.ts - Hotel Subscriptions
src/models/HotelSubscription.ts - Audit Logging
src/lib/audit.ts - Audit Ledger
src/models/AuditLog.ts - Database Connector
src/lib/mongodb.ts
Reporting
- Reports API
src/app/api/reports/overview/route.ts - Report Export
src/app/api/reports/export/route.ts - Report Calculations
src/lib/reportService.ts
Other components
- Hotel User
Connections 45
- Hotel User → Admin Portal: administers platform
README.md - Hotel User → Manager Portal: manages property
README.md - Hotel User → Front Desk: handles front desk
README.md - Hotel User → Staff Portal: fulfills tasks
README.md - Front Desk → Booking API: creates reservations
README.md - Manager Portal → Room Inventory API: manages inventory
README.md - Staff Portal → Housekeeping API: updates cleaning
README.md - Staff Portal → Room Service API: fulfills requests
README.md - Staff Portal → Maintenance API: resolves issues
README.md - Manager Portal → Reports API: views analytics
README.md - Manager Portal → Report Export: exports reports
README.md - Admin Portal → Hotel Provisioning: provisions hotels
README.md - Admin Portal → Audit Logging: reviews audit log
README.md - Session Context → Manager Portal: supplies session
- JWT Authentication → Token Service: verifies token
src/lib/auth.ts - Manager Authorization → JWT Authentication: enforces role
src/lib/authorization/manager.ts - Manager Authorization → Database Connector: connects database
src/lib/authorization/manager.ts - Manager Authorization → Hotel Tenants: loads tenant
src/lib/authorization/manager.ts - Manager Authorization → Session Context: authenticates user
- Booking API → JWT Authentication: authorizes caller
src/app/api/bookings/route.ts - Booking API → Database Connector: connects database
src/app/api/bookings/route.ts - Booking API → Booking Rules: checks dates and conflicts
src/app/api/bookings/route.ts - Booking API → Reservations: queries reservations
src/app/api/bookings/route.ts - Booking API → Guest Records: checks guest
src/app/api/bookings/route.ts - Booking API → Room Records: checks room
src/app/api/bookings/route.ts - Booking Rules → Reservations: checks overlaps
src/lib/bookingService.ts - Booking Rules → Room Records: loads rooms
src/lib/bookingService.ts - Guest Profiles API → Guest Records: reads guest records
src/app/api/customers/route.ts - Housekeeping API → Cleaning Tasks: manages tasks
src/app/api/housekeeping/route.ts - Housekeeping API → Room Records: updates room status
src/app/api/housekeeping/route.ts - Room Service API → Service Requests: manages requests
src/app/api/room-service/route.ts - Maintenance API → Maintenance Requests: manages requests
src/app/api/maintenance/route.ts - Invoices & Billing → Invoice Records: manages invoices
src/app/api/invoices/route.ts - Hotel Provisioning → Database Connector: connects database
src/app/api/admin/hotels/route.ts - Hotel Provisioning → Hotel Tenants: creates hotels
src/app/api/admin/hotels/route.ts - Hotel Provisioning → Subscription Plans: loads plans
src/app/api/admin/hotels/route.ts - Hotel Provisioning → Hotel Subscriptions: manages subscription
src/app/api/admin/hotels/route.ts - Hotel Provisioning → Audit Logging: records actions
src/app/api/admin/hotels/route.ts - Audit Logging → Audit Ledger: writes events
src/lib/audit.ts - Reports API → Report Calculations: calculates metrics
src/app/api/reports/overview/route.ts - Reports API → Reservations: reads reservations
src/app/api/reports/overview/route.ts - Reports API → Invoice Records: reads invoices
src/app/api/reports/overview/route.ts - Reports API → Room Records: reads inventory
src/app/api/reports/overview/route.ts - Reports API → Cleaning Tasks: reads tasks
src/app/api/reports/overview/route.ts - Report Export → Report Calculations: formats exports
src/app/api/reports/export/route.ts