# vietnguyen203/intern architecture

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

- Interactive diagram: https://gitdiagram.com/vietnguyen203/intern
- Repository: https://github.com/vietnguyen203/intern

## Overview

Food Order System is a restaurant-management product with React web and native Android clients backed by Spring Boot microservices. The main workflow is staff or customer interaction through a client and gateway, with ordering supported by catalog, table, and payment capabilities; payment completion can trigger loyalty points. Other documented service areas include user accounts and notifications. The graph preserves those major branches, but source excerpts are partial: only evidenced client, service, and event relationships are connected, so undocumented gateway routing and several runtime links are left out.

Main entry points: [`BE/order-service/src/main/java/com/vietnl/orderservice/application/usecases/OrderService.java`](https://github.com/vietnguyen203/intern/blob/main/BE/order-service/src/main/java/com/vietnl/orderservice/application/usecases/OrderService.java) (Orders), [`BE/payment-service/src/main/java/com/vietnl/paymentservice/application/usecases/PaymentService.java`](https://github.com/vietnguyen203/intern/blob/main/BE/payment-service/src/main/java/com/vietnl/paymentservice/application/usecases/PaymentService.java) (Payments), [`FE/mobile/app/src/main/java/com/food/order/MainActivity.kt`](https://github.com/vietnguyen203/intern/blob/main/FE/mobile/app/src/main/java/com/food/order/MainActivity.kt) (Android app), [`FE/mobile/app/src/main/java/com/food/order/data/ApiService.kt`](https://github.com/vietnguyen203/intern/blob/main/FE/mobile/app/src/main/java/com/food/order/data/ApiService.kt) (Mobile API client)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_clients["Client apps"]
  node_web["Admin web app<br/>[App.jsx]"]
  node_mobile["Android app<br/>[MainActivity.kt]"]
  node_mobile_api["Mobile API client<br/>[ApiService.kt]"]
  node_catalog_api["Catalog API client"]
end

subgraph group_entry["API entry"]
  node_gateway["API gateway"]
end

subgraph group_restaurant["Restaurant operations"]
  node_orders["Orders<br/>[OrderService.java]"]
  node_catalog["Menu and inventory"]
  node_tables["Tables and reservations"]
  node_reports["Revenue reports<br/>[ReportEngine.java]"]
end

subgraph group_identity["Accounts and rewards"]
  node_users["User accounts<br/>[UserService.java]"]
  node_loyalty_customer["Customer accounts"]
  node_loyalty["Points and rewards"]
end

subgraph group_events["Payments and messaging"]
  node_payment["Payments"]
  node_kafka["Kafka events"]
  node_notification["Push notifications<br/>[FcmService.java]"]
end

node_staff(("Staff and customers"))

node_staff -->|"uses"| node_web
node_staff -->|"uses"| node_mobile
node_mobile -.->|"requests"| node_mobile_api
node_mobile_api -->|"calls gateway"| node_gateway
node_catalog_api -.->|"calls gateway"| node_gateway
node_orders -->|"fetches menu"| node_catalog
node_orders -->|"fetches table"| node_tables
node_orders -->|"notifies"| node_notification
node_payment -->|"reads order"| node_orders
node_payment -->|"publishes event"| node_kafka
node_kafka -->|"delivers payment"| node_loyalty
node_users -.->|"authenticates"| node_staff

click node_web "https://github.com/vietnguyen203/intern/blob/main/FE/web/src/App.jsx"
click node_mobile "https://github.com/vietnguyen203/intern/blob/main/FE/mobile/app/src/main/java/com/food/order/MainActivity.kt"
click node_mobile_api "https://github.com/vietnguyen203/intern/blob/main/FE/mobile/app/src/main/java/com/food/order/data/ApiService.kt"
click node_catalog_api "https://github.com/vietnguyen203/intern/blob/main/FE/mobile/app/src/main/java/com/food/order/data/CatalogApiService.kt"
click node_gateway "https://github.com/vietnguyen203/intern/blob/main/BE/gateway-service/src/main/java/com/vietnl/gatewayservice/GatewayServiceApplication.java"
click node_orders "https://github.com/vietnguyen203/intern/blob/main/BE/order-service/src/main/java/com/vietnl/orderservice/application/usecases/OrderService.java"
click node_catalog "https://github.com/vietnguyen203/intern/blob/main/BE/catalog-service/src/main/java/com/vietnl/catalogservice/application/usecases/InventoryService.java"
click node_tables "https://github.com/vietnguyen203/intern/blob/main/BE/table-service/src/main/java/com/vietnl/tableservice/application/usecases/TableReservationService.java"
click node_users "https://github.com/vietnguyen203/intern/blob/main/BE/users-service/src/main/java/com/vietnl/usersservice/application/usecases/UserService.java"
click node_loyalty_customer "https://github.com/vietnguyen203/intern/blob/main/BE/loyalty-service/src/main/java/com/vietnl/loyaltyservice/application/usecases/CustomerService.java"
click node_loyalty "https://github.com/vietnguyen203/intern/blob/main/BE/loyalty-service/src/main/java/com/vietnl/loyaltyservice/application/usecases/LoyaltyService.java"
click node_payment "https://github.com/vietnguyen203/intern/blob/main/BE/payment-service/src/main/java/com/vietnl/paymentservice/application/usecases/PaymentService.java"
click node_notification "https://github.com/vietnguyen203/intern/blob/main/BE/notification-service/src/main/java/com/vietnl/notificationservice/application/usecases/FcmService.java"
click node_reports "https://github.com/vietnguyen203/intern/blob/main/BE/order-service/src/main/java/com/vietnl/orderservice/application/reports/ReportEngine.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_web,node_mobile,node_mobile_api,node_catalog_api toneBlue
class node_gateway toneAmber
class node_orders,node_catalog,node_tables,node_reports toneMint
class node_users,node_loyalty_customer,node_loyalty toneRose
class node_payment,node_kafka,node_notification,node_staff toneIndigo
```

## Components

### Client apps

- [Admin web app](https://github.com/vietnguyen203/intern/blob/main/FE/web/src/App.jsx): `FE/web/src/App.jsx`
- [Android app](https://github.com/vietnguyen203/intern/blob/main/FE/mobile/app/src/main/java/com/food/order/MainActivity.kt): `FE/mobile/app/src/main/java/com/food/order/MainActivity.kt`
- [Mobile API client](https://github.com/vietnguyen203/intern/blob/main/FE/mobile/app/src/main/java/com/food/order/data/ApiService.kt): `FE/mobile/app/src/main/java/com/food/order/data/ApiService.kt`
- [Catalog API client](https://github.com/vietnguyen203/intern/blob/main/FE/mobile/app/src/main/java/com/food/order/data/CatalogApiService.kt): `FE/mobile/app/src/main/java/com/food/order/data/CatalogApiService.kt`

### API entry

- [API gateway](https://github.com/vietnguyen203/intern/blob/main/BE/gateway-service/src/main/java/com/vietnl/gatewayservice/GatewayServiceApplication.java): `BE/gateway-service/src/main/java/com/vietnl/gatewayservice/GatewayServiceApplication.java`

### Restaurant operations

- [Orders](https://github.com/vietnguyen203/intern/blob/main/BE/order-service/src/main/java/com/vietnl/orderservice/application/usecases/OrderService.java): `BE/order-service/src/main/java/com/vietnl/orderservice/application/usecases/OrderService.java`
- [Menu and inventory](https://github.com/vietnguyen203/intern/blob/main/BE/catalog-service/src/main/java/com/vietnl/catalogservice/application/usecases/InventoryService.java): `BE/catalog-service/src/main/java/com/vietnl/catalogservice/application/usecases/InventoryService.java`
- [Tables and reservations](https://github.com/vietnguyen203/intern/blob/main/BE/table-service/src/main/java/com/vietnl/tableservice/application/usecases/TableReservationService.java): `BE/table-service/src/main/java/com/vietnl/tableservice/application/usecases/TableReservationService.java`
- [Revenue reports](https://github.com/vietnguyen203/intern/blob/main/BE/order-service/src/main/java/com/vietnl/orderservice/application/reports/ReportEngine.java): `BE/order-service/src/main/java/com/vietnl/orderservice/application/reports/ReportEngine.java`

### Accounts and rewards

- [User accounts](https://github.com/vietnguyen203/intern/blob/main/BE/users-service/src/main/java/com/vietnl/usersservice/application/usecases/UserService.java): `BE/users-service/src/main/java/com/vietnl/usersservice/application/usecases/UserService.java`
- [Customer accounts](https://github.com/vietnguyen203/intern/blob/main/BE/loyalty-service/src/main/java/com/vietnl/loyaltyservice/application/usecases/CustomerService.java): `BE/loyalty-service/src/main/java/com/vietnl/loyaltyservice/application/usecases/CustomerService.java`
- [Points and rewards](https://github.com/vietnguyen203/intern/blob/main/BE/loyalty-service/src/main/java/com/vietnl/loyaltyservice/application/usecases/LoyaltyService.java): `BE/loyalty-service/src/main/java/com/vietnl/loyaltyservice/application/usecases/LoyaltyService.java`

### Payments and messaging

- [Payments](https://github.com/vietnguyen203/intern/blob/main/BE/payment-service/src/main/java/com/vietnl/paymentservice/application/usecases/PaymentService.java): `BE/payment-service/src/main/java/com/vietnl/paymentservice/application/usecases/PaymentService.java`
- **Kafka events**
- [Push notifications](https://github.com/vietnguyen203/intern/blob/main/BE/notification-service/src/main/java/com/vietnl/notificationservice/application/usecases/FcmService.java): `BE/notification-service/src/main/java/com/vietnl/notificationservice/application/usecases/FcmService.java`

### Other components

- **Staff and customers**

## Connections

- Staff and customers → Admin web app: uses
- Staff and customers → Android app: uses
- Android app → Mobile API client: requests
- Mobile API client → API gateway: calls gateway
- Catalog API client → API gateway: calls gateway
- Orders → Menu and inventory: fetches menu (evidence: `BE/order-service/src/main/java/com/vietnl/orderservice/application/usecases/OrderService.java`)
- Orders → Tables and reservations: fetches table (evidence: `BE/order-service/src/main/java/com/vietnl/orderservice/application/usecases/OrderService.java`)
- Orders → Push notifications: notifies (evidence: `BE/order-service/src/main/java/com/vietnl/orderservice/application/usecases/OrderService.java`)
- Payments → Orders: reads order (evidence: `BE/payment-service/src/main/java/com/vietnl/paymentservice/application/usecases/PaymentService.java`)
- Payments → Kafka events: publishes event (evidence: `BE/payment-service/src/main/java/com/vietnl/paymentservice/application/usecases/PaymentService.java`)
- Kafka events → Points and rewards: delivers payment (evidence: `BE/loyalty-service/src/main/java/com/vietnl/loyaltyservice/application/usecases/LoyaltyService.java`)
- User accounts → Staff and customers: authenticates
