# quanvu2108/order-management architecture

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

- Interactive diagram: https://gitdiagram.com/quanvu2108/order-management
- Repository: https://github.com/quanvu2108/order-management

## Overview

This is a Spring-based order-management service. Its principal workflow is an HTTP client submitting order or product requests, which the corresponding controller delegates to a domain service and returns as a response. The documented runtime setup also includes a fake GCS server, but the README does not describe which product operations use it. The graph preserves order, product, inventory, user, and permission domains plus security and persistence layers. Source excerpts show controller-to-service references; most implementation-level calls and several subsystem connections were not available, so they are omitted or marked unverified.

Main entry points: [`src/main/java/com/ss/service/Impl/OrderServiceImpl.java`](https://github.com/quanvu2108/order-management/blob/main/src/main/java/com/ss/service/Impl/OrderServiceImpl.java) (Order service), [`src/main/java/com/ss/controller/ToolController.java`](https://github.com/quanvu2108/order-management/blob/main/src/main/java/com/ss/controller/ToolController.java) (Order tools API), [`src/main/java/com/ss/service/Impl/ProductServiceImpl.java`](https://github.com/quanvu2108/order-management/blob/main/src/main/java/com/ss/service/Impl/ProductServiceImpl.java) (Product service), [`src/main/java/com/ss/controller/OrderController.java`](https://github.com/quanvu2108/order-management/blob/main/src/main/java/com/ss/controller/OrderController.java) (Order API)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["HTTP API"]
  node_order_api["Order API"]
  node_tool_api["Order tools API"]
  node_product_api["Product API"]
end

subgraph group_domains["Business domains"]
  node_order_service["Order service"]
  node_product_service["Product service"]
  node_store_item_service["Store inventory"]
  node_store_service["Store management"]
  node_user_service["User management"]
  node_permission_service["Permissions"]
  node_product_property["Product properties"]
  node_order_item_model["Order item state"]
  node_product_model["Product state<br/>[ProductModel.java]"]
end

subgraph group_persistence["Persistence"]
  node_order_repository["Order repositories"]
  node_user_repository["User repository"]
  node_database[("Relational database")]
end

subgraph group_platform["Security and integrations"]
  node_jwt["JWT security"]
  node_storage["File storage utility<br/>[StorageUtil.java]"]
end

subgraph group_shared["Shared types"]
  node_page_criteria["Page criteria<br/>[PageCriteria.java]"]
  node_page_response["Page response<br/>[PageResponse.java]"]
  node_service_response["Service response"]
  node_exception_response["Error response"]
  node_common_util["Common utilities<br/>[CommonUtil.java]"]
end

node_client(("HTTP client"))
node_fake_gcs["Fake GCS server"]

node_client -.->|"submits requests"| node_order_api
node_client -.->|"submits requests"| node_tool_api
node_client -.->|"submits requests"| node_product_api
node_order_api -->|"delegates to"| node_order_service
node_tool_api -->|"delegates to"| node_order_service
node_tool_api -->|"delegates to"| node_product_service
node_product_api -->|"delegates to"| node_product_service
node_order_service -.->|"updates state"| node_order_item_model
node_product_service -.->|"updates state"| node_product_model
node_order_service -.->|"persists orders"| node_order_repository
node_user_service -.->|"accesses users"| node_user_repository
node_order_repository -.->|"reads and writes"| node_database
node_user_repository -.->|"reads and writes"| node_database
node_storage -.->|"may use"| node_fake_gcs

click node_order_api "https://github.com/quanvu2108/order-management/blob/main/src/main/java/com/ss/controller/OrderController.java"
click node_tool_api "https://github.com/quanvu2108/order-management/blob/main/src/main/java/com/ss/controller/ToolController.java"
click node_product_api "https://github.com/quanvu2108/order-management/blob/main/src/main/java/com/ss/controller/ProductController.java"
click node_order_service "https://github.com/quanvu2108/order-management/blob/main/src/main/java/com/ss/service/Impl/OrderServiceImpl.java"
click node_product_service "https://github.com/quanvu2108/order-management/blob/main/src/main/java/com/ss/service/Impl/ProductServiceImpl.java"
click node_store_item_service "https://github.com/quanvu2108/order-management/blob/main/src/main/java/com/ss/service/Impl/StoreItemServiceImpl.java"
click node_store_service "https://github.com/quanvu2108/order-management/blob/main/src/main/java/com/ss/service/Impl/StoreServiceImpl.java"
click node_user_service "https://github.com/quanvu2108/order-management/blob/main/src/main/java/com/ss/service/Impl/UserServiceImpl.java"
click node_permission_service "https://github.com/quanvu2108/order-management/blob/main/src/main/java/com/ss/service/Impl/PermissionServiceImpl.java"
click node_product_property "https://github.com/quanvu2108/order-management/blob/main/src/main/java/com/ss/service/Impl/ProductPropertyServiceImpl.java"
click node_order_item_model "https://github.com/quanvu2108/order-management/blob/main/src/main/java/com/ss/model/OrderItemModel.java"
click node_product_model "https://github.com/quanvu2108/order-management/blob/main/src/main/java/com/ss/model/ProductModel.java"
click node_order_repository "https://github.com/quanvu2108/order-management/blob/main/src/main/java/com/ss/repository/OrderItemRepository.java"
click node_user_repository "https://github.com/quanvu2108/order-management/blob/main/src/main/java/com/ss/repository/UserRepository.java"
click node_jwt "https://github.com/quanvu2108/order-management/blob/main/src/main/java/com/ss/security/JwtTokenProvider.java"
click node_storage "https://github.com/quanvu2108/order-management/blob/main/src/main/java/com/ss/util/StorageUtil.java"
click node_page_criteria "https://github.com/quanvu2108/order-management/blob/main/src/main/java/com/ss/dto/pagination/PageCriteria.java"
click node_page_response "https://github.com/quanvu2108/order-management/blob/main/src/main/java/com/ss/dto/pagination/PageResponse.java"
click node_service_response "https://github.com/quanvu2108/order-management/blob/main/src/main/java/com/ss/dto/response/ServiceResponse.java"
click node_exception_response "https://github.com/quanvu2108/order-management/blob/main/src/main/java/com/ss/exception/ExceptionResponse.java"
click node_common_util "https://github.com/quanvu2108/order-management/blob/main/src/main/java/com/ss/util/CommonUtil.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_order_api,node_tool_api,node_product_api,node_client toneBlue
class node_order_service,node_product_service,node_store_item_service,node_store_service,node_user_service,node_permission_service,node_product_property,node_order_item_model,node_product_model toneAmber
class node_order_repository,node_user_repository,node_database,node_fake_gcs toneMint
class node_jwt,node_storage toneRose
class node_page_criteria,node_page_response,node_service_response,node_exception_response,node_common_util toneIndigo
```

## Components

### HTTP API

- [Order API](https://github.com/quanvu2108/order-management/blob/main/src/main/java/com/ss/controller/OrderController.java): `src/main/java/com/ss/controller/OrderController.java`
- [Order tools API](https://github.com/quanvu2108/order-management/blob/main/src/main/java/com/ss/controller/ToolController.java): `src/main/java/com/ss/controller/ToolController.java`
- [Product API](https://github.com/quanvu2108/order-management/blob/main/src/main/java/com/ss/controller/ProductController.java): `src/main/java/com/ss/controller/ProductController.java`

### Business domains

- [Order service](https://github.com/quanvu2108/order-management/blob/main/src/main/java/com/ss/service/Impl/OrderServiceImpl.java): `src/main/java/com/ss/service/Impl/OrderServiceImpl.java`
- [Product service](https://github.com/quanvu2108/order-management/blob/main/src/main/java/com/ss/service/Impl/ProductServiceImpl.java): `src/main/java/com/ss/service/Impl/ProductServiceImpl.java`
- [Store inventory](https://github.com/quanvu2108/order-management/blob/main/src/main/java/com/ss/service/Impl/StoreItemServiceImpl.java): `src/main/java/com/ss/service/Impl/StoreItemServiceImpl.java`
- [Store management](https://github.com/quanvu2108/order-management/blob/main/src/main/java/com/ss/service/Impl/StoreServiceImpl.java): `src/main/java/com/ss/service/Impl/StoreServiceImpl.java`
- [User management](https://github.com/quanvu2108/order-management/blob/main/src/main/java/com/ss/service/Impl/UserServiceImpl.java): `src/main/java/com/ss/service/Impl/UserServiceImpl.java`
- [Permissions](https://github.com/quanvu2108/order-management/blob/main/src/main/java/com/ss/service/Impl/PermissionServiceImpl.java): `src/main/java/com/ss/service/Impl/PermissionServiceImpl.java`
- [Product properties](https://github.com/quanvu2108/order-management/blob/main/src/main/java/com/ss/service/Impl/ProductPropertyServiceImpl.java): `src/main/java/com/ss/service/Impl/ProductPropertyServiceImpl.java`
- [Order item state](https://github.com/quanvu2108/order-management/blob/main/src/main/java/com/ss/model/OrderItemModel.java): `src/main/java/com/ss/model/OrderItemModel.java`
- [Product state](https://github.com/quanvu2108/order-management/blob/main/src/main/java/com/ss/model/ProductModel.java): `src/main/java/com/ss/model/ProductModel.java`

### Persistence

- [Order repositories](https://github.com/quanvu2108/order-management/blob/main/src/main/java/com/ss/repository/OrderItemRepository.java): `src/main/java/com/ss/repository/OrderItemRepository.java`
- [User repository](https://github.com/quanvu2108/order-management/blob/main/src/main/java/com/ss/repository/UserRepository.java): `src/main/java/com/ss/repository/UserRepository.java`
- **Relational database**

### Security and integrations

- [JWT security](https://github.com/quanvu2108/order-management/blob/main/src/main/java/com/ss/security/JwtTokenProvider.java): `src/main/java/com/ss/security/JwtTokenProvider.java`
- [File storage utility](https://github.com/quanvu2108/order-management/blob/main/src/main/java/com/ss/util/StorageUtil.java): `src/main/java/com/ss/util/StorageUtil.java`

### Shared types

- [Page criteria](https://github.com/quanvu2108/order-management/blob/main/src/main/java/com/ss/dto/pagination/PageCriteria.java): `src/main/java/com/ss/dto/pagination/PageCriteria.java`
- [Page response](https://github.com/quanvu2108/order-management/blob/main/src/main/java/com/ss/dto/pagination/PageResponse.java): `src/main/java/com/ss/dto/pagination/PageResponse.java`
- [Service response](https://github.com/quanvu2108/order-management/blob/main/src/main/java/com/ss/dto/response/ServiceResponse.java): `src/main/java/com/ss/dto/response/ServiceResponse.java`
- [Error response](https://github.com/quanvu2108/order-management/blob/main/src/main/java/com/ss/exception/ExceptionResponse.java): `src/main/java/com/ss/exception/ExceptionResponse.java`
- [Common utilities](https://github.com/quanvu2108/order-management/blob/main/src/main/java/com/ss/util/CommonUtil.java): `src/main/java/com/ss/util/CommonUtil.java`

### Other components

- **HTTP client**
- **Fake GCS server**

## Connections

- HTTP client → Order API: submits requests
- HTTP client → Order tools API: submits requests
- HTTP client → Product API: submits requests
- Order API → Order service: delegates to (evidence: `src/main/java/com/ss/controller/OrderController.java`)
- Order tools API → Order service: delegates to (evidence: `src/main/java/com/ss/controller/ToolController.java`)
- Order tools API → Product service: delegates to (evidence: `src/main/java/com/ss/controller/ToolController.java`)
- Product API → Product service: delegates to (evidence: `src/main/java/com/ss/controller/ProductController.java`)
- Order service → Order item state: updates state (evidence: `src/main/java/com/ss/service/Impl/OrderServiceImpl.java`)
- Product service → Product state: updates state (evidence: `src/main/java/com/ss/service/Impl/ProductServiceImpl.java`)
- Order service → Order repositories: persists orders (evidence: `src/main/java/com/ss/service/Impl/OrderServiceImpl.java`)
- User management → User repository: accesses users
- Order repositories → Relational database: reads and writes
- User repository → Relational database: reads and writes
- File storage utility → Fake GCS server: may use
