# sinoeun-ny/pos-with-digital-payment-project architecture

> Architecture diagram of the GitHub repository sinoeun-ny/pos-with-digital-payment-project, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-03). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/sinoeun-ny/pos-with-digital-payment-project
- Repository: https://github.com/sinoeun-ny/pos-with-digital-payment-project

## Overview

FoodEats is a food-ordering and delivery backend: customers authenticate, browse merchants and menus, build carts, place orders, and follow delivery; merchant, driver, and admin operations support fulfillment and oversight. The tree also includes settlement and notification capabilities. The README describes an AI Studio/Android app rather than these backend features, and most controllers and integrations were not excerpted, so uncertain wiring is omitted or marked unverified.

Main entry points: [`backend-springboot/src/main/java/com/foodeats/controller/AuthController.java`](https://github.com/sinoeun-ny/pos-with-digital-payment-project/blob/main/backend-springboot/src/main/java/com/foodeats/controller/AuthController.java) (Authentication & profile), [`backend-springboot/src/main/java/com/foodeats/service/impl/OrderServiceImpl.java`](https://github.com/sinoeun-ny/pos-with-digital-payment-project/blob/main/backend-springboot/src/main/java/com/foodeats/service/impl/OrderServiceImpl.java) (Order & checkout), [`backend-springboot/src/main/java/com/foodeats/service/impl/SettlementServiceImpl.java`](https://github.com/sinoeun-ny/pos-with-digital-payment-project/blob/main/backend-springboot/src/main/java/com/foodeats/service/impl/SettlementServiceImpl.java) (Settlement processing), [`backend-springboot/src/main/java/com/foodeats/model/Order.java`](https://github.com/sinoeun-ny/pos-with-digital-payment-project/blob/main/backend-springboot/src/main/java/com/foodeats/model/Order.java) (Orders & statuses)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_identity["Identity &amp; access"]
  node_auth["Authentication &amp; profile"]
  node_jwt["JWT utilities<br/>[JwtUtil.java]"]
  node_user_store[("User records<br/>[User.java]")]
end

subgraph group_catalog["Merchant &amp; catalog"]
  node_merchant_ops["Merchant management"]
  node_menu_ops["Menu &amp; categories"]
  node_catalog_store[("Merchant &amp; menu data")]
end

subgraph group_fulfillment["Ordering &amp; delivery"]
  node_cart_api["Cart endpoints"]
  node_cart_service["Cart operations"]
  node_cart_store[("Cart data<br/>[Cart.java]")]
  node_order_api["Order endpoints"]
  node_order_service["Order &amp; checkout"]
  node_order_store[("Orders &amp; statuses<br/>[Order.java]")]
  node_driver_ops["Driver operations"]
  node_delivery_store[("Delivery records<br/>[Delivery.java]")]
end

subgraph group_operations["Operations"]
  node_admin_ops["Administration"]
  node_notification_ops["Notifications"]
  node_settlement_api["Settlement endpoints"]
  node_settlement_service["Settlement processing"]
  node_settlement_store[("Settlement records<br/>[Settlement.java]")]
end

node_customer(("Customer"))

node_customer -.->|"authenticates"| node_auth
node_auth -->|"generates tokens"| node_jwt
node_auth -->|"reads and writes"| node_user_store
node_customer -.->|"browses catalog"| node_menu_ops
node_customer -.->|"manages cart"| node_cart_api
node_cart_service -->|"loads cart"| node_cart_store
node_cart_api -.->|"delegates to"| node_cart_service
node_customer -.->|"checks out"| node_order_api
node_order_service -->|"persists orders"| node_order_store
node_order_service -->|"reads cart"| node_cart_store
node_order_api -.->|"delegates to"| node_order_service
node_driver_ops -->|"updates fulfillment"| node_order_store
node_driver_ops -->|"manages delivery"| node_delivery_store
node_settlement_service -->|"persists settlements"| node_settlement_store
node_settlement_service -->|"reads orders"| node_order_store
node_settlement_api -.->|"delegates to"| node_settlement_service

click node_auth "https://github.com/sinoeun-ny/pos-with-digital-payment-project/blob/main/backend-springboot/src/main/java/com/foodeats/controller/AuthController.java"
click node_jwt "https://github.com/sinoeun-ny/pos-with-digital-payment-project/blob/main/backend-springboot/src/main/java/com/foodeats/security/JwtUtil.java"
click node_user_store "https://github.com/sinoeun-ny/pos-with-digital-payment-project/blob/main/backend-springboot/src/main/java/com/foodeats/model/User.java"
click node_merchant_ops "https://github.com/sinoeun-ny/pos-with-digital-payment-project/blob/main/backend-springboot/src/main/java/com/foodeats/controller/MerchantController.java"
click node_menu_ops "https://github.com/sinoeun-ny/pos-with-digital-payment-project/blob/main/backend-springboot/src/main/java/com/foodeats/controller/MenuController.java"
click node_catalog_store "https://github.com/sinoeun-ny/pos-with-digital-payment-project/tree/main/backend-springboot/src/main/java/com/foodeats/model"
click node_cart_api "https://github.com/sinoeun-ny/pos-with-digital-payment-project/blob/main/backend-springboot/src/main/java/com/foodeats/controller/CartController.java"
click node_cart_service "https://github.com/sinoeun-ny/pos-with-digital-payment-project/blob/main/backend-springboot/src/main/java/com/foodeats/service/impl/CartServiceImpl.java"
click node_cart_store "https://github.com/sinoeun-ny/pos-with-digital-payment-project/blob/main/backend-springboot/src/main/java/com/foodeats/model/Cart.java"
click node_order_api "https://github.com/sinoeun-ny/pos-with-digital-payment-project/blob/main/backend-springboot/src/main/java/com/foodeats/controller/OrderController.java"
click node_order_service "https://github.com/sinoeun-ny/pos-with-digital-payment-project/blob/main/backend-springboot/src/main/java/com/foodeats/service/impl/OrderServiceImpl.java"
click node_order_store "https://github.com/sinoeun-ny/pos-with-digital-payment-project/blob/main/backend-springboot/src/main/java/com/foodeats/model/Order.java"
click node_driver_ops "https://github.com/sinoeun-ny/pos-with-digital-payment-project/blob/main/backend-springboot/src/main/java/com/foodeats/controller/DriverController.java"
click node_delivery_store "https://github.com/sinoeun-ny/pos-with-digital-payment-project/blob/main/backend-springboot/src/main/java/com/foodeats/model/Delivery.java"
click node_admin_ops "https://github.com/sinoeun-ny/pos-with-digital-payment-project/blob/main/backend-springboot/src/main/java/com/foodeats/controller/AdminController.java"
click node_notification_ops "https://github.com/sinoeun-ny/pos-with-digital-payment-project/blob/main/backend-springboot/src/main/java/com/foodeats/controller/NotificationController.java"
click node_settlement_api "https://github.com/sinoeun-ny/pos-with-digital-payment-project/blob/main/backend-springboot/src/main/java/com/foodeats/controller/SettlementController.java"
click node_settlement_service "https://github.com/sinoeun-ny/pos-with-digital-payment-project/blob/main/backend-springboot/src/main/java/com/foodeats/service/impl/SettlementServiceImpl.java"
click node_settlement_store "https://github.com/sinoeun-ny/pos-with-digital-payment-project/blob/main/backend-springboot/src/main/java/com/foodeats/model/Settlement.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_jwt,node_user_store toneBlue
class node_merchant_ops,node_menu_ops,node_catalog_store toneAmber
class node_cart_api,node_cart_service,node_cart_store,node_order_api,node_order_service,node_order_store,node_driver_ops,node_delivery_store toneMint
class node_admin_ops,node_notification_ops,node_settlement_api,node_settlement_service,node_settlement_store toneRose
class node_customer toneIndigo
```

## Components

### Identity & access

- [Authentication & profile](https://github.com/sinoeun-ny/pos-with-digital-payment-project/blob/main/backend-springboot/src/main/java/com/foodeats/controller/AuthController.java): `backend-springboot/src/main/java/com/foodeats/controller/AuthController.java`
- [JWT utilities](https://github.com/sinoeun-ny/pos-with-digital-payment-project/blob/main/backend-springboot/src/main/java/com/foodeats/security/JwtUtil.java): `backend-springboot/src/main/java/com/foodeats/security/JwtUtil.java`
- [User records](https://github.com/sinoeun-ny/pos-with-digital-payment-project/blob/main/backend-springboot/src/main/java/com/foodeats/model/User.java): `backend-springboot/src/main/java/com/foodeats/model/User.java`

### Merchant & catalog

- [Merchant management](https://github.com/sinoeun-ny/pos-with-digital-payment-project/blob/main/backend-springboot/src/main/java/com/foodeats/controller/MerchantController.java): `backend-springboot/src/main/java/com/foodeats/controller/MerchantController.java`
- [Menu & categories](https://github.com/sinoeun-ny/pos-with-digital-payment-project/blob/main/backend-springboot/src/main/java/com/foodeats/controller/MenuController.java): `backend-springboot/src/main/java/com/foodeats/controller/MenuController.java`
- [Merchant & menu data](https://github.com/sinoeun-ny/pos-with-digital-payment-project/tree/main/backend-springboot/src/main/java/com/foodeats/model): `backend-springboot/src/main/java/com/foodeats/model`

### Ordering & delivery

- [Cart endpoints](https://github.com/sinoeun-ny/pos-with-digital-payment-project/blob/main/backend-springboot/src/main/java/com/foodeats/controller/CartController.java): `backend-springboot/src/main/java/com/foodeats/controller/CartController.java`
- [Cart operations](https://github.com/sinoeun-ny/pos-with-digital-payment-project/blob/main/backend-springboot/src/main/java/com/foodeats/service/impl/CartServiceImpl.java): `backend-springboot/src/main/java/com/foodeats/service/impl/CartServiceImpl.java`
- [Cart data](https://github.com/sinoeun-ny/pos-with-digital-payment-project/blob/main/backend-springboot/src/main/java/com/foodeats/model/Cart.java): `backend-springboot/src/main/java/com/foodeats/model/Cart.java`
- [Order endpoints](https://github.com/sinoeun-ny/pos-with-digital-payment-project/blob/main/backend-springboot/src/main/java/com/foodeats/controller/OrderController.java): `backend-springboot/src/main/java/com/foodeats/controller/OrderController.java`
- [Order & checkout](https://github.com/sinoeun-ny/pos-with-digital-payment-project/blob/main/backend-springboot/src/main/java/com/foodeats/service/impl/OrderServiceImpl.java): `backend-springboot/src/main/java/com/foodeats/service/impl/OrderServiceImpl.java`
- [Orders & statuses](https://github.com/sinoeun-ny/pos-with-digital-payment-project/blob/main/backend-springboot/src/main/java/com/foodeats/model/Order.java): `backend-springboot/src/main/java/com/foodeats/model/Order.java`
- [Driver operations](https://github.com/sinoeun-ny/pos-with-digital-payment-project/blob/main/backend-springboot/src/main/java/com/foodeats/controller/DriverController.java): `backend-springboot/src/main/java/com/foodeats/controller/DriverController.java`
- [Delivery records](https://github.com/sinoeun-ny/pos-with-digital-payment-project/blob/main/backend-springboot/src/main/java/com/foodeats/model/Delivery.java): `backend-springboot/src/main/java/com/foodeats/model/Delivery.java`

### Operations

- [Administration](https://github.com/sinoeun-ny/pos-with-digital-payment-project/blob/main/backend-springboot/src/main/java/com/foodeats/controller/AdminController.java): `backend-springboot/src/main/java/com/foodeats/controller/AdminController.java`
- [Notifications](https://github.com/sinoeun-ny/pos-with-digital-payment-project/blob/main/backend-springboot/src/main/java/com/foodeats/controller/NotificationController.java): `backend-springboot/src/main/java/com/foodeats/controller/NotificationController.java`
- [Settlement endpoints](https://github.com/sinoeun-ny/pos-with-digital-payment-project/blob/main/backend-springboot/src/main/java/com/foodeats/controller/SettlementController.java): `backend-springboot/src/main/java/com/foodeats/controller/SettlementController.java`
- [Settlement processing](https://github.com/sinoeun-ny/pos-with-digital-payment-project/blob/main/backend-springboot/src/main/java/com/foodeats/service/impl/SettlementServiceImpl.java): `backend-springboot/src/main/java/com/foodeats/service/impl/SettlementServiceImpl.java`
- [Settlement records](https://github.com/sinoeun-ny/pos-with-digital-payment-project/blob/main/backend-springboot/src/main/java/com/foodeats/model/Settlement.java): `backend-springboot/src/main/java/com/foodeats/model/Settlement.java`

### Other components

- **Customer**

## Connections

- Customer → Authentication & profile: authenticates
- Authentication & profile → JWT utilities: generates tokens (evidence: `backend-springboot/src/main/java/com/foodeats/controller/AuthController.java`)
- Authentication & profile → User records: reads and writes (evidence: `backend-springboot/src/main/java/com/foodeats/controller/AuthController.java`)
- Customer → Menu & categories: browses catalog
- Customer → Cart endpoints: manages cart
- Cart operations → Cart data: loads cart (evidence: `backend-springboot/src/main/java/com/foodeats/service/impl/CartServiceImpl.java`)
- Cart endpoints → Cart operations: delegates to
- Customer → Order endpoints: checks out
- Order & checkout → Orders & statuses: persists orders (evidence: `backend-springboot/src/main/java/com/foodeats/service/impl/OrderServiceImpl.java`)
- Order & checkout → Cart data: reads cart (evidence: `backend-springboot/src/main/java/com/foodeats/service/impl/OrderServiceImpl.java`)
- Order endpoints → Order & checkout: delegates to
- Driver operations → Orders & statuses: updates fulfillment (evidence: `backend-springboot/src/main/java/com/foodeats/controller/DriverController.java`)
- Driver operations → Delivery records: manages delivery (evidence: `backend-springboot/src/main/java/com/foodeats/controller/DriverController.java`)
- Settlement processing → Settlement records: persists settlements (evidence: `backend-springboot/src/main/java/com/foodeats/service/impl/SettlementServiceImpl.java`)
- Settlement processing → Orders & statuses: reads orders (evidence: `backend-springboot/src/main/java/com/foodeats/service/impl/SettlementServiceImpl.java`)
- Settlement endpoints → Settlement processing: delegates to
