# abhigyanmishra219/hotel architecture

> Architecture diagram of the GitHub repository abhigyanmishra219/hotel, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-02). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/abhigyanmishra219/hotel
- Repository: https://github.com/abhigyanmishra219/hotel

## Overview

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: [`src/app/api/bookings/route.ts`](https://github.com/abhigyanmishra219/hotel/blob/main/src/app/api/bookings/route.ts) (Booking API), [`src/app/api/admin/hotels/route.ts`](https://github.com/abhigyanmishra219/hotel/blob/main/src/app/api/admin/hotels/route.ts) (Hotel Provisioning), [`src/app/api/reports/overview/route.ts`](https://github.com/abhigyanmishra219/hotel/blob/main/src/app/api/reports/overview/route.ts) (Reports API), [`src/app/manager`](https://github.com/abhigyanmishra219/hotel/tree/main/src/app/manager) (Manager Portal)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_portals["Role Portals"]
  node_admin_portal["Admin Portal"]
  node_manager_portal["Manager Portal"]
  node_frontdesk_portal["Front Desk"]
  node_staff_portal["Staff Portal"]
  node_user_context["Session Context<br/>[UserContext.tsx]"]
end

subgraph group_security["Identity &amp; Tenancy"]
  node_auth["JWT Authentication<br/>[auth.ts]"]
  node_jwt["Token Service<br/>[jwt.ts]"]
  node_manager_auth["Manager Authorization<br/>[manager.ts]"]
end

subgraph group_hotelops["Hotel Operations"]
  node_booking_api["Booking API<br/>[route.ts]"]
  node_booking_rules["Booking Rules<br/>[bookingService.ts]"]
  node_customer_api["Guest Profiles API<br/>[route.ts]"]
  node_room_api["Room Inventory API<br/>[route.ts]"]
  node_housekeeping_api["Housekeeping API<br/>[route.ts]"]
  node_roomservice_api["Room Service API<br/>[route.ts]"]
  node_maintenance_api["Maintenance API<br/>[route.ts]"]
  node_invoice_api["Invoices &amp; Billing<br/>[route.ts]"]
  node_booking_model[("Reservations<br/>[Booking.ts]")]
  node_customer_model[("Guest Records<br/>[Customer.ts]")]
  node_room_model[("Room Records<br/>[Room.ts]")]
  node_housekeeping_model[("Cleaning Tasks")]
  node_roomservice_model[("Service Requests")]
  node_maintenance_model[("Maintenance Requests")]
  node_invoice_model[("Invoice Records<br/>[Invoice.ts]")]
end

subgraph group_platform["Platform Administration"]
  node_admin_hotels["Hotel Provisioning<br/>[route.ts]"]
  node_hotel_model[("Hotel Tenants<br/>[Hotel.ts]")]
  node_subscription_plans[("Subscription Plans")]
  node_hotel_subscription[("Hotel Subscriptions")]
  node_audit_service["Audit Logging<br/>[audit.ts]"]
  node_audit_model[("Audit Ledger<br/>[AuditLog.ts]")]
  node_database_connector["Database Connector<br/>[mongodb.ts]"]
end

subgraph group_insights["Reporting"]
  node_reports_api["Reports API<br/>[route.ts]"]
  node_report_export["Report Export<br/>[route.ts]"]
  node_report_service["Report Calculations<br/>[reportService.ts]"]
end

node_hotel_user(("Hotel User"))

node_hotel_user -->|"administers platform"| node_admin_portal
node_hotel_user -->|"manages property"| node_manager_portal
node_hotel_user -->|"handles front desk"| node_frontdesk_portal
node_hotel_user -->|"fulfills tasks"| node_staff_portal
node_frontdesk_portal -->|"creates reservations"| node_booking_api
node_manager_portal -->|"manages inventory"| node_room_api
node_staff_portal -->|"updates cleaning"| node_housekeeping_api
node_staff_portal -->|"fulfills requests"| node_roomservice_api
node_staff_portal -->|"resolves issues"| node_maintenance_api
node_manager_portal -->|"views analytics"| node_reports_api
node_manager_portal -->|"exports reports"| node_report_export
node_admin_portal -->|"provisions hotels"| node_admin_hotels
node_admin_portal -->|"reviews audit log"| node_audit_service
node_user_context -->|"supplies session"| node_manager_portal
node_auth -->|"verifies token"| node_jwt
node_manager_auth -->|"enforces role"| node_auth
node_manager_auth -->|"connects database"| node_database_connector
node_manager_auth -->|"loads tenant"| node_hotel_model
node_manager_auth -.->|"authenticates user"| node_user_context
node_booking_api -->|"authorizes caller"| node_auth
node_booking_api -->|"connects database"| node_database_connector
node_booking_api -->|"checks dates and conflicts"| node_booking_rules
node_booking_api -->|"queries reservations"| node_booking_model
node_booking_api -->|"checks guest"| node_customer_model
node_booking_api -->|"checks room"| node_room_model
node_booking_rules -->|"checks overlaps"| node_booking_model
node_booking_rules -->|"loads rooms"| node_room_model
node_customer_api -->|"reads guest records"| node_customer_model
node_housekeeping_api -->|"manages tasks"| node_housekeeping_model
node_housekeeping_api -->|"updates room status"| node_room_model
node_roomservice_api -->|"manages requests"| node_roomservice_model
node_maintenance_api -->|"manages requests"| node_maintenance_model
node_invoice_api -->|"manages invoices"| node_invoice_model
node_admin_hotels -->|"connects database"| node_database_connector
node_admin_hotels -->|"creates hotels"| node_hotel_model
node_admin_hotels -->|"loads plans"| node_subscription_plans
node_admin_hotels -->|"manages subscription"| node_hotel_subscription
node_admin_hotels -->|"records actions"| node_audit_service
node_audit_service -->|"writes events"| node_audit_model
node_reports_api -->|"calculates metrics"| node_report_service
node_reports_api -->|"reads reservations"| node_booking_model
node_reports_api -->|"reads invoices"| node_invoice_model
node_reports_api -->|"reads inventory"| node_room_model
node_reports_api -->|"reads tasks"| node_housekeeping_model
node_report_export -->|"formats exports"| node_report_service

click node_admin_portal "https://github.com/abhigyanmishra219/hotel/tree/main/src/app/admin"
click node_manager_portal "https://github.com/abhigyanmishra219/hotel/tree/main/src/app/manager"
click node_frontdesk_portal "https://github.com/abhigyanmishra219/hotel/tree/main/src/app/receptionist"
click node_staff_portal "https://github.com/abhigyanmishra219/hotel/tree/main/src/app/staff"
click node_user_context "https://github.com/abhigyanmishra219/hotel/blob/main/src/context/UserContext.tsx"
click node_auth "https://github.com/abhigyanmishra219/hotel/blob/main/src/lib/auth.ts"
click node_jwt "https://github.com/abhigyanmishra219/hotel/blob/main/src/lib/jwt.ts"
click node_manager_auth "https://github.com/abhigyanmishra219/hotel/blob/main/src/lib/authorization/manager.ts"
click node_booking_api "https://github.com/abhigyanmishra219/hotel/blob/main/src/app/api/bookings/route.ts"
click node_booking_rules "https://github.com/abhigyanmishra219/hotel/blob/main/src/lib/bookingService.ts"
click node_customer_api "https://github.com/abhigyanmishra219/hotel/blob/main/src/app/api/customers/route.ts"
click node_room_api "https://github.com/abhigyanmishra219/hotel/blob/main/src/app/api/manager/rooms/route.ts"
click node_housekeeping_api "https://github.com/abhigyanmishra219/hotel/blob/main/src/app/api/housekeeping/route.ts"
click node_roomservice_api "https://github.com/abhigyanmishra219/hotel/blob/main/src/app/api/room-service/route.ts"
click node_maintenance_api "https://github.com/abhigyanmishra219/hotel/blob/main/src/app/api/maintenance/route.ts"
click node_invoice_api "https://github.com/abhigyanmishra219/hotel/blob/main/src/app/api/invoices/route.ts"
click node_booking_model "https://github.com/abhigyanmishra219/hotel/blob/main/src/models/Booking.ts"
click node_customer_model "https://github.com/abhigyanmishra219/hotel/blob/main/src/models/Customer.ts"
click node_room_model "https://github.com/abhigyanmishra219/hotel/blob/main/src/models/Room.ts"
click node_housekeeping_model "https://github.com/abhigyanmishra219/hotel/blob/main/src/models/HousekeepingTask.ts"
click node_roomservice_model "https://github.com/abhigyanmishra219/hotel/blob/main/src/models/RoomServiceRequest.ts"
click node_maintenance_model "https://github.com/abhigyanmishra219/hotel/blob/main/src/models/MaintenanceRequest.ts"
click node_invoice_model "https://github.com/abhigyanmishra219/hotel/blob/main/src/models/Invoice.ts"
click node_admin_hotels "https://github.com/abhigyanmishra219/hotel/blob/main/src/app/api/admin/hotels/route.ts"
click node_hotel_model "https://github.com/abhigyanmishra219/hotel/blob/main/src/models/Hotel.ts"
click node_subscription_plans "https://github.com/abhigyanmishra219/hotel/blob/main/src/models/SubscriptionPlan.ts"
click node_hotel_subscription "https://github.com/abhigyanmishra219/hotel/blob/main/src/models/HotelSubscription.ts"
click node_audit_service "https://github.com/abhigyanmishra219/hotel/blob/main/src/lib/audit.ts"
click node_audit_model "https://github.com/abhigyanmishra219/hotel/blob/main/src/models/AuditLog.ts"
click node_reports_api "https://github.com/abhigyanmishra219/hotel/blob/main/src/app/api/reports/overview/route.ts"
click node_report_export "https://github.com/abhigyanmishra219/hotel/blob/main/src/app/api/reports/export/route.ts"
click node_report_service "https://github.com/abhigyanmishra219/hotel/blob/main/src/lib/reportService.ts"
click node_database_connector "https://github.com/abhigyanmishra219/hotel/blob/main/src/lib/mongodb.ts"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_admin_portal,node_manager_portal,node_frontdesk_portal,node_staff_portal,node_user_context,node_hotel_user toneBlue
class node_auth,node_jwt,node_manager_auth toneAmber
class node_booking_api,node_booking_rules,node_customer_api,node_room_api,node_housekeeping_api,node_roomservice_api,node_maintenance_api,node_invoice_api,node_booking_model,node_customer_model,node_room_model,node_housekeeping_model,node_roomservice_model,node_maintenance_model,node_invoice_model toneMint
class node_admin_hotels,node_hotel_model,node_subscription_plans,node_hotel_subscription,node_audit_service,node_audit_model,node_database_connector toneRose
class node_reports_api,node_report_export,node_report_service toneIndigo
```

## Components

### Role Portals

- [Admin Portal](https://github.com/abhigyanmishra219/hotel/tree/main/src/app/admin): `src/app/admin`
- [Manager Portal](https://github.com/abhigyanmishra219/hotel/tree/main/src/app/manager): `src/app/manager`
- [Front Desk](https://github.com/abhigyanmishra219/hotel/tree/main/src/app/receptionist): `src/app/receptionist`
- [Staff Portal](https://github.com/abhigyanmishra219/hotel/tree/main/src/app/staff): `src/app/staff`
- [Session Context](https://github.com/abhigyanmishra219/hotel/blob/main/src/context/UserContext.tsx): `src/context/UserContext.tsx`

### Identity & Tenancy

- [JWT Authentication](https://github.com/abhigyanmishra219/hotel/blob/main/src/lib/auth.ts): `src/lib/auth.ts`
- [Token Service](https://github.com/abhigyanmishra219/hotel/blob/main/src/lib/jwt.ts): `src/lib/jwt.ts`
- [Manager Authorization](https://github.com/abhigyanmishra219/hotel/blob/main/src/lib/authorization/manager.ts): `src/lib/authorization/manager.ts`

### Hotel Operations

- [Booking API](https://github.com/abhigyanmishra219/hotel/blob/main/src/app/api/bookings/route.ts): `src/app/api/bookings/route.ts`
- [Booking Rules](https://github.com/abhigyanmishra219/hotel/blob/main/src/lib/bookingService.ts): `src/lib/bookingService.ts`
- [Guest Profiles API](https://github.com/abhigyanmishra219/hotel/blob/main/src/app/api/customers/route.ts): `src/app/api/customers/route.ts`
- [Room Inventory API](https://github.com/abhigyanmishra219/hotel/blob/main/src/app/api/manager/rooms/route.ts): `src/app/api/manager/rooms/route.ts`
- [Housekeeping API](https://github.com/abhigyanmishra219/hotel/blob/main/src/app/api/housekeeping/route.ts): `src/app/api/housekeeping/route.ts`
- [Room Service API](https://github.com/abhigyanmishra219/hotel/blob/main/src/app/api/room-service/route.ts): `src/app/api/room-service/route.ts`
- [Maintenance API](https://github.com/abhigyanmishra219/hotel/blob/main/src/app/api/maintenance/route.ts): `src/app/api/maintenance/route.ts`
- [Invoices & Billing](https://github.com/abhigyanmishra219/hotel/blob/main/src/app/api/invoices/route.ts): `src/app/api/invoices/route.ts`
- [Reservations](https://github.com/abhigyanmishra219/hotel/blob/main/src/models/Booking.ts): `src/models/Booking.ts`
- [Guest Records](https://github.com/abhigyanmishra219/hotel/blob/main/src/models/Customer.ts): `src/models/Customer.ts`
- [Room Records](https://github.com/abhigyanmishra219/hotel/blob/main/src/models/Room.ts): `src/models/Room.ts`
- [Cleaning Tasks](https://github.com/abhigyanmishra219/hotel/blob/main/src/models/HousekeepingTask.ts): `src/models/HousekeepingTask.ts`
- [Service Requests](https://github.com/abhigyanmishra219/hotel/blob/main/src/models/RoomServiceRequest.ts): `src/models/RoomServiceRequest.ts`
- [Maintenance Requests](https://github.com/abhigyanmishra219/hotel/blob/main/src/models/MaintenanceRequest.ts): `src/models/MaintenanceRequest.ts`
- [Invoice Records](https://github.com/abhigyanmishra219/hotel/blob/main/src/models/Invoice.ts): `src/models/Invoice.ts`

### Platform Administration

- [Hotel Provisioning](https://github.com/abhigyanmishra219/hotel/blob/main/src/app/api/admin/hotels/route.ts): `src/app/api/admin/hotels/route.ts`
- [Hotel Tenants](https://github.com/abhigyanmishra219/hotel/blob/main/src/models/Hotel.ts): `src/models/Hotel.ts`
- [Subscription Plans](https://github.com/abhigyanmishra219/hotel/blob/main/src/models/SubscriptionPlan.ts): `src/models/SubscriptionPlan.ts`
- [Hotel Subscriptions](https://github.com/abhigyanmishra219/hotel/blob/main/src/models/HotelSubscription.ts): `src/models/HotelSubscription.ts`
- [Audit Logging](https://github.com/abhigyanmishra219/hotel/blob/main/src/lib/audit.ts): `src/lib/audit.ts`
- [Audit Ledger](https://github.com/abhigyanmishra219/hotel/blob/main/src/models/AuditLog.ts): `src/models/AuditLog.ts`
- [Database Connector](https://github.com/abhigyanmishra219/hotel/blob/main/src/lib/mongodb.ts): `src/lib/mongodb.ts`

### Reporting

- [Reports API](https://github.com/abhigyanmishra219/hotel/blob/main/src/app/api/reports/overview/route.ts): `src/app/api/reports/overview/route.ts`
- [Report Export](https://github.com/abhigyanmishra219/hotel/blob/main/src/app/api/reports/export/route.ts): `src/app/api/reports/export/route.ts`
- [Report Calculations](https://github.com/abhigyanmishra219/hotel/blob/main/src/lib/reportService.ts): `src/lib/reportService.ts`

### Other components

- **Hotel User**

## Connections

- Hotel User → Admin Portal: administers platform (evidence: `README.md`)
- Hotel User → Manager Portal: manages property (evidence: `README.md`)
- Hotel User → Front Desk: handles front desk (evidence: `README.md`)
- Hotel User → Staff Portal: fulfills tasks (evidence: `README.md`)
- Front Desk → Booking API: creates reservations (evidence: `README.md`)
- Manager Portal → Room Inventory API: manages inventory (evidence: `README.md`)
- Staff Portal → Housekeeping API: updates cleaning (evidence: `README.md`)
- Staff Portal → Room Service API: fulfills requests (evidence: `README.md`)
- Staff Portal → Maintenance API: resolves issues (evidence: `README.md`)
- Manager Portal → Reports API: views analytics (evidence: `README.md`)
- Manager Portal → Report Export: exports reports (evidence: `README.md`)
- Admin Portal → Hotel Provisioning: provisions hotels (evidence: `README.md`)
- Admin Portal → Audit Logging: reviews audit log (evidence: `README.md`)
- Session Context → Manager Portal: supplies session
- JWT Authentication → Token Service: verifies token (evidence: `src/lib/auth.ts`)
- Manager Authorization → JWT Authentication: enforces role (evidence: `src/lib/authorization/manager.ts`)
- Manager Authorization → Database Connector: connects database (evidence: `src/lib/authorization/manager.ts`)
- Manager Authorization → Hotel Tenants: loads tenant (evidence: `src/lib/authorization/manager.ts`)
- Manager Authorization → Session Context: authenticates user
- Booking API → JWT Authentication: authorizes caller (evidence: `src/app/api/bookings/route.ts`)
- Booking API → Database Connector: connects database (evidence: `src/app/api/bookings/route.ts`)
- Booking API → Booking Rules: checks dates and conflicts (evidence: `src/app/api/bookings/route.ts`)
- Booking API → Reservations: queries reservations (evidence: `src/app/api/bookings/route.ts`)
- Booking API → Guest Records: checks guest (evidence: `src/app/api/bookings/route.ts`)
- Booking API → Room Records: checks room (evidence: `src/app/api/bookings/route.ts`)
- Booking Rules → Reservations: checks overlaps (evidence: `src/lib/bookingService.ts`)
- Booking Rules → Room Records: loads rooms (evidence: `src/lib/bookingService.ts`)
- Guest Profiles API → Guest Records: reads guest records (evidence: `src/app/api/customers/route.ts`)
- Housekeeping API → Cleaning Tasks: manages tasks (evidence: `src/app/api/housekeeping/route.ts`)
- Housekeeping API → Room Records: updates room status (evidence: `src/app/api/housekeeping/route.ts`)
- Room Service API → Service Requests: manages requests (evidence: `src/app/api/room-service/route.ts`)
- Maintenance API → Maintenance Requests: manages requests (evidence: `src/app/api/maintenance/route.ts`)
- Invoices & Billing → Invoice Records: manages invoices (evidence: `src/app/api/invoices/route.ts`)
- Hotel Provisioning → Database Connector: connects database (evidence: `src/app/api/admin/hotels/route.ts`)
- Hotel Provisioning → Hotel Tenants: creates hotels (evidence: `src/app/api/admin/hotels/route.ts`)
- Hotel Provisioning → Subscription Plans: loads plans (evidence: `src/app/api/admin/hotels/route.ts`)
- Hotel Provisioning → Hotel Subscriptions: manages subscription (evidence: `src/app/api/admin/hotels/route.ts`)
- Hotel Provisioning → Audit Logging: records actions (evidence: `src/app/api/admin/hotels/route.ts`)
- Audit Logging → Audit Ledger: writes events (evidence: `src/lib/audit.ts`)
- Reports API → Report Calculations: calculates metrics (evidence: `src/app/api/reports/overview/route.ts`)
- Reports API → Reservations: reads reservations (evidence: `src/app/api/reports/overview/route.ts`)
- Reports API → Invoice Records: reads invoices (evidence: `src/app/api/reports/overview/route.ts`)
- Reports API → Room Records: reads inventory (evidence: `src/app/api/reports/overview/route.ts`)
- Reports API → Cleaning Tasks: reads tasks (evidence: `src/app/api/reports/overview/route.ts`)
- Report Export → Report Calculations: formats exports (evidence: `src/app/api/reports/export/route.ts`)
