How phanna-m/sky5-hotel works
SKY5 is a luxury hotel booking and management platform: guests discover rooms, reserve and pay, then receive confirmations; administrators manage hotel operations and reporting. The repository tree exposes a Flutter app directory but no Dart source, so its internal screens and calls cannot be mapped; the README documents its capabilities and API stack. Backend routes, booking/payment behavior, and admin routing are shown where evidence is available. Dashed links mark documented client integrations or unverified wiring.
Main entry points: server.js API server · bookingController.js Reservation management · paymentController.js Payment management · telegramBotService.js Telegram bot
Components 26
Guest booking
- Customer app
flutter_app
Admin operations
- Admin dashboard
admin_dashboard/src/App.jsx - Admin modules
admin_dashboard/src/pages - Admin API client
admin_dashboard/src/services/api.js
REST API
- API server
backend/server.js - Authentication routes
backend/src/routes/authRoutes.js - Booking routes
backend/src/routes/bookingRoutes.js - Room routes
backend/src/routes/roomRoutes.js - Review routes
backend/src/routes/reviewRoutes.js - Other API routes
backend/src/routes - Authentication
backend/src/controllers/authController.js - Reservation management
backend/src/controllers/bookingController.js - Payment management
backend/src/controllers/paymentController.js - Room inventory
backend/src/controllers/roomController.js - Review moderation
backend/src/controllers/reviewController.js - Hotel and operations
backend/src/controllers
Booking services
- Booking rules
backend/src/services/bookingService.js - Sandbox data
backend/src/services/mockData.js - Notifications
backend/src/services/notificationService.js - Stripe payment service
backend/src/services/paymentService.js - Telegram bot
backend/src/services/telegramBotService.js
External systems
- Supabase database
backend/src/config/supabase.js - Stripe
- Telegram
Other components
- Hotel guest
- Hotel administrator
Connections 33
- Hotel guest → Customer app: uses
README.md - Customer app → API server: calls API
README.md - Hotel administrator → Admin dashboard: uses
admin_dashboard/src/App.jsx - Admin dashboard → Admin modules: routes to
admin_dashboard/src/App.jsx - Admin modules → Admin API client: calls
admin_dashboard/src/pages/ReviewsPage.jsx - Admin API client → API server: calls API
README.md - API server → Authentication routes: mounts
backend/server.js - API server → Booking routes: mounts
backend/server.js - API server → Room routes: mounts
backend/server.js - API server → Review routes: mounts
backend/server.js - API server → Other API routes: mounts
backend/server.js - Authentication routes → Authentication: dispatches
backend/src/routes/authRoutes.js - Booking routes → Reservation management: dispatches
backend/src/routes/bookingRoutes.js - Room routes → Room inventory: dispatches
backend/src/routes/roomRoutes.js - Review routes → Review moderation: dispatches
backend/src/routes/reviewRoutes.js - Other API routes → Hotel and operations: dispatches
backend/src/routes/reviewRoutes.js - Authentication → Supabase database: reads and writes
backend/src/controllers/authController.js - Reservation management → Supabase database: reads and writes
backend/src/controllers/bookingController.js - Room inventory → Supabase database: reads and writes
backend/src/controllers/roomController.js - Review moderation → Supabase database: reads and writes
backend/src/controllers/reviewController.js - Reservation management → Booking rules: checks and prices
backend/src/controllers/bookingController.js - Reservation management → Sandbox data: uses fallback
backend/src/controllers/bookingController.js - Room inventory → Sandbox data: uses fallback
backend/src/controllers/roomController.js - Payment management → Stripe payment service: creates and fulfills
backend/src/controllers/paymentController.js - Payment management → Sandbox data: uses fallback
backend/src/controllers/paymentController.js - Reservation management → Notifications: creates alerts
backend/src/controllers/bookingController.js - Payment management → Notifications: creates alerts
backend/src/controllers/paymentController.js - Reservation management → Telegram bot: sends alerts
backend/src/controllers/bookingController.js - Payment management → Telegram bot: sends alerts
backend/src/controllers/paymentController.js - Telegram bot → Notifications: creates alerts
backend/src/services/telegramBotService.js - Stripe payment service → Stripe: creates checkout
README.md - API server → Payment management: routes webhook
backend/server.js - Telegram bot → Telegram: sends messages
backend/src/services/telegramBotService.js