# quykimdoan26-prog/ecommerce_doankimquy_24ct2 architecture

> Architecture diagram of the GitHub repository quykimdoan26-prog/ecommerce_doankimquy_24ct2, 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/quykimdoan26-prog/ecommerce_doankimquy_24ct2
- Repository: https://github.com/quykimdoan26-prog/ecommerce_doankimquy_24ct2

## Overview

Quý shop is a Spring Boot/Thymeleaf online store. Customers browse products, manage a cart, and check out to create orders; admins manage products, orders, users, and dashboard statistics. The graph preserves those domain stages and the shared service/repository/persistence layers. Controller-to-service and service-to-repository links are supported by the source index; several controller implementations and their view bindings were not sampled, so documented capabilities are represented without asserting unshown view-level wiring.

Main entry points: [`src/main/java/com/ecommerce/service/OrderService.java`](https://github.com/quykimdoan26-prog/ecommerce_doankimquy_24ct2/blob/main/src/main/java/com/ecommerce/service/OrderService.java) (Order service), [`src/main/java/com/ecommerce/controller/AdminController.java`](https://github.com/quykimdoan26-prog/ecommerce_doankimquy_24ct2/blob/main/src/main/java/com/ecommerce/controller/AdminController.java) (Admin console), [`src/main/java/com/ecommerce/controller/ProductController.java`](https://github.com/quykimdoan26-prog/ecommerce_doankimquy_24ct2/blob/main/src/main/java/com/ecommerce/controller/ProductController.java) (Catalog browsing), [`src/main/java/com/ecommerce/service/CartService.java`](https://github.com/quykimdoan26-prog/ecommerce_doankimquy_24ct2/blob/main/src/main/java/com/ecommerce/service/CartService.java) (Cart service)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web workflows"]
  node_catalogweb["Catalog browsing"]
  node_homeweb["Storefront"]
  node_cartweb["Cart workflow"]
  node_checkoutweb["Checkout"]
  node_ordersweb["Order views"]
  node_adminweb["Admin console"]
  node_authweb["Registration"]
end

subgraph group_domain["Commerce services"]
  node_productservice["Product service"]
  node_categoryservice["Category service"]
  node_cartservice["Cart service<br/>[CartService.java]"]
  node_orderservice["Order service<br/>[OrderService.java]"]
  node_userservice["User service<br/>[UserService.java]"]
end

subgraph group_persistence["Persistence"]
  node_entities["Commerce entities"]
  node_productrepo["Product repository"]
  node_categoryrepo["Category repository"]
  node_cartrepo["Cart repository"]
  node_orderrepo["Order repository"]
  node_orderitemrepo["Order item repository"]
  node_userrepo["User repository"]
  node_mysql[("MySQL database")]
end

subgraph group_identity["Identity and security"]
  node_security["Security configuration"]
  node_details["User details loader"]
end

node_shopper(("Customer / admin"))

node_shopper -.->|"browses"| node_homeweb
node_shopper -.->|"browses"| node_catalogweb
node_shopper -.->|"registers"| node_authweb
node_shopper -.->|"manages cart"| node_cartweb
node_shopper -.->|"checks out"| node_checkoutweb
node_shopper -.->|"tracks orders"| node_ordersweb
node_shopper -.->|"administers"| node_adminweb
node_homeweb -->|"calls"| node_productservice
node_homeweb -->|"calls"| node_categoryservice
node_catalogweb -->|"calls"| node_productservice
node_catalogweb -->|"calls"| node_categoryservice
node_catalogweb -->|"calls"| node_cartservice
node_cartweb -->|"calls"| node_cartservice
node_checkoutweb -->|"calls"| node_orderservice
node_ordersweb -->|"calls"| node_orderservice
node_adminweb -->|"calls"| node_productservice
node_adminweb -->|"calls"| node_categoryservice
node_adminweb -->|"calls"| node_orderservice
node_adminweb -->|"calls"| node_userservice
node_authweb -->|"calls"| node_userservice
node_productservice -->|"queries"| node_productrepo
node_categoryservice -->|"queries"| node_categoryrepo
node_cartservice -->|"reads/writes"| node_cartrepo
node_cartservice -->|"looks up"| node_productrepo
node_orderservice -->|"reads/writes"| node_orderrepo
node_orderservice -->|"saves items"| node_orderitemrepo
node_orderservice -->|"updates stock"| node_productrepo
node_orderservice -->|"reads/clears"| node_cartrepo
node_userservice -->|"reads/writes"| node_userrepo
node_details -->|"loads users"| node_userrepo
node_security -.->|"configures login"| node_details
node_productrepo -.->|"persists"| node_mysql
node_categoryrepo -.->|"persists"| node_mysql
node_cartrepo -.->|"persists"| node_mysql
node_orderrepo -.->|"persists"| node_mysql
node_orderitemrepo -.->|"persists"| node_mysql
node_userrepo -.->|"persists"| node_mysql

click node_catalogweb "https://github.com/quykimdoan26-prog/ecommerce_doankimquy_24ct2/blob/main/src/main/java/com/ecommerce/controller/ProductController.java"
click node_homeweb "https://github.com/quykimdoan26-prog/ecommerce_doankimquy_24ct2/blob/main/src/main/java/com/ecommerce/controller/HomeController.java"
click node_cartweb "https://github.com/quykimdoan26-prog/ecommerce_doankimquy_24ct2/blob/main/src/main/java/com/ecommerce/controller/CartController.java"
click node_checkoutweb "https://github.com/quykimdoan26-prog/ecommerce_doankimquy_24ct2/blob/main/src/main/java/com/ecommerce/controller/CheckoutController.java"
click node_ordersweb "https://github.com/quykimdoan26-prog/ecommerce_doankimquy_24ct2/blob/main/src/main/java/com/ecommerce/controller/OrderController.java"
click node_adminweb "https://github.com/quykimdoan26-prog/ecommerce_doankimquy_24ct2/blob/main/src/main/java/com/ecommerce/controller/AdminController.java"
click node_authweb "https://github.com/quykimdoan26-prog/ecommerce_doankimquy_24ct2/blob/main/src/main/java/com/ecommerce/controller/AuthController.java"
click node_productservice "https://github.com/quykimdoan26-prog/ecommerce_doankimquy_24ct2/blob/main/src/main/java/com/ecommerce/service/ProductService.java"
click node_categoryservice "https://github.com/quykimdoan26-prog/ecommerce_doankimquy_24ct2/blob/main/src/main/java/com/ecommerce/service/CategoryService.java"
click node_cartservice "https://github.com/quykimdoan26-prog/ecommerce_doankimquy_24ct2/blob/main/src/main/java/com/ecommerce/service/CartService.java"
click node_orderservice "https://github.com/quykimdoan26-prog/ecommerce_doankimquy_24ct2/blob/main/src/main/java/com/ecommerce/service/OrderService.java"
click node_userservice "https://github.com/quykimdoan26-prog/ecommerce_doankimquy_24ct2/blob/main/src/main/java/com/ecommerce/service/UserService.java"
click node_entities "https://github.com/quykimdoan26-prog/ecommerce_doankimquy_24ct2/tree/main/src/main/java/com/ecommerce/entity"
click node_productrepo "https://github.com/quykimdoan26-prog/ecommerce_doankimquy_24ct2/blob/main/src/main/java/com/ecommerce/repository/ProductRepository.java"
click node_categoryrepo "https://github.com/quykimdoan26-prog/ecommerce_doankimquy_24ct2/blob/main/src/main/java/com/ecommerce/repository/CategoryRepository.java"
click node_cartrepo "https://github.com/quykimdoan26-prog/ecommerce_doankimquy_24ct2/blob/main/src/main/java/com/ecommerce/repository/CartItemRepository.java"
click node_orderrepo "https://github.com/quykimdoan26-prog/ecommerce_doankimquy_24ct2/blob/main/src/main/java/com/ecommerce/repository/OrderRepository.java"
click node_orderitemrepo "https://github.com/quykimdoan26-prog/ecommerce_doankimquy_24ct2/blob/main/src/main/java/com/ecommerce/repository/OrderItemRepository.java"
click node_userrepo "https://github.com/quykimdoan26-prog/ecommerce_doankimquy_24ct2/blob/main/src/main/java/com/ecommerce/repository/UserRepository.java"
click node_security "https://github.com/quykimdoan26-prog/ecommerce_doankimquy_24ct2/blob/main/src/main/java/com/ecommerce/config/SecurityConfig.java"
click node_details "https://github.com/quykimdoan26-prog/ecommerce_doankimquy_24ct2/blob/main/src/main/java/com/ecommerce/config/CustomUserDetailsService.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_catalogweb,node_homeweb,node_cartweb,node_checkoutweb,node_ordersweb,node_adminweb,node_authweb toneBlue
class node_productservice,node_categoryservice,node_cartservice,node_orderservice,node_userservice toneAmber
class node_entities,node_productrepo,node_categoryrepo,node_cartrepo,node_orderrepo,node_orderitemrepo,node_userrepo,node_mysql toneMint
class node_security,node_details toneRose
class node_shopper toneIndigo
```

## Components

### Web workflows

- [Catalog browsing](https://github.com/quykimdoan26-prog/ecommerce_doankimquy_24ct2/blob/main/src/main/java/com/ecommerce/controller/ProductController.java): `src/main/java/com/ecommerce/controller/ProductController.java`
- [Storefront](https://github.com/quykimdoan26-prog/ecommerce_doankimquy_24ct2/blob/main/src/main/java/com/ecommerce/controller/HomeController.java): `src/main/java/com/ecommerce/controller/HomeController.java`
- [Cart workflow](https://github.com/quykimdoan26-prog/ecommerce_doankimquy_24ct2/blob/main/src/main/java/com/ecommerce/controller/CartController.java): `src/main/java/com/ecommerce/controller/CartController.java`
- [Checkout](https://github.com/quykimdoan26-prog/ecommerce_doankimquy_24ct2/blob/main/src/main/java/com/ecommerce/controller/CheckoutController.java): `src/main/java/com/ecommerce/controller/CheckoutController.java`
- [Order views](https://github.com/quykimdoan26-prog/ecommerce_doankimquy_24ct2/blob/main/src/main/java/com/ecommerce/controller/OrderController.java): `src/main/java/com/ecommerce/controller/OrderController.java`
- [Admin console](https://github.com/quykimdoan26-prog/ecommerce_doankimquy_24ct2/blob/main/src/main/java/com/ecommerce/controller/AdminController.java): `src/main/java/com/ecommerce/controller/AdminController.java`
- [Registration](https://github.com/quykimdoan26-prog/ecommerce_doankimquy_24ct2/blob/main/src/main/java/com/ecommerce/controller/AuthController.java): `src/main/java/com/ecommerce/controller/AuthController.java`

### Commerce services

- [Product service](https://github.com/quykimdoan26-prog/ecommerce_doankimquy_24ct2/blob/main/src/main/java/com/ecommerce/service/ProductService.java): `src/main/java/com/ecommerce/service/ProductService.java`
- [Category service](https://github.com/quykimdoan26-prog/ecommerce_doankimquy_24ct2/blob/main/src/main/java/com/ecommerce/service/CategoryService.java): `src/main/java/com/ecommerce/service/CategoryService.java`
- [Cart service](https://github.com/quykimdoan26-prog/ecommerce_doankimquy_24ct2/blob/main/src/main/java/com/ecommerce/service/CartService.java): `src/main/java/com/ecommerce/service/CartService.java`
- [Order service](https://github.com/quykimdoan26-prog/ecommerce_doankimquy_24ct2/blob/main/src/main/java/com/ecommerce/service/OrderService.java): `src/main/java/com/ecommerce/service/OrderService.java`
- [User service](https://github.com/quykimdoan26-prog/ecommerce_doankimquy_24ct2/blob/main/src/main/java/com/ecommerce/service/UserService.java): `src/main/java/com/ecommerce/service/UserService.java`

### Persistence

- [Commerce entities](https://github.com/quykimdoan26-prog/ecommerce_doankimquy_24ct2/tree/main/src/main/java/com/ecommerce/entity): `src/main/java/com/ecommerce/entity`
- [Product repository](https://github.com/quykimdoan26-prog/ecommerce_doankimquy_24ct2/blob/main/src/main/java/com/ecommerce/repository/ProductRepository.java): `src/main/java/com/ecommerce/repository/ProductRepository.java`
- [Category repository](https://github.com/quykimdoan26-prog/ecommerce_doankimquy_24ct2/blob/main/src/main/java/com/ecommerce/repository/CategoryRepository.java): `src/main/java/com/ecommerce/repository/CategoryRepository.java`
- [Cart repository](https://github.com/quykimdoan26-prog/ecommerce_doankimquy_24ct2/blob/main/src/main/java/com/ecommerce/repository/CartItemRepository.java): `src/main/java/com/ecommerce/repository/CartItemRepository.java`
- [Order repository](https://github.com/quykimdoan26-prog/ecommerce_doankimquy_24ct2/blob/main/src/main/java/com/ecommerce/repository/OrderRepository.java): `src/main/java/com/ecommerce/repository/OrderRepository.java`
- [Order item repository](https://github.com/quykimdoan26-prog/ecommerce_doankimquy_24ct2/blob/main/src/main/java/com/ecommerce/repository/OrderItemRepository.java): `src/main/java/com/ecommerce/repository/OrderItemRepository.java`
- [User repository](https://github.com/quykimdoan26-prog/ecommerce_doankimquy_24ct2/blob/main/src/main/java/com/ecommerce/repository/UserRepository.java): `src/main/java/com/ecommerce/repository/UserRepository.java`
- **MySQL database**

### Identity and security

- [Security configuration](https://github.com/quykimdoan26-prog/ecommerce_doankimquy_24ct2/blob/main/src/main/java/com/ecommerce/config/SecurityConfig.java): `src/main/java/com/ecommerce/config/SecurityConfig.java`
- [User details loader](https://github.com/quykimdoan26-prog/ecommerce_doankimquy_24ct2/blob/main/src/main/java/com/ecommerce/config/CustomUserDetailsService.java): `src/main/java/com/ecommerce/config/CustomUserDetailsService.java`

### Other components

- **Customer / admin**

## Connections

- Customer / admin → Storefront: browses (evidence: `README.md`)
- Customer / admin → Catalog browsing: browses (evidence: `README.md`)
- Customer / admin → Registration: registers (evidence: `README.md`)
- Customer / admin → Cart workflow: manages cart
- Customer / admin → Checkout: checks out (evidence: `README.md`)
- Customer / admin → Order views: tracks orders (evidence: `README.md`)
- Customer / admin → Admin console: administers (evidence: `README.md`)
- Storefront → Product service: calls (evidence: `src/main/java/com/ecommerce/controller/HomeController.java`)
- Storefront → Category service: calls (evidence: `src/main/java/com/ecommerce/controller/HomeController.java`)
- Catalog browsing → Product service: calls (evidence: `src/main/java/com/ecommerce/controller/ProductController.java`)
- Catalog browsing → Category service: calls (evidence: `src/main/java/com/ecommerce/controller/ProductController.java`)
- Catalog browsing → Cart service: calls (evidence: `src/main/java/com/ecommerce/controller/ProductController.java`)
- Cart workflow → Cart service: calls (evidence: `src/main/java/com/ecommerce/controller/CartController.java`)
- Checkout → Order service: calls (evidence: `src/main/java/com/ecommerce/controller/CheckoutController.java`)
- Order views → Order service: calls (evidence: `src/main/java/com/ecommerce/controller/OrderController.java`)
- Admin console → Product service: calls (evidence: `src/main/java/com/ecommerce/controller/AdminController.java`)
- Admin console → Category service: calls (evidence: `src/main/java/com/ecommerce/controller/AdminController.java`)
- Admin console → Order service: calls (evidence: `src/main/java/com/ecommerce/controller/AdminController.java`)
- Admin console → User service: calls (evidence: `src/main/java/com/ecommerce/controller/AdminController.java`)
- Registration → User service: calls (evidence: `src/main/java/com/ecommerce/controller/AuthController.java`)
- Product service → Product repository: queries (evidence: `src/main/java/com/ecommerce/service/ProductService.java`)
- Category service → Category repository: queries (evidence: `src/main/java/com/ecommerce/service/CategoryService.java`)
- Cart service → Cart repository: reads/writes (evidence: `src/main/java/com/ecommerce/service/CartService.java`)
- Cart service → Product repository: looks up (evidence: `src/main/java/com/ecommerce/service/CartService.java`)
- Order service → Order repository: reads/writes (evidence: `src/main/java/com/ecommerce/service/OrderService.java`)
- Order service → Order item repository: saves items (evidence: `src/main/java/com/ecommerce/service/OrderService.java`)
- Order service → Product repository: updates stock (evidence: `src/main/java/com/ecommerce/service/OrderService.java`)
- Order service → Cart repository: reads/clears (evidence: `src/main/java/com/ecommerce/service/OrderService.java`)
- User service → User repository: reads/writes (evidence: `src/main/java/com/ecommerce/service/UserService.java`)
- User details loader → User repository: loads users (evidence: `src/main/java/com/ecommerce/config/CustomUserDetailsService.java`)
- Security configuration → User details loader: configures login
- Product repository → MySQL database: persists (evidence: `README.md`)
- Category repository → MySQL database: persists (evidence: `README.md`)
- Cart repository → MySQL database: persists (evidence: `README.md`)
- Order repository → MySQL database: persists (evidence: `README.md`)
- Order item repository → MySQL database: persists (evidence: `README.md`)
- User repository → MySQL database: persists (evidence: `README.md`)
