# phanna-m/sky5-hotel architecture

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

- Interactive diagram: https://gitdiagram.com/phanna-m/sky5-hotel
- Repository: https://github.com/phanna-m/sky5-hotel

## Overview

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: [`backend/server.js`](https://github.com/phanna-m/sky5-hotel/blob/main/backend/server.js) (API server), [`backend/src/controllers/bookingController.js`](https://github.com/phanna-m/sky5-hotel/blob/main/backend/src/controllers/bookingController.js) (Reservation management), [`backend/src/controllers/paymentController.js`](https://github.com/phanna-m/sky5-hotel/blob/main/backend/src/controllers/paymentController.js) (Payment management), [`backend/src/services/telegramBotService.js`](https://github.com/phanna-m/sky5-hotel/blob/main/backend/src/services/telegramBotService.js) (Telegram bot)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_customer["Guest booking"]
  node_flutter["Customer app"]
end

subgraph group_admin["Admin operations"]
  node_adminapp["Admin dashboard<br/>[App.jsx]"]
  node_adminpages["Admin modules"]
  node_adminapi["Admin API client<br/>[api.js]"]
end

subgraph group_api["REST API"]
  node_server["API server<br/>[server.js]"]
  node_authroutes["Authentication routes<br/>[authRoutes.js]"]
  node_bookingroutes["Booking routes<br/>[bookingRoutes.js]"]
  node_roomroutes["Room routes<br/>[roomRoutes.js]"]
  node_reviewroutes["Review routes<br/>[reviewRoutes.js]"]
  node_otherroutes["Other API routes"]
  node_authcontroller["Authentication<br/>[authController.js]"]
  node_bookingcontroller["Reservation management"]
  node_paymentcontroller["Payment management"]
  node_roomcontroller["Room inventory<br/>[roomController.js]"]
  node_reviewcontroller["Review moderation"]
  node_othercontrollers["Hotel and operations"]
end

subgraph group_services["Booking services"]
  node_bookingservice["Booking rules<br/>[bookingService.js]"]
  node_mockdata[("Sandbox data<br/>[mockData.js]")]
  node_notifications["Notifications"]
  node_paymentsvc["Stripe payment service<br/>[paymentService.js]"]
  node_telegramservice["Telegram bot"]
end

subgraph group_integrations["External systems"]
  node_supabase[("Supabase database<br/>[supabase.js]")]
  node_stripe["Stripe"]
  node_telegram["Telegram"]
end

node_guest(("Hotel guest"))
node_adminuser(("Hotel administrator"))

node_guest -.->|"uses"| node_flutter
node_flutter -.->|"calls API"| node_server
node_adminuser -->|"uses"| node_adminapp
node_adminapp -->|"routes to"| node_adminpages
node_adminpages -.->|"calls"| node_adminapi
node_adminapi -.->|"calls API"| node_server
node_server -->|"mounts"| node_authroutes
node_server -->|"mounts"| node_bookingroutes
node_server -->|"mounts"| node_roomroutes
node_server -->|"mounts"| node_reviewroutes
node_server -->|"mounts"| node_otherroutes
node_authroutes -->|"dispatches"| node_authcontroller
node_bookingroutes -->|"dispatches"| node_bookingcontroller
node_roomroutes -->|"dispatches"| node_roomcontroller
node_reviewroutes -->|"dispatches"| node_reviewcontroller
node_otherroutes -.->|"dispatches"| node_othercontrollers
node_authcontroller -->|"reads and writes"| node_supabase
node_bookingcontroller -->|"reads and writes"| node_supabase
node_roomcontroller -->|"reads and writes"| node_supabase
node_reviewcontroller -->|"reads and writes"| node_supabase
node_bookingcontroller -->|"checks and prices"| node_bookingservice
node_bookingcontroller -->|"uses fallback"| node_mockdata
node_roomcontroller -->|"uses fallback"| node_mockdata
node_paymentcontroller -->|"creates and fulfills"| node_paymentsvc
node_paymentcontroller -->|"uses fallback"| node_mockdata
node_bookingcontroller -->|"creates alerts"| node_notifications
node_paymentcontroller -->|"creates alerts"| node_notifications
node_bookingcontroller -->|"sends alerts"| node_telegramservice
node_paymentcontroller -->|"sends alerts"| node_telegramservice
node_telegramservice -->|"creates alerts"| node_notifications
node_paymentsvc -.->|"creates checkout"| node_stripe
node_server -->|"routes webhook"| node_paymentcontroller
node_telegramservice -->|"sends messages"| node_telegram

click node_flutter "https://github.com/phanna-m/sky5-hotel/tree/main/flutter_app"
click node_adminapp "https://github.com/phanna-m/sky5-hotel/blob/main/admin_dashboard/src/App.jsx"
click node_adminpages "https://github.com/phanna-m/sky5-hotel/tree/main/admin_dashboard/src/pages"
click node_adminapi "https://github.com/phanna-m/sky5-hotel/blob/main/admin_dashboard/src/services/api.js"
click node_server "https://github.com/phanna-m/sky5-hotel/blob/main/backend/server.js"
click node_authroutes "https://github.com/phanna-m/sky5-hotel/blob/main/backend/src/routes/authRoutes.js"
click node_bookingroutes "https://github.com/phanna-m/sky5-hotel/blob/main/backend/src/routes/bookingRoutes.js"
click node_roomroutes "https://github.com/phanna-m/sky5-hotel/blob/main/backend/src/routes/roomRoutes.js"
click node_reviewroutes "https://github.com/phanna-m/sky5-hotel/blob/main/backend/src/routes/reviewRoutes.js"
click node_otherroutes "https://github.com/phanna-m/sky5-hotel/tree/main/backend/src/routes"
click node_authcontroller "https://github.com/phanna-m/sky5-hotel/blob/main/backend/src/controllers/authController.js"
click node_bookingcontroller "https://github.com/phanna-m/sky5-hotel/blob/main/backend/src/controllers/bookingController.js"
click node_paymentcontroller "https://github.com/phanna-m/sky5-hotel/blob/main/backend/src/controllers/paymentController.js"
click node_roomcontroller "https://github.com/phanna-m/sky5-hotel/blob/main/backend/src/controllers/roomController.js"
click node_reviewcontroller "https://github.com/phanna-m/sky5-hotel/blob/main/backend/src/controllers/reviewController.js"
click node_othercontrollers "https://github.com/phanna-m/sky5-hotel/tree/main/backend/src/controllers"
click node_supabase "https://github.com/phanna-m/sky5-hotel/blob/main/backend/src/config/supabase.js"
click node_bookingservice "https://github.com/phanna-m/sky5-hotel/blob/main/backend/src/services/bookingService.js"
click node_mockdata "https://github.com/phanna-m/sky5-hotel/blob/main/backend/src/services/mockData.js"
click node_notifications "https://github.com/phanna-m/sky5-hotel/blob/main/backend/src/services/notificationService.js"
click node_paymentsvc "https://github.com/phanna-m/sky5-hotel/blob/main/backend/src/services/paymentService.js"
click node_telegramservice "https://github.com/phanna-m/sky5-hotel/blob/main/backend/src/services/telegramBotService.js"

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_flutter toneBlue
class node_adminapp,node_adminpages,node_adminapi toneAmber
class node_server,node_authroutes,node_bookingroutes,node_roomroutes,node_reviewroutes,node_otherroutes,node_authcontroller,node_bookingcontroller,node_paymentcontroller,node_roomcontroller,node_reviewcontroller,node_othercontrollers toneMint
class node_bookingservice,node_mockdata,node_notifications,node_paymentsvc,node_telegramservice toneRose
class node_supabase,node_stripe,node_telegram,node_guest,node_adminuser toneIndigo
```

## Components

### Guest booking

- [Customer app](https://github.com/phanna-m/sky5-hotel/tree/main/flutter_app): `flutter_app`

### Admin operations

- [Admin dashboard](https://github.com/phanna-m/sky5-hotel/blob/main/admin_dashboard/src/App.jsx): `admin_dashboard/src/App.jsx`
- [Admin modules](https://github.com/phanna-m/sky5-hotel/tree/main/admin_dashboard/src/pages): `admin_dashboard/src/pages`
- [Admin API client](https://github.com/phanna-m/sky5-hotel/blob/main/admin_dashboard/src/services/api.js): `admin_dashboard/src/services/api.js`

### REST API

- [API server](https://github.com/phanna-m/sky5-hotel/blob/main/backend/server.js): `backend/server.js`
- [Authentication routes](https://github.com/phanna-m/sky5-hotel/blob/main/backend/src/routes/authRoutes.js): `backend/src/routes/authRoutes.js`
- [Booking routes](https://github.com/phanna-m/sky5-hotel/blob/main/backend/src/routes/bookingRoutes.js): `backend/src/routes/bookingRoutes.js`
- [Room routes](https://github.com/phanna-m/sky5-hotel/blob/main/backend/src/routes/roomRoutes.js): `backend/src/routes/roomRoutes.js`
- [Review routes](https://github.com/phanna-m/sky5-hotel/blob/main/backend/src/routes/reviewRoutes.js): `backend/src/routes/reviewRoutes.js`
- [Other API routes](https://github.com/phanna-m/sky5-hotel/tree/main/backend/src/routes): `backend/src/routes`
- [Authentication](https://github.com/phanna-m/sky5-hotel/blob/main/backend/src/controllers/authController.js): `backend/src/controllers/authController.js`
- [Reservation management](https://github.com/phanna-m/sky5-hotel/blob/main/backend/src/controllers/bookingController.js): `backend/src/controllers/bookingController.js`
- [Payment management](https://github.com/phanna-m/sky5-hotel/blob/main/backend/src/controllers/paymentController.js): `backend/src/controllers/paymentController.js`
- [Room inventory](https://github.com/phanna-m/sky5-hotel/blob/main/backend/src/controllers/roomController.js): `backend/src/controllers/roomController.js`
- [Review moderation](https://github.com/phanna-m/sky5-hotel/blob/main/backend/src/controllers/reviewController.js): `backend/src/controllers/reviewController.js`
- [Hotel and operations](https://github.com/phanna-m/sky5-hotel/tree/main/backend/src/controllers): `backend/src/controllers`

### Booking services

- [Booking rules](https://github.com/phanna-m/sky5-hotel/blob/main/backend/src/services/bookingService.js): `backend/src/services/bookingService.js`
- [Sandbox data](https://github.com/phanna-m/sky5-hotel/blob/main/backend/src/services/mockData.js): `backend/src/services/mockData.js`
- [Notifications](https://github.com/phanna-m/sky5-hotel/blob/main/backend/src/services/notificationService.js): `backend/src/services/notificationService.js`
- [Stripe payment service](https://github.com/phanna-m/sky5-hotel/blob/main/backend/src/services/paymentService.js): `backend/src/services/paymentService.js`
- [Telegram bot](https://github.com/phanna-m/sky5-hotel/blob/main/backend/src/services/telegramBotService.js): `backend/src/services/telegramBotService.js`

### External systems

- [Supabase database](https://github.com/phanna-m/sky5-hotel/blob/main/backend/src/config/supabase.js): `backend/src/config/supabase.js`
- **Stripe**
- **Telegram**

### Other components

- **Hotel guest**
- **Hotel administrator**

## Connections

- Hotel guest → Customer app: uses (evidence: `README.md`)
- Customer app → API server: calls API (evidence: `README.md`)
- Hotel administrator → Admin dashboard: uses (evidence: `admin_dashboard/src/App.jsx`)
- Admin dashboard → Admin modules: routes to (evidence: `admin_dashboard/src/App.jsx`)
- Admin modules → Admin API client: calls (evidence: `admin_dashboard/src/pages/ReviewsPage.jsx`)
- Admin API client → API server: calls API (evidence: `README.md`)
- API server → Authentication routes: mounts (evidence: `backend/server.js`)
- API server → Booking routes: mounts (evidence: `backend/server.js`)
- API server → Room routes: mounts (evidence: `backend/server.js`)
- API server → Review routes: mounts (evidence: `backend/server.js`)
- API server → Other API routes: mounts (evidence: `backend/server.js`)
- Authentication routes → Authentication: dispatches (evidence: `backend/src/routes/authRoutes.js`)
- Booking routes → Reservation management: dispatches (evidence: `backend/src/routes/bookingRoutes.js`)
- Room routes → Room inventory: dispatches (evidence: `backend/src/routes/roomRoutes.js`)
- Review routes → Review moderation: dispatches (evidence: `backend/src/routes/reviewRoutes.js`)
- Other API routes → Hotel and operations: dispatches (evidence: `backend/src/routes/reviewRoutes.js`)
- Authentication → Supabase database: reads and writes (evidence: `backend/src/controllers/authController.js`)
- Reservation management → Supabase database: reads and writes (evidence: `backend/src/controllers/bookingController.js`)
- Room inventory → Supabase database: reads and writes (evidence: `backend/src/controllers/roomController.js`)
- Review moderation → Supabase database: reads and writes (evidence: `backend/src/controllers/reviewController.js`)
- Reservation management → Booking rules: checks and prices (evidence: `backend/src/controllers/bookingController.js`)
- Reservation management → Sandbox data: uses fallback (evidence: `backend/src/controllers/bookingController.js`)
- Room inventory → Sandbox data: uses fallback (evidence: `backend/src/controllers/roomController.js`)
- Payment management → Stripe payment service: creates and fulfills (evidence: `backend/src/controllers/paymentController.js`)
- Payment management → Sandbox data: uses fallback (evidence: `backend/src/controllers/paymentController.js`)
- Reservation management → Notifications: creates alerts (evidence: `backend/src/controllers/bookingController.js`)
- Payment management → Notifications: creates alerts (evidence: `backend/src/controllers/paymentController.js`)
- Reservation management → Telegram bot: sends alerts (evidence: `backend/src/controllers/bookingController.js`)
- Payment management → Telegram bot: sends alerts (evidence: `backend/src/controllers/paymentController.js`)
- Telegram bot → Notifications: creates alerts (evidence: `backend/src/services/telegramBotService.js`)
- Stripe payment service → Stripe: creates checkout (evidence: `README.md`)
- API server → Payment management: routes webhook (evidence: `backend/server.js`)
- Telegram bot → Telegram: sends messages (evidence: `backend/src/services/telegramBotService.js`)
