How bangchaoss/nha-hang-huong-viet works
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: ReservationService.java Reservations · OrderService.java Ordering · PaymentService.java Payments · TableService.java Tables and floor plan
Components 19
Identity and staff
- Authentication
backend/src/main/java/com/huongViet/auth/AuthService.java - User accounts
backend/src/main/java/com/huongViet/auth/User.java - Staff management
backend/src/main/java/com/huongViet/account/StaffManagementService.java
Reservations and tables
- Reservations
backend/src/main/java/com/huongViet/reservation/ReservationService.java - Reservation records
backend/src/main/java/com/huongViet/reservation/Reservation.java - Tables and floor plan
backend/src/main/java/com/huongViet/table/TableService.java - Table records
backend/src/main/java/com/huongViet/table/RestaurantTable.java
Menu and service
- Menu management
backend/src/main/java/com/huongViet/menu/MenuItemService.java - Ordering
backend/src/main/java/com/huongViet/order/OrderService.java - Kitchen tickets
backend/src/main/java/com/huongViet/order/KitchenTicketService.java - Customer feedback
backend/src/main/java/com/huongViet/feedback/FeedbackService.java
Checkout and rewards
- Payments
backend/src/main/java/com/huongViet/payment/PaymentService.java - Voucher validation
backend/src/main/java/com/huongViet/voucher/VoucherService.java - Loyalty rewards
backend/src/main/java/com/huongViet/payment/LoyaltyProfileService.java
Management
- Revenue reports
backend/src/main/java/com/huongViet/report/ReportService.java - Image uploads
backend/src/main/java/com/huongViet/upload/ImageStorageService.java
Other components
- Customer
- Restaurant staff
- Cloudinary storage
Connections 23
- Customer → Reservations: requests booking
- Restaurant staff → Reservations: manages booking
- Reservations → Tables and floor plan: assigns tables
backend/src/main/java/com/huongViet/reservation/ReservationService.java - Reservations → Reservation records: reads and writes
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
backend/src/main/java/com/huongViet/order/OrderService.java - Ordering → Kitchen tickets: creates tickets
backend/src/main/java/com/huongViet/order/OrderService.java - Restaurant staff → Kitchen tickets: updates tickets
- Customer → Payments: pays invoice
- Payments → Ordering: uses order service
backend/src/main/java/com/huongViet/payment/PaymentService.java - Payments → Voucher validation: validates voucher
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
backend/src/main/java/com/huongViet/auth/AuthService.java - Authentication → User accounts: reads and writes
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
backend/src/main/java/com/huongViet/upload/ImageStorageService.java - Tables and floor plan → Table records: reads and writes
backend/src/main/java/com/huongViet/table/TableService.java