# sovannarahong/coffee-shop-backend architecture

> Architecture diagram of the GitHub repository sovannarahong/coffee-shop-backend, 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/sovannarahong/coffee-shop-backend
- Repository: https://github.com/sovannarahong/coffee-shop-backend

## Overview

This is a Spring coffee-shop backend exposing staff and customer APIs for catalog, ordering, payments, inventory, and administration. The main customer flow is API request to domain service, then persistence or payment processing, with a response; the sampled review flow specifically checks completed purchases before accepting a review. The tree also shows authentication, purchasing, inventory, and notification subsystems. No README was supplied, so relationships beyond the sampled controller/service code are omitted or marked unverified.

Main entry points: [`src/main/java/com/coffee_shop/coffee_shop/controller`](https://github.com/sovannarahong/coffee-shop-backend/tree/main/src/main/java/com/coffee_shop/coffee_shop/controller) (REST controllers), [`src/main/java/com/coffee_shop/coffee_shop/service/serviceimpl/ReviewServiceImpl.java`](https://github.com/sovannarahong/coffee-shop-backend/blob/main/src/main/java/com/coffee_shop/coffee_shop/service/serviceimpl/ReviewServiceImpl.java) (Review workflow), [`src/main/java/com/coffee_shop/coffee_shop/repository`](https://github.com/sovannarahong/coffee-shop-backend/tree/main/src/main/java/com/coffee_shop/coffee_shop/repository) (Application database), [`src/main/java/com/coffee_shop/coffee_shop/service`](https://github.com/sovannarahong/coffee-shop-backend/tree/main/src/main/java/com/coffee_shop/coffee_shop/service) (Order management)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["API surface"]
  node_controllers["REST controllers"]
  node_review_api["Review endpoints"]
end

subgraph group_commerce["Customer commerce"]
  node_review["Review workflow"]
  node_review_store[("Review persistence")]
  node_orders["Order management"]
  node_catalog["Product catalog"]
  node_payments["Payment processing"]
  node_rating["Rating summary"]
end

subgraph group_operations["Staff operations"]
  node_inventory["Ingredients and stock"]
  node_purchasing["Supplier purchasing"]
  node_staff["Staff administration<br/>[UserService.java]"]
  node_database[("Application database")]
end

subgraph group_security["Identity and access"]
  node_identity["Authentication"]
  node_customer_accounts["Customer accounts"]
  node_audit["Audit logging"]
end

subgraph group_integrations["External integrations"]
  node_cutluy["CutLuy gateway client<br/>[CutLuyClient.java]"]
  node_payment_provider["CutLuy service"]
  node_telegram["Telegram notifications"]
  node_s3["Image storage<br/>[S3ServiceImpl.java]"]
end

node_customer(("Customer / staff"))

node_customer -->|"submits requests"| node_review_api
node_review_api -->|"calls service"| node_review
node_review -->|"reads and writes"| node_review_store
node_review -.->|"checks purchase"| node_orders
node_review -->|"builds summary"| node_rating
node_customer -.->|"uses API"| node_controllers
node_controllers -.->|"dispatches requests"| node_catalog
node_controllers -.->|"dispatches requests"| node_orders
node_controllers -.->|"dispatches requests"| node_payments
node_controllers -.->|"dispatches requests"| node_inventory
node_controllers -.->|"dispatches requests"| node_purchasing
node_controllers -.->|"dispatches requests"| node_staff
node_controllers -.->|"dispatches requests"| node_customer_accounts
node_controllers -.->|"dispatches requests"| node_audit
node_identity -.->|"authenticates staff"| node_staff
node_payments -.->|"requests payment"| node_cutluy
node_cutluy -.->|"calls gateway"| node_payment_provider
node_catalog -.->|"uploads images"| node_s3
node_orders -.->|"sends notifications"| node_telegram
node_review_store -.->|"persists reviews"| node_database
node_staff -.->|"persists staff data"| node_database
node_inventory -.->|"persists stock"| node_database
node_purchasing -.->|"persists purchases"| node_database

click node_controllers "https://github.com/sovannarahong/coffee-shop-backend/tree/main/src/main/java/com/coffee_shop/coffee_shop/controller"
click node_review "https://github.com/sovannarahong/coffee-shop-backend/blob/main/src/main/java/com/coffee_shop/coffee_shop/service/serviceimpl/ReviewServiceImpl.java"
click node_review_api "https://github.com/sovannarahong/coffee-shop-backend/blob/main/src/main/java/com/coffee_shop/coffee_shop/controller/ReviewController.java"
click node_review_store "https://github.com/sovannarahong/coffee-shop-backend/blob/main/src/main/java/com/coffee_shop/coffee_shop/repository/ReviewRepository.java"
click node_orders "https://github.com/sovannarahong/coffee-shop-backend/tree/main/src/main/java/com/coffee_shop/coffee_shop/service"
click node_catalog "https://github.com/sovannarahong/coffee-shop-backend/tree/main/src/main/java/com/coffee_shop/coffee_shop/service"
click node_payments "https://github.com/sovannarahong/coffee-shop-backend/tree/main/src/main/java/com/coffee_shop/coffee_shop/service"
click node_cutluy "https://github.com/sovannarahong/coffee-shop-backend/blob/main/src/main/java/com/coffee_shop/coffee_shop/client/CutLuyClient.java"
click node_inventory "https://github.com/sovannarahong/coffee-shop-backend/blob/main/src/main/java/com/coffee_shop/coffee_shop/service/IngredientService.java"
click node_purchasing "https://github.com/sovannarahong/coffee-shop-backend/tree/main/src/main/java/com/coffee_shop/coffee_shop/service"
click node_staff "https://github.com/sovannarahong/coffee-shop-backend/blob/main/src/main/java/com/coffee_shop/coffee_shop/service/UserService.java"
click node_identity "https://github.com/sovannarahong/coffee-shop-backend/tree/main/src/main/java/com/coffee_shop/coffee_shop/security"
click node_customer_accounts "https://github.com/sovannarahong/coffee-shop-backend/tree/main/src/main/java/com/coffee_shop/coffee_shop/service"
click node_audit "https://github.com/sovannarahong/coffee-shop-backend/tree/main/src/main/java/com/coffee_shop/coffee_shop/service"
click node_telegram "https://github.com/sovannarahong/coffee-shop-backend/blob/main/src/main/java/com/coffee_shop/coffee_shop/service/serviceimpl/TelegramNotificationServiceImpl.java"
click node_s3 "https://github.com/sovannarahong/coffee-shop-backend/blob/main/src/main/java/com/coffee_shop/coffee_shop/service/serviceimpl/S3ServiceImpl.java"
click node_database "https://github.com/sovannarahong/coffee-shop-backend/tree/main/src/main/java/com/coffee_shop/coffee_shop/repository"
click node_rating "https://github.com/sovannarahong/coffee-shop-backend/blob/main/src/main/java/com/coffee_shop/coffee_shop/dto/response/ProductRatingSummaryResponse.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_controllers,node_review_api toneBlue
class node_review,node_review_store,node_orders,node_catalog,node_payments,node_rating toneAmber
class node_inventory,node_purchasing,node_staff,node_database toneMint
class node_identity,node_customer_accounts,node_audit toneRose
class node_cutluy,node_payment_provider,node_telegram,node_s3,node_customer toneIndigo
```

## Components

### API surface

- [REST controllers](https://github.com/sovannarahong/coffee-shop-backend/tree/main/src/main/java/com/coffee_shop/coffee_shop/controller): `src/main/java/com/coffee_shop/coffee_shop/controller`
- [Review endpoints](https://github.com/sovannarahong/coffee-shop-backend/blob/main/src/main/java/com/coffee_shop/coffee_shop/controller/ReviewController.java): `src/main/java/com/coffee_shop/coffee_shop/controller/ReviewController.java`

### Customer commerce

- [Review workflow](https://github.com/sovannarahong/coffee-shop-backend/blob/main/src/main/java/com/coffee_shop/coffee_shop/service/serviceimpl/ReviewServiceImpl.java): `src/main/java/com/coffee_shop/coffee_shop/service/serviceimpl/ReviewServiceImpl.java`
- [Review persistence](https://github.com/sovannarahong/coffee-shop-backend/blob/main/src/main/java/com/coffee_shop/coffee_shop/repository/ReviewRepository.java): `src/main/java/com/coffee_shop/coffee_shop/repository/ReviewRepository.java`
- [Order management](https://github.com/sovannarahong/coffee-shop-backend/tree/main/src/main/java/com/coffee_shop/coffee_shop/service): `src/main/java/com/coffee_shop/coffee_shop/service`
- [Product catalog](https://github.com/sovannarahong/coffee-shop-backend/tree/main/src/main/java/com/coffee_shop/coffee_shop/service): `src/main/java/com/coffee_shop/coffee_shop/service`
- [Payment processing](https://github.com/sovannarahong/coffee-shop-backend/tree/main/src/main/java/com/coffee_shop/coffee_shop/service): `src/main/java/com/coffee_shop/coffee_shop/service`
- [Rating summary](https://github.com/sovannarahong/coffee-shop-backend/blob/main/src/main/java/com/coffee_shop/coffee_shop/dto/response/ProductRatingSummaryResponse.java): `src/main/java/com/coffee_shop/coffee_shop/dto/response/ProductRatingSummaryResponse.java`

### Staff operations

- [Ingredients and stock](https://github.com/sovannarahong/coffee-shop-backend/blob/main/src/main/java/com/coffee_shop/coffee_shop/service/IngredientService.java): `src/main/java/com/coffee_shop/coffee_shop/service/IngredientService.java`
- [Supplier purchasing](https://github.com/sovannarahong/coffee-shop-backend/tree/main/src/main/java/com/coffee_shop/coffee_shop/service): `src/main/java/com/coffee_shop/coffee_shop/service`
- [Staff administration](https://github.com/sovannarahong/coffee-shop-backend/blob/main/src/main/java/com/coffee_shop/coffee_shop/service/UserService.java): `src/main/java/com/coffee_shop/coffee_shop/service/UserService.java`
- [Application database](https://github.com/sovannarahong/coffee-shop-backend/tree/main/src/main/java/com/coffee_shop/coffee_shop/repository): `src/main/java/com/coffee_shop/coffee_shop/repository`

### Identity and access

- [Authentication](https://github.com/sovannarahong/coffee-shop-backend/tree/main/src/main/java/com/coffee_shop/coffee_shop/security): `src/main/java/com/coffee_shop/coffee_shop/security`
- [Customer accounts](https://github.com/sovannarahong/coffee-shop-backend/tree/main/src/main/java/com/coffee_shop/coffee_shop/service): `src/main/java/com/coffee_shop/coffee_shop/service`
- [Audit logging](https://github.com/sovannarahong/coffee-shop-backend/tree/main/src/main/java/com/coffee_shop/coffee_shop/service): `src/main/java/com/coffee_shop/coffee_shop/service`

### External integrations

- [CutLuy gateway client](https://github.com/sovannarahong/coffee-shop-backend/blob/main/src/main/java/com/coffee_shop/coffee_shop/client/CutLuyClient.java): `src/main/java/com/coffee_shop/coffee_shop/client/CutLuyClient.java`
- **CutLuy service**
- [Telegram notifications](https://github.com/sovannarahong/coffee-shop-backend/blob/main/src/main/java/com/coffee_shop/coffee_shop/service/serviceimpl/TelegramNotificationServiceImpl.java): `src/main/java/com/coffee_shop/coffee_shop/service/serviceimpl/TelegramNotificationServiceImpl.java`
- [Image storage](https://github.com/sovannarahong/coffee-shop-backend/blob/main/src/main/java/com/coffee_shop/coffee_shop/service/serviceimpl/S3ServiceImpl.java): `src/main/java/com/coffee_shop/coffee_shop/service/serviceimpl/S3ServiceImpl.java`

### Other components

- **Customer / staff**

## Connections

- Customer / staff → Review endpoints: submits requests (evidence: `src/main/java/com/coffee_shop/coffee_shop/controller/ReviewController.java`)
- Review endpoints → Review workflow: calls service (evidence: `src/main/java/com/coffee_shop/coffee_shop/controller/ReviewController.java`)
- Review workflow → Review persistence: reads and writes (evidence: `src/main/java/com/coffee_shop/coffee_shop/service/serviceimpl/ReviewServiceImpl.java`)
- Review workflow → Order management: checks purchase (evidence: `src/main/java/com/coffee_shop/coffee_shop/service/serviceimpl/ReviewServiceImpl.java`)
- Review workflow → Rating summary: builds summary (evidence: `src/main/java/com/coffee_shop/coffee_shop/service/serviceimpl/ReviewServiceImpl.java`)
- Customer / staff → REST controllers: uses API
- REST controllers → Product catalog: dispatches requests (evidence: `src/main/java/com/coffee_shop/coffee_shop/controller/ReviewController.java`)
- REST controllers → Order management: dispatches requests (evidence: `src/main/java/com/coffee_shop/coffee_shop/controller/ReviewController.java`)
- REST controllers → Payment processing: dispatches requests (evidence: `src/main/java/com/coffee_shop/coffee_shop/controller/ReviewController.java`)
- REST controllers → Ingredients and stock: dispatches requests (evidence: `src/main/java/com/coffee_shop/coffee_shop/controller/IngredientController.java`)
- REST controllers → Supplier purchasing: dispatches requests (evidence: `src/main/java/com/coffee_shop/coffee_shop/controller/ReviewController.java`)
- REST controllers → Staff administration: dispatches requests
- REST controllers → Customer accounts: dispatches requests (evidence: `src/main/java/com/coffee_shop/coffee_shop/controller/ReviewController.java`)
- REST controllers → Audit logging: dispatches requests (evidence: `src/main/java/com/coffee_shop/coffee_shop/controller/ReviewController.java`)
- Authentication → Staff administration: authenticates staff
- Payment processing → CutLuy gateway client: requests payment
- CutLuy gateway client → CutLuy service: calls gateway
- Product catalog → Image storage: uploads images
- Order management → Telegram notifications: sends notifications
- Review persistence → Application database: persists reviews
- Staff administration → Application database: persists staff data
- Ingredients and stock → Application database: persists stock
- Supplier purchasing → Application database: persists purchases (evidence: `src/main/java/com/coffee_shop/coffee_shop/service/serviceimpl/ReviewServiceImpl.java`)
