How ahmed-husssain/hotelms works
Stayza is a hotel-management system spanning guest reservations and in-stay services, staff operations, housekeeping, and executive administration. The guest flow is suite discovery, date/pricing check, temporary room hold, payment and confirmation, then self-service during the stay. Front-desk and housekeeping workflows update shared operational state, with real-time events for staff terminals. Evidence is drawn from the README, the supplied excerpts, and SOURCE INDEX references; several UI and backend subsystems are documented but their implementation details were not sampled.
Main entry points: api.js HTTP Client · models Hotel Records · bookingController.js Booking Lifecycle · App.jsx Web Application
Components 24
Guest Experience
- Web Application
client/src/App.jsx - Booking Journey
client/src/pages/BookingPage.jsx - Guest Portal
client/src/pages/GuestPortalPage.jsx - Hotel Data Context
client/src/context/HotelDataContext.jsx
Hotel Operations
- Management Dashboard
client/src/pages/AdminPage.jsx - Front Desk
client/src/pages/FrontDeskPage.jsx - Housekeeping
client/src/pages/HousekeepingPage.jsx
API and Services
- HTTP Client
client/src/services/api.js - Express and Socket Server
server/server.js - Booking Routes
server/src/routes/bookingRoutes.js - Booking Lifecycle
server/src/controllers/bookingController.js - Pricing Rules
server/src/services/pricingService.js - Availability and Holds
server/src/services/availabilityService.js - Payment Processing
server/src/controllers/paymentController.js - Invoice Generation
server/src/services/invoiceService.js - Front Desk Operations
server/src/controllers/staffOperationsController.js - Housekeeping Operations
server/src/controllers/housekeepingController.js - Management and Analytics
server/src/controllers/adminController.js
Data and Integrations
- Hotel Records
server/src/models - MongoDB Atlas
- Safepay Gateway
- Real-Time Events
server/server.js
Other components
- Guest
- Hotel Staff
Connections 31
- Guest → Web Application: uses
- Hotel Staff → Web Application: uses
- Web Application → Booking Journey: routes to
client/src/App.jsx - Web Application → Guest Portal: routes to
client/src/App.jsx - Guest → Booking Journey: searches and reserves
- Booking Journey → HTTP Client: requests booking
- Guest Portal → HTTP Client: requests stay services
client/src/pages/GuestPortalPage.jsx - Front Desk → Hotel Data Context: uses operations state
- Housekeeping → Hotel Data Context: uses operations state
- Hotel Data Context → HTTP Client: calls
client/src/context/HotelDataContext.jsx - HTTP Client → Express and Socket Server: calls API
- Express and Socket Server → Booking Routes: mounts
server/server.js - Booking Routes → Booking Lifecycle: dispatches
server/src/routes/bookingRoutes.js - Booking Lifecycle → Availability and Holds: checks availability
server/src/controllers/bookingController.js - Booking Lifecycle → Pricing Rules: calculates pricing
server/src/controllers/bookingController.js - Booking Lifecycle → Hotel Records: reads and writes
server/src/controllers/bookingController.js - Booking Lifecycle → Invoice Generation: generates invoice
server/src/controllers/bookingController.js - Booking Lifecycle → Safepay Gateway: starts checkout
- Payment Processing → Hotel Records: reads and writes
server/src/controllers/paymentController.js - Availability and Holds → Hotel Records: checks room bookings
server/src/services/availabilityService.js - Management Dashboard → HTTP Client: requests management data
- Management and Analytics → Hotel Records: reads and writes
server/src/controllers/adminController.js - Front Desk → HTTP Client: requests desk actions
- Housekeeping → HTTP Client: requests housekeeping actions
- Front Desk Operations → Hotel Records: reads and writes
server/src/controllers/staffOperationsController.js - Housekeeping Operations → Hotel Records: reads and writes
server/src/controllers/housekeepingController.js - Front Desk Operations → Real-Time Events: broadcasts events
server/src/controllers/staffOperationsController.js - Express and Socket Server → Real-Time Events: initializes
server/server.js - Hotel Records → MongoDB Atlas: persists records
- Management Dashboard → Management and Analytics: requests reports
- Housekeeping Operations → Hotel Staff: updates room operations