How nyallaiah/hotelmanagementsystem works
Grand Azure is a hotel PMS/ERP joining guest booking and self-service with staff operations. Guests browse rooms, check availability, book and pay, then use a booking reference to view folios; staff authenticate to manage reservations, room status, dining orders, invoices and analytics. The frontend API client calls a FastAPI app that registers domain routers; those routes use database, authentication and payment services. Relationships are limited to visible imports, calls, and README-documented capabilities; unsampled route internals are not inferred.
Main entry points: App.jsx App and navigation · api.js API client · main.py FastAPI application · database.py Database adapter
Components 29
Guest experience
- App and navigation
frontend/src/App.jsx - Hotel showcase
frontend/src/components/guest/Amenities.jsx - Room catalog
frontend/src/components/guest/RoomCatalog.jsx - Booking flow
frontend/src/components/guest/BookingModal.jsx - Guest folio
frontend/src/components/guest/GuestFolio.jsx
Staff operations
- Session and auth
frontend/src/context/AuthContext.jsx - Staff login
frontend/src/components/admin/AdminLogin.jsx - Operations dashboard
frontend/src/components/admin/AdminDashboard.jsx - Room and housekeeping
frontend/src/components/admin/RoomMatrix.jsx - Booking management
frontend/src/components/admin/BookingManagement.jsx - Kitchen POS
frontend/src/components/admin/KitchenPOS.jsx - Folio and invoices
frontend/src/components/admin/FolioInvoices.jsx
Backend services
- API client
frontend/src/services/api.js - FastAPI application
backend/main.py - Domain schemas
backend/models/schemas.py - Authentication routes
backend/routes/auth.py - Booking routes
backend/routes/bookings.py - Room routes
backend/routes/rooms.py - Payment routes
backend/routes/payments.py - Dining routes
backend/routes/pos.py - Analytics routes
backend/routes/analytics.py - Identity and access
backend/services/auth_service.py - Payment and invoice service
backend/services/payment_service.py
Persistence and integrations
- Database adapter
backend/database.py - MongoDB or memory store
- Supabase auth
- Stripe or Razorpay
Other components
- Guest
- Hotel staff
Connections 45
- Guest → App and navigation: uses
frontend/src/App.jsx - Hotel staff → App and navigation: opens portal
frontend/src/App.jsx - App and navigation → Hotel showcase: renders
frontend/src/App.jsx - App and navigation → Room catalog: renders
frontend/src/App.jsx - App and navigation → Booking flow: renders
frontend/src/App.jsx - App and navigation → Guest folio: renders
frontend/src/App.jsx - App and navigation → Staff login: renders
frontend/src/App.jsx - App and navigation → Operations dashboard: renders
frontend/src/App.jsx - App and navigation → Room and housekeeping: renders
frontend/src/App.jsx - App and navigation → Booking management: renders
frontend/src/App.jsx - App and navigation → Kitchen POS: renders
frontend/src/App.jsx - App and navigation → Folio and invoices: renders
frontend/src/App.jsx - App and navigation → Session and auth: provides session
frontend/src/App.jsx - Staff login → Session and auth: uses
frontend/src/components/admin/AdminLogin.jsx - Booking flow → API client: requests
frontend/src/components/guest/BookingModal.jsx - Guest folio → API client: requests
frontend/src/components/guest/GuestFolio.jsx - Session and auth → API client: calls
frontend/src/context/AuthContext.jsx - Session and auth → Supabase auth: optional sign-in
frontend/src/context/AuthContext.jsx - Operations dashboard → API client: requests
frontend/src/components/admin/AdminDashboard.jsx - Room and housekeeping → API client: requests
frontend/src/components/admin/RoomMatrix.jsx - Booking management → API client: requests
frontend/src/components/admin/BookingManagement.jsx - Kitchen POS → API client: requests
frontend/src/components/admin/KitchenPOS.jsx - Folio and invoices → API client: requests
frontend/src/components/admin/FolioInvoices.jsx - API client → FastAPI application: HTTP API
frontend/src/services/api.js - FastAPI application → Authentication routes: registers
backend/main.py - FastAPI application → Room routes: registers
backend/main.py - FastAPI application → Booking routes: registers
backend/main.py - FastAPI application → Payment routes: registers
backend/main.py - FastAPI application → Dining routes: registers
backend/main.py - FastAPI application → Analytics routes: registers
backend/main.py - Authentication routes → Identity and access: uses
backend/routes/auth.py - Booking routes → Payment and invoice service: uses
backend/routes/bookings.py - Identity and access → Database adapter: looks up users
backend/services/auth_service.py - Database adapter → MongoDB or memory store: backs collections
backend/database.py - Payment and invoice service → Stripe or Razorpay: optional processing
backend/services/payment_service.py - FastAPI application → Database adapter: connects and seeds
backend/main.py - Booking routes → Domain schemas: validates bookings
backend/routes/bookings.py - Authentication routes → Domain schemas: validates identity
backend/routes/auth.py - Payment routes → Payment and invoice service: uses
backend/routes/payments.py - Payment routes → Database adapter: accesses records
backend/routes/payments.py - Booking routes → Database adapter: reads and writes
backend/routes/bookings.py - Room routes → Database adapter: accesses rooms
backend/routes/rooms.py - Dining routes → Database adapter: accesses dining data
backend/routes/pos.py - Analytics routes → Database adapter: reads metrics
backend/routes/analytics.py - Room catalog → API client: availability path