# bangchaoss/nha-hang-huong-viet architecture

> Architecture diagram of the GitHub repository bangchaoss/nha-hang-huong-viet, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-16). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/bangchaoss/nha-hang-huong-viet
- Repository: https://github.com/bangchaoss/nha-hang-huong-viet

## Overview

Nhà Hàng Hương Việt is a restaurant-management application with a React frontend, Spring Boot backend, and MySQL persistence. Its customer and staff workflows cover reservations, menus, table orders, kitchen preparation, checkout, and loyalty; management also includes staff, floor-plan, voucher, feedback, and revenue-report capabilities. The README documents the product flows, while sampled service code confirms selected backend calls. Many controllers, frontend integrations, and WebSocket paths were not sampled, so their links are omitted rather than inferred.

Main entry points: [`backend/src/main/java/com/huongViet/reservation/ReservationService.java`](https://github.com/bangchaoss/nha-hang-huong-viet/blob/main/backend/src/main/java/com/huongViet/reservation/ReservationService.java) (Reservations), [`backend/src/main/java/com/huongViet/order/OrderService.java`](https://github.com/bangchaoss/nha-hang-huong-viet/blob/main/backend/src/main/java/com/huongViet/order/OrderService.java) (Ordering), [`backend/src/main/java/com/huongViet/payment/PaymentService.java`](https://github.com/bangchaoss/nha-hang-huong-viet/blob/main/backend/src/main/java/com/huongViet/payment/PaymentService.java) (Payments), [`backend/src/main/java/com/huongViet/table/TableService.java`](https://github.com/bangchaoss/nha-hang-huong-viet/blob/main/backend/src/main/java/com/huongViet/table/TableService.java) (Tables and floor plan)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_identity["Identity and staff"]
  node_auth["Authentication<br/>[AuthService.java]"]
  node_users[("User accounts<br/>[User.java]")]
  node_staffmgmt["Staff management"]
end

subgraph group_dining["Reservations and tables"]
  node_reservation["Reservations"]
  node_reservationdata[("Reservation records<br/>[Reservation.java]")]
  node_tables["Tables and floor plan<br/>[TableService.java]"]
  node_tabledata[("Table records")]
end

subgraph group_service["Menu and service"]
  node_menu["Menu management"]
  node_orders["Ordering<br/>[OrderService.java]"]
  node_kitchen["Kitchen tickets"]
  node_feedback["Customer feedback"]
end

subgraph group_money["Checkout and rewards"]
  node_checkout["Payments"]
  node_vouchers["Voucher validation"]
  node_loyalty["Loyalty rewards"]
end

subgraph group_management["Management"]
  node_reports["Revenue reports<br/>[ReportService.java]"]
  node_uploads["Image uploads"]
end

node_customer(("Customer"))
node_staff(("Restaurant staff"))
node_cloudinary[("Cloudinary storage")]

node_customer -->|"requests booking"| node_reservation
node_staff -->|"manages booking"| node_reservation
node_reservation -->|"assigns tables"| node_tables
node_reservation -->|"reads and writes"| node_reservationdata
node_staff -->|"manages layout"| node_tables
node_staff -->|"manages menu"| node_menu
node_customer -->|"browses menu"| node_menu
node_staff -->|"places orders"| node_orders
node_orders -->|"checks availability"| node_menu
node_orders -->|"creates tickets"| node_kitchen
node_staff -->|"updates tickets"| node_kitchen
node_customer -->|"pays invoice"| node_checkout
node_checkout -->|"uses order service"| node_orders
node_checkout -->|"validates voucher"| node_vouchers
node_customer -->|"earns points"| node_loyalty
node_customer -->|"submits feedback"| node_feedback
node_staff -->|"views revenue"| node_reports
node_customer -->|"registers or logs in"| node_auth
node_auth -->|"reads and writes"| node_users
node_staff -->|"manages accounts"| node_staffmgmt
node_staff -.->|"uploads images"| node_uploads
node_uploads -->|"uploads or deletes"| node_cloudinary
node_tables -->|"reads and writes"| node_tabledata

click node_auth "https://github.com/bangchaoss/nha-hang-huong-viet/blob/main/backend/src/main/java/com/huongViet/auth/AuthService.java"
click node_users "https://github.com/bangchaoss/nha-hang-huong-viet/blob/main/backend/src/main/java/com/huongViet/auth/User.java"
click node_staffmgmt "https://github.com/bangchaoss/nha-hang-huong-viet/blob/main/backend/src/main/java/com/huongViet/account/StaffManagementService.java"
click node_reservation "https://github.com/bangchaoss/nha-hang-huong-viet/blob/main/backend/src/main/java/com/huongViet/reservation/ReservationService.java"
click node_reservationdata "https://github.com/bangchaoss/nha-hang-huong-viet/blob/main/backend/src/main/java/com/huongViet/reservation/Reservation.java"
click node_tables "https://github.com/bangchaoss/nha-hang-huong-viet/blob/main/backend/src/main/java/com/huongViet/table/TableService.java"
click node_tabledata "https://github.com/bangchaoss/nha-hang-huong-viet/blob/main/backend/src/main/java/com/huongViet/table/RestaurantTable.java"
click node_menu "https://github.com/bangchaoss/nha-hang-huong-viet/blob/main/backend/src/main/java/com/huongViet/menu/MenuItemService.java"
click node_orders "https://github.com/bangchaoss/nha-hang-huong-viet/blob/main/backend/src/main/java/com/huongViet/order/OrderService.java"
click node_kitchen "https://github.com/bangchaoss/nha-hang-huong-viet/blob/main/backend/src/main/java/com/huongViet/order/KitchenTicketService.java"
click node_feedback "https://github.com/bangchaoss/nha-hang-huong-viet/blob/main/backend/src/main/java/com/huongViet/feedback/FeedbackService.java"
click node_checkout "https://github.com/bangchaoss/nha-hang-huong-viet/blob/main/backend/src/main/java/com/huongViet/payment/PaymentService.java"
click node_vouchers "https://github.com/bangchaoss/nha-hang-huong-viet/blob/main/backend/src/main/java/com/huongViet/voucher/VoucherService.java"
click node_loyalty "https://github.com/bangchaoss/nha-hang-huong-viet/blob/main/backend/src/main/java/com/huongViet/payment/LoyaltyProfileService.java"
click node_reports "https://github.com/bangchaoss/nha-hang-huong-viet/blob/main/backend/src/main/java/com/huongViet/report/ReportService.java"
click node_uploads "https://github.com/bangchaoss/nha-hang-huong-viet/blob/main/backend/src/main/java/com/huongViet/upload/ImageStorageService.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,node_users,node_staffmgmt toneBlue
class node_reservation,node_reservationdata,node_tables,node_tabledata,node_cloudinary toneAmber
class node_menu,node_orders,node_kitchen,node_feedback toneMint
class node_checkout,node_vouchers,node_loyalty toneRose
class node_reports,node_uploads,node_customer,node_staff toneIndigo
```

## Components

### Identity and staff

- [Authentication](https://github.com/bangchaoss/nha-hang-huong-viet/blob/main/backend/src/main/java/com/huongViet/auth/AuthService.java): `backend/src/main/java/com/huongViet/auth/AuthService.java`
- [User accounts](https://github.com/bangchaoss/nha-hang-huong-viet/blob/main/backend/src/main/java/com/huongViet/auth/User.java): `backend/src/main/java/com/huongViet/auth/User.java`
- [Staff management](https://github.com/bangchaoss/nha-hang-huong-viet/blob/main/backend/src/main/java/com/huongViet/account/StaffManagementService.java): `backend/src/main/java/com/huongViet/account/StaffManagementService.java`

### Reservations and tables

- [Reservations](https://github.com/bangchaoss/nha-hang-huong-viet/blob/main/backend/src/main/java/com/huongViet/reservation/ReservationService.java): `backend/src/main/java/com/huongViet/reservation/ReservationService.java`
- [Reservation records](https://github.com/bangchaoss/nha-hang-huong-viet/blob/main/backend/src/main/java/com/huongViet/reservation/Reservation.java): `backend/src/main/java/com/huongViet/reservation/Reservation.java`
- [Tables and floor plan](https://github.com/bangchaoss/nha-hang-huong-viet/blob/main/backend/src/main/java/com/huongViet/table/TableService.java): `backend/src/main/java/com/huongViet/table/TableService.java`
- [Table records](https://github.com/bangchaoss/nha-hang-huong-viet/blob/main/backend/src/main/java/com/huongViet/table/RestaurantTable.java): `backend/src/main/java/com/huongViet/table/RestaurantTable.java`

### Menu and service

- [Menu management](https://github.com/bangchaoss/nha-hang-huong-viet/blob/main/backend/src/main/java/com/huongViet/menu/MenuItemService.java): `backend/src/main/java/com/huongViet/menu/MenuItemService.java`
- [Ordering](https://github.com/bangchaoss/nha-hang-huong-viet/blob/main/backend/src/main/java/com/huongViet/order/OrderService.java): `backend/src/main/java/com/huongViet/order/OrderService.java`
- [Kitchen tickets](https://github.com/bangchaoss/nha-hang-huong-viet/blob/main/backend/src/main/java/com/huongViet/order/KitchenTicketService.java): `backend/src/main/java/com/huongViet/order/KitchenTicketService.java`
- [Customer feedback](https://github.com/bangchaoss/nha-hang-huong-viet/blob/main/backend/src/main/java/com/huongViet/feedback/FeedbackService.java): `backend/src/main/java/com/huongViet/feedback/FeedbackService.java`

### Checkout and rewards

- [Payments](https://github.com/bangchaoss/nha-hang-huong-viet/blob/main/backend/src/main/java/com/huongViet/payment/PaymentService.java): `backend/src/main/java/com/huongViet/payment/PaymentService.java`
- [Voucher validation](https://github.com/bangchaoss/nha-hang-huong-viet/blob/main/backend/src/main/java/com/huongViet/voucher/VoucherService.java): `backend/src/main/java/com/huongViet/voucher/VoucherService.java`
- [Loyalty rewards](https://github.com/bangchaoss/nha-hang-huong-viet/blob/main/backend/src/main/java/com/huongViet/payment/LoyaltyProfileService.java): `backend/src/main/java/com/huongViet/payment/LoyaltyProfileService.java`

### Management

- [Revenue reports](https://github.com/bangchaoss/nha-hang-huong-viet/blob/main/backend/src/main/java/com/huongViet/report/ReportService.java): `backend/src/main/java/com/huongViet/report/ReportService.java`
- [Image uploads](https://github.com/bangchaoss/nha-hang-huong-viet/blob/main/backend/src/main/java/com/huongViet/upload/ImageStorageService.java): `backend/src/main/java/com/huongViet/upload/ImageStorageService.java`

### Other components

- **Customer**
- **Restaurant staff**
- **Cloudinary storage**

## Connections

- Customer → Reservations: requests booking
- Restaurant staff → Reservations: manages booking
- Reservations → Tables and floor plan: assigns tables (evidence: `backend/src/main/java/com/huongViet/reservation/ReservationService.java`)
- Reservations → Reservation records: reads and writes (evidence: `backend/src/main/java/com/huongViet/reservation/ReservationService.java`)
- Restaurant staff → Tables and floor plan: manages layout
- Restaurant staff → Menu management: manages menu
- Customer → Menu management: browses menu
- Restaurant staff → Ordering: places orders
- Ordering → Menu management: checks availability (evidence: `backend/src/main/java/com/huongViet/order/OrderService.java`)
- Ordering → Kitchen tickets: creates tickets (evidence: `backend/src/main/java/com/huongViet/order/OrderService.java`)
- Restaurant staff → Kitchen tickets: updates tickets
- Customer → Payments: pays invoice
- Payments → Ordering: uses order service (evidence: `backend/src/main/java/com/huongViet/payment/PaymentService.java`)
- Payments → Voucher validation: validates voucher (evidence: `backend/src/main/java/com/huongViet/payment/PaymentService.java`)
- Customer → Loyalty rewards: earns points
- Customer → Customer feedback: submits feedback
- Restaurant staff → Revenue reports: views revenue
- Customer → Authentication: registers or logs in (evidence: `backend/src/main/java/com/huongViet/auth/AuthService.java`)
- Authentication → User accounts: reads and writes (evidence: `backend/src/main/java/com/huongViet/auth/AuthService.java`)
- Restaurant staff → Staff management: manages accounts
- Restaurant staff → Image uploads: uploads images
- Image uploads → Cloudinary storage: uploads or deletes (evidence: `backend/src/main/java/com/huongViet/upload/ImageStorageService.java`)
- Tables and floor plan → Table records: reads and writes (evidence: `backend/src/main/java/com/huongViet/table/TableService.java`)
