How 0x25kings/hotel-management works
This is a room-reservation frontend for guests and administrators. Guests browse rooms, create a booking through a staged room/add-on/type/payment flow, and view their bookings; administrators review bookings and payments and inspect room, add-on, inventory, and user data. The README says data is supplied by mockable services intended to be replaceable with a REST or GraphQL backend. Edges are limited to routing and service interactions visible in excerpts or explicitly documented; some unsampled page-to-service behavior is therefore not linked.
Main entry points: App.jsx Route dispatcher · bookingService.js Booking service · roomService.js Room service · BookingWizard.jsx Booking wizard
Components 31
App and identity
- Route dispatcher
src/App.jsx - Guest layout
src/layouts/UserLayout.jsx - Admin layout
src/layouts/AdminLayout.jsx - Role gate
src/routes/ProtectedRoute.jsx - Session context
src/context/AuthContext.jsx - Login and registration
src/pages/auth/Register.jsx
Guest reservation
- Room discovery
src/pages/user/Rooms.jsx - Room card
src/components/rooms/RoomCard.jsx - Room details
src/pages/user/RoomDetails.jsx - Booking wizard
src/pages/user/BookingWizard.jsx - My bookings
src/pages/user/MyBookings.jsx - Booking details
src/pages/user/BookingDetails.jsx - Guest dashboard
src/pages/user/Dashboard.jsx - Landing slideshow
src/components/common/Slideshow.jsx - Shared UI
src/components/common/ui.jsx - Async state hook
src/hooks/useAsync.js - Reservation formatting
src/utils/format.js
Administration
- Admin dashboard
src/pages/admin/Admin.jsx - Booking management
src/pages/admin/Admin.jsx - Payment review
src/pages/admin/Admin.jsx - Data tables
src/pages/admin/Admin.jsx
Data services
- Authentication
src/services/authService.js - Booking service
src/services/bookingService.js - Payment service
src/services/paymentService.js - Room service
src/services/roomService.js - Add-on service
src/services/addonService.js - User service
src/services/userService.js - Mock API adapter
src/services/api.js - Mock data store
src/mock/data.js
Other components
- Guest
- Administrator
Connections 48
- Guest → Route dispatcher: opens routes
src/App.jsx - Administrator → Route dispatcher: opens routes
src/App.jsx - Route dispatcher → Guest layout: routes guest pages
src/App.jsx - Route dispatcher → Admin layout: routes admin pages
src/App.jsx - Route dispatcher → Role gate: guards pages
src/App.jsx - Route dispatcher → Room discovery: routes to
src/App.jsx - Route dispatcher → Room details: routes to
src/App.jsx - Route dispatcher → Booking wizard: routes to
src/App.jsx - Route dispatcher → My bookings: routes to
src/App.jsx - Route dispatcher → Booking details: routes to
src/App.jsx - Route dispatcher → Guest dashboard: routes to
src/App.jsx - Route dispatcher → Login and registration: routes to
src/App.jsx - Route dispatcher → Admin dashboard: routes to
src/App.jsx - Route dispatcher → Booking management: routes to
src/App.jsx - Route dispatcher → Payment review: routes to
src/App.jsx - Route dispatcher → Data tables: routes to
src/App.jsx - Guest layout → Session context: reads session
src/layouts/UserLayout.jsx - Admin layout → Session context: reads session
src/layouts/AdminLayout.jsx - Role gate → Session context: checks role
src/routes/ProtectedRoute.jsx - Session context → Authentication: calls authentication
src/context/AuthContext.jsx - Login and registration → Session context: uses session actions
src/pages/auth/Register.jsx - Booking wizard → Room service: loads rooms
src/pages/user/BookingWizard.jsx - Booking wizard → Add-on service: loads add-ons
src/pages/user/BookingWizard.jsx - Booking wizard → Booking service: creates booking
src/pages/user/BookingWizard.jsx - Booking wizard → Payment service: submits proof
src/pages/user/BookingWizard.jsx - Admin dashboard → Booking service: loads bookings
src/pages/admin/Admin.jsx - Admin dashboard → Payment service: loads payments
src/pages/admin/Admin.jsx - Admin dashboard → Add-on service: loads stock
src/pages/admin/Admin.jsx - Booking management → Booking service: updates status
src/pages/admin/Admin.jsx - Payment review → Payment service: reviews payments
src/pages/admin/Admin.jsx - Data tables → Room service: loads room table
src/pages/admin/Admin.jsx - Data tables → Add-on service: loads stock tables
src/pages/admin/Admin.jsx - Data tables → User service: loads user table
src/pages/admin/Admin.jsx - Booking service → Mock API adapter: uses async adapter
src/services/bookingService.js - Payment service → Mock API adapter: uses async adapter
src/services/paymentService.js - Room service → Mock API adapter: uses async adapter
src/services/roomService.js - Authentication → Mock API adapter: uses async adapter
src/services/authService.js - Booking service → Mock data store: reads and writes
src/services/bookingService.js - Payment service → Mock data store: reads and writes
src/services/paymentService.js - Room service → Mock data store: reads and updates
src/services/roomService.js - Authentication → Mock data store: reads and updates
src/services/authService.js - Room details → Room service: loads room
src/pages/user/RoomDetails.jsx - Room discovery → Room service: loads rooms
src/pages/user/Rooms.jsx - My bookings → Booking service: loads bookings
src/pages/user/MyBookings.jsx - Booking details → Booking service: loads booking
src/pages/user/BookingDetails.jsx - Guest dashboard → Booking service: loads bookings
src/pages/user/Dashboard.jsx - Room discovery → Room card: renders cards
src/pages/user/Rooms.jsx - Room card → Shared UI: uses components
src/components/rooms/RoomCard.jsx