# giangnd99/hotel_management architecture

> Architecture diagram of the GitHub repository giangnd99/hotel_management, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-04). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/giangnd99/hotel_management
- Repository: https://github.com/giangnd99/hotel_management

## Overview

This repository is a hotel-management platform organized as independently named services for gateway/security, bookings, rooms, payments, customers, staff, inventory, restaurant and other hotel operations, plus an AI service. The likely user workflow is to send a request through the gateway to a domain service and receive a result; the tree suggests booking and room operations are distinct stages, but does not establish their runtime wiring. The only directly shown call is file upload from the AI controller to its ingestion port. Most inter-service links and persistence wiring are therefore omitted or marked unverified.

Main entry points: [`api-gateway/authentication-service/authentication-application/src/main/java/com/poly/authentication/service/application/rest/controller/authen/AuthenticationController.java`](https://github.com/giangnd99/hotel_management/blob/main/api-gateway/authentication-service/authentication-application/src/main/java/com/poly/authentication/service/application/rest/controller/authen/AuthenticationController.java) (Auth endpoints), [`api-gateway/authentication-service/authentication-domain/authen-application-service/src/main/java/com/poly/authentication/service/domain/implement/AuthenticationServiceImpl.java`](https://github.com/giangnd99/hotel_management/blob/main/api-gateway/authentication-service/authentication-domain/authen-application-service/src/main/java/com/poly/authentication/service/domain/implement/AuthenticationServiceImpl.java) (Authentication service), [`booking-management/booking-application/src/main/java/com/poly/booking/management/application/controller/rest/BookingController.java`](https://github.com/giangnd99/hotel_management/blob/main/booking-management/booking-application/src/main/java/com/poly/booking/management/application/controller/rest/BookingController.java) (Booking API), [`booking-management/booking-domain/booking-application-service/src/main/java/com/poly/booking/management/domain/service/BookingService.java`](https://github.com/giangnd99/hotel_management/blob/main/booking-management/booking-domain/booking-application-service/src/main/java/com/poly/booking/management/domain/service/BookingService.java) (Booking services)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_gateway["Gateway and auth"]
  node_auth_api["Auth endpoints"]
  node_auth_logic["Authentication service"]
  node_auth_store[("Auth repositories")]
  node_security["Gateway security"]
  node_eureka["Service registry"]
end

subgraph group_hotel["Hotel operations"]
  node_booking_api["Booking API"]
  node_booking_logic["Booking services"]
  node_booking_store[("Booking data")]
  node_room_api["Room endpoints"]
  node_room_queries["Room queries"]
  node_reception_api["Reception endpoints"]
  node_inventory_api["Inventory API"]
  node_restaurant_api["Restaurant orders"]
end

subgraph group_commerce["Commerce services"]
  node_payment_api["Payment endpoints"]
  node_promotion_api["Voucher endpoints"]
end

subgraph group_support["Customer and staff"]
  node_customer_api["Customer endpoints"]
  node_loyalty_logic["Loyalty service"]
  node_staff_api["Staff operations"]
  node_payroll_api["Payroll operations"]
  node_notification["Notifications and QR"]
  node_qr_logic["QR code service<br/>[QrCodeService.java]"]
end

subgraph group_ai["AI and reporting"]
  node_ai_upload["File ingestion API"]
  node_ingestion_port["Ingestion service port"]
  node_embedding["Embedding service"]
  node_embedding_store[("Embedding repository")]
  node_reports["Reports and logs"]
end

node_client(("API client"))

node_client -.->|"requests"| node_auth_api
node_client -.->|"requests"| node_booking_api
node_client -.->|"requests"| node_room_api
node_client -.->|"uploads"| node_ai_upload
node_ai_upload -->|"calls"| node_ingestion_port
node_auth_api -.->|"delegates"| node_auth_logic
node_auth_logic -.->|"persists"| node_auth_store
node_booking_api -.->|"delegates"| node_booking_logic
node_booking_logic -.->|"persists"| node_booking_store
node_room_api -.->|"queries"| node_room_queries
node_ingestion_port -.->|"processes"| node_embedding
node_embedding -.->|"stores embeddings"| node_embedding_store

click node_auth_api "https://github.com/giangnd99/hotel_management/blob/main/api-gateway/authentication-service/authentication-application/src/main/java/com/poly/authentication/service/application/rest/controller/authen/AuthenticationController.java"
click node_auth_logic "https://github.com/giangnd99/hotel_management/blob/main/api-gateway/authentication-service/authentication-domain/authen-application-service/src/main/java/com/poly/authentication/service/domain/implement/AuthenticationServiceImpl.java"
click node_auth_store "https://github.com/giangnd99/hotel_management/tree/main/api-gateway/authentication-service/authentication-data-access/src/main/java/com/poly/authentication/service/dao"
click node_security "https://github.com/giangnd99/hotel_management/blob/main/api-gateway/security/src/main/java/com/poly/security/domain/config/SecurityConfig.java"
click node_booking_api "https://github.com/giangnd99/hotel_management/blob/main/booking-management/booking-application/src/main/java/com/poly/booking/management/application/controller/rest/BookingController.java"
click node_booking_logic "https://github.com/giangnd99/hotel_management/blob/main/booking-management/booking-domain/booking-application-service/src/main/java/com/poly/booking/management/domain/service/BookingService.java"
click node_booking_store "https://github.com/giangnd99/hotel_management/tree/main/booking-management/booking-data-access/src/main/java/com/poly/booking/management/dao/booking"
click node_room_api "https://github.com/giangnd99/hotel_management/blob/main/room-management/room-application/src/main/java/com/poly/room/management/application/controller/rest/RoomController.java"
click node_room_queries "https://github.com/giangnd99/hotel_management/blob/main/room-management/room-domain/room-domain-core/src/main/java/com/poly/room/management/domain/service/impl/RoomQueryServiceImpl.java"
click node_reception_api "https://github.com/giangnd99/hotel_management/blob/main/room-management/room-application/src/main/java/com/poly/room/management/application/controller/rest/ReceptionController.java"
click node_inventory_api "https://github.com/giangnd99/hotel_management/blob/main/inventory-management/inventory-application/src/main/java/com/poly/inventory/controller/TransactionController.java"
click node_restaurant_api "https://github.com/giangnd99/hotel_management/blob/main/restaurant-management/restaurant-application/src/main/java/com/poly/restaurant/controller/OrderController.java"
click node_payment_api "https://github.com/giangnd99/hotel_management/blob/main/payment-management/payment-application/src/main/java/com/poly/payment/management/application/rest/controller/PaymentController.java"
click node_promotion_api "https://github.com/giangnd99/hotel_management/blob/main/promotion-management/promotion-application/src/main/java/com/poly/promotion/application/controller/VoucherController.java"
click node_customer_api "https://github.com/giangnd99/hotel_management/blob/main/customer-management/customer-container/src/main/java/com/poly/customercontainer/controller/CustomerController.java"
click node_loyalty_logic "https://github.com/giangnd99/hotel_management/blob/main/customer-management/customer-application-service/src/main/java/com/poly/customerapplicationservice/service/LoyaltyApplicationService.java"
click node_staff_api "https://github.com/giangnd99/hotel_management/blob/main/staff-management/src/main/java/com/poly/staff/controller/StaffController.java"
click node_payroll_api "https://github.com/giangnd99/hotel_management/blob/main/staff-management/src/main/java/com/poly/staff/controller/PayrollController.java"
click node_notification "https://github.com/giangnd99/hotel_management/blob/main/notification-management/notification-domain/src/main/java/com/poly/notification/management/controller/NotificationController.java"
click node_qr_logic "https://github.com/giangnd99/hotel_management/blob/main/notification-management/notification-domain/src/main/java/com/poly/notification/management/service/QrCodeService.java"
click node_ai_upload "https://github.com/giangnd99/hotel_management/blob/main/spring-ai-management/ai-application/src/main/java/com/poly/ai/management/application/web/rest/FileIngestionController.java"
click node_ingestion_port "https://github.com/giangnd99/hotel_management/blob/main/spring-ai-management/ai-domain/ai-application-service/src/main/java/com/poly/ai/management/domain/port/input/service/DataIngestionService.java"
click node_embedding "https://github.com/giangnd99/hotel_management/blob/main/spring-ai-management/ai-domain/ai-application-service/src/main/java/com/poly/ai/management/domain/service/rag/EmbeddingServiceImpl.java"
click node_embedding_store "https://github.com/giangnd99/hotel_management/blob/main/spring-ai-management/ai-dao/src/main/java/com/poly/ai/management/dao/ai/adapter/EmbeddingRepositoryImpl.java"
click node_reports "https://github.com/giangnd99/hotel_management/blob/main/reporting-management/src/main/java/com/poly/report/controller/ReportController.java"
click node_eureka "https://github.com/giangnd99/hotel_management/blob/main/api-gateway/eureka-server/src/main/java/com/poly/api/gateway/EurekaServerApplication.java"

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_auth_api,node_auth_logic,node_auth_store,node_security,node_eureka,node_client toneBlue
class node_booking_api,node_booking_logic,node_booking_store,node_room_api,node_room_queries,node_reception_api,node_inventory_api,node_restaurant_api toneAmber
class node_payment_api,node_promotion_api toneMint
class node_customer_api,node_loyalty_logic,node_staff_api,node_payroll_api,node_notification,node_qr_logic toneRose
class node_ai_upload,node_ingestion_port,node_embedding,node_embedding_store,node_reports toneIndigo
```

## Components

### Gateway and auth

- [Auth endpoints](https://github.com/giangnd99/hotel_management/blob/main/api-gateway/authentication-service/authentication-application/src/main/java/com/poly/authentication/service/application/rest/controller/authen/AuthenticationController.java): `api-gateway/authentication-service/authentication-application/src/main/java/com/poly/authentication/service/application/rest/controller/authen/AuthenticationController.java`
- [Authentication service](https://github.com/giangnd99/hotel_management/blob/main/api-gateway/authentication-service/authentication-domain/authen-application-service/src/main/java/com/poly/authentication/service/domain/implement/AuthenticationServiceImpl.java): `api-gateway/authentication-service/authentication-domain/authen-application-service/src/main/java/com/poly/authentication/service/domain/implement/AuthenticationServiceImpl.java`
- [Auth repositories](https://github.com/giangnd99/hotel_management/tree/main/api-gateway/authentication-service/authentication-data-access/src/main/java/com/poly/authentication/service/dao): `api-gateway/authentication-service/authentication-data-access/src/main/java/com/poly/authentication/service/dao`
- [Gateway security](https://github.com/giangnd99/hotel_management/blob/main/api-gateway/security/src/main/java/com/poly/security/domain/config/SecurityConfig.java): `api-gateway/security/src/main/java/com/poly/security/domain/config/SecurityConfig.java`
- [Service registry](https://github.com/giangnd99/hotel_management/blob/main/api-gateway/eureka-server/src/main/java/com/poly/api/gateway/EurekaServerApplication.java): `api-gateway/eureka-server/src/main/java/com/poly/api/gateway/EurekaServerApplication.java`

### Hotel operations

- [Booking API](https://github.com/giangnd99/hotel_management/blob/main/booking-management/booking-application/src/main/java/com/poly/booking/management/application/controller/rest/BookingController.java): `booking-management/booking-application/src/main/java/com/poly/booking/management/application/controller/rest/BookingController.java`
- [Booking services](https://github.com/giangnd99/hotel_management/blob/main/booking-management/booking-domain/booking-application-service/src/main/java/com/poly/booking/management/domain/service/BookingService.java): `booking-management/booking-domain/booking-application-service/src/main/java/com/poly/booking/management/domain/service/BookingService.java`
- [Booking data](https://github.com/giangnd99/hotel_management/tree/main/booking-management/booking-data-access/src/main/java/com/poly/booking/management/dao/booking): `booking-management/booking-data-access/src/main/java/com/poly/booking/management/dao/booking`
- [Room endpoints](https://github.com/giangnd99/hotel_management/blob/main/room-management/room-application/src/main/java/com/poly/room/management/application/controller/rest/RoomController.java): `room-management/room-application/src/main/java/com/poly/room/management/application/controller/rest/RoomController.java`
- [Room queries](https://github.com/giangnd99/hotel_management/blob/main/room-management/room-domain/room-domain-core/src/main/java/com/poly/room/management/domain/service/impl/RoomQueryServiceImpl.java): `room-management/room-domain/room-domain-core/src/main/java/com/poly/room/management/domain/service/impl/RoomQueryServiceImpl.java`
- [Reception endpoints](https://github.com/giangnd99/hotel_management/blob/main/room-management/room-application/src/main/java/com/poly/room/management/application/controller/rest/ReceptionController.java): `room-management/room-application/src/main/java/com/poly/room/management/application/controller/rest/ReceptionController.java`
- [Inventory API](https://github.com/giangnd99/hotel_management/blob/main/inventory-management/inventory-application/src/main/java/com/poly/inventory/controller/TransactionController.java): `inventory-management/inventory-application/src/main/java/com/poly/inventory/controller/TransactionController.java`
- [Restaurant orders](https://github.com/giangnd99/hotel_management/blob/main/restaurant-management/restaurant-application/src/main/java/com/poly/restaurant/controller/OrderController.java): `restaurant-management/restaurant-application/src/main/java/com/poly/restaurant/controller/OrderController.java`

### Commerce services

- [Payment endpoints](https://github.com/giangnd99/hotel_management/blob/main/payment-management/payment-application/src/main/java/com/poly/payment/management/application/rest/controller/PaymentController.java): `payment-management/payment-application/src/main/java/com/poly/payment/management/application/rest/controller/PaymentController.java`
- [Voucher endpoints](https://github.com/giangnd99/hotel_management/blob/main/promotion-management/promotion-application/src/main/java/com/poly/promotion/application/controller/VoucherController.java): `promotion-management/promotion-application/src/main/java/com/poly/promotion/application/controller/VoucherController.java`

### Customer and staff

- [Customer endpoints](https://github.com/giangnd99/hotel_management/blob/main/customer-management/customer-container/src/main/java/com/poly/customercontainer/controller/CustomerController.java): `customer-management/customer-container/src/main/java/com/poly/customercontainer/controller/CustomerController.java`
- [Loyalty service](https://github.com/giangnd99/hotel_management/blob/main/customer-management/customer-application-service/src/main/java/com/poly/customerapplicationservice/service/LoyaltyApplicationService.java): `customer-management/customer-application-service/src/main/java/com/poly/customerapplicationservice/service/LoyaltyApplicationService.java`
- [Staff operations](https://github.com/giangnd99/hotel_management/blob/main/staff-management/src/main/java/com/poly/staff/controller/StaffController.java): `staff-management/src/main/java/com/poly/staff/controller/StaffController.java`
- [Payroll operations](https://github.com/giangnd99/hotel_management/blob/main/staff-management/src/main/java/com/poly/staff/controller/PayrollController.java): `staff-management/src/main/java/com/poly/staff/controller/PayrollController.java`
- [Notifications and QR](https://github.com/giangnd99/hotel_management/blob/main/notification-management/notification-domain/src/main/java/com/poly/notification/management/controller/NotificationController.java): `notification-management/notification-domain/src/main/java/com/poly/notification/management/controller/NotificationController.java`
- [QR code service](https://github.com/giangnd99/hotel_management/blob/main/notification-management/notification-domain/src/main/java/com/poly/notification/management/service/QrCodeService.java): `notification-management/notification-domain/src/main/java/com/poly/notification/management/service/QrCodeService.java`

### AI and reporting

- [File ingestion API](https://github.com/giangnd99/hotel_management/blob/main/spring-ai-management/ai-application/src/main/java/com/poly/ai/management/application/web/rest/FileIngestionController.java): `spring-ai-management/ai-application/src/main/java/com/poly/ai/management/application/web/rest/FileIngestionController.java`
- [Ingestion service port](https://github.com/giangnd99/hotel_management/blob/main/spring-ai-management/ai-domain/ai-application-service/src/main/java/com/poly/ai/management/domain/port/input/service/DataIngestionService.java): `spring-ai-management/ai-domain/ai-application-service/src/main/java/com/poly/ai/management/domain/port/input/service/DataIngestionService.java`
- [Embedding service](https://github.com/giangnd99/hotel_management/blob/main/spring-ai-management/ai-domain/ai-application-service/src/main/java/com/poly/ai/management/domain/service/rag/EmbeddingServiceImpl.java): `spring-ai-management/ai-domain/ai-application-service/src/main/java/com/poly/ai/management/domain/service/rag/EmbeddingServiceImpl.java`
- [Embedding repository](https://github.com/giangnd99/hotel_management/blob/main/spring-ai-management/ai-dao/src/main/java/com/poly/ai/management/dao/ai/adapter/EmbeddingRepositoryImpl.java): `spring-ai-management/ai-dao/src/main/java/com/poly/ai/management/dao/ai/adapter/EmbeddingRepositoryImpl.java`
- [Reports and logs](https://github.com/giangnd99/hotel_management/blob/main/reporting-management/src/main/java/com/poly/report/controller/ReportController.java): `reporting-management/src/main/java/com/poly/report/controller/ReportController.java`

### Other components

- **API client**

## Connections

- API client → Auth endpoints: requests
- API client → Booking API: requests
- API client → Room endpoints: requests
- API client → File ingestion API: uploads
- File ingestion API → Ingestion service port: calls (evidence: `spring-ai-management/ai-application/src/main/java/com/poly/ai/management/application/web/rest/FileIngestionController.java`)
- Auth endpoints → Authentication service: delegates
- Authentication service → Auth repositories: persists
- Booking API → Booking services: delegates
- Booking services → Booking data: persists
- Room endpoints → Room queries: queries
- Ingestion service port → Embedding service: processes
- Embedding service → Embedding repository: stores embeddings
