# hominhdat2003/hominhdat_24ct2_bandienthoai architecture

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

## Overview

This is a phone-commerce application: shoppers browse/search products, inspect details, maintain a cart, and submit orders; administrators manage products and order status. The client routes these experiences and calls backend APIs, whose controllers delegate to domain services and MySQL; product image uploads also use Cloudinary. The graph includes documented client features and the server domains, but unsampled route/controller details are represented cautiously; HTTP edges reflect the API paths visible in client services and controller route comments.

Main entry points: [`HoMinhDat_24CT2_BANDIENTHOAI/client/src/App.js`](https://github.com/hominhdat2003/hominhdat_24ct2_bandienthoai/blob/main/HoMinhDat_24CT2_BANDIENTHOAI/client/src/App.js) (Application Routes), [`HoMinhDat_24CT2_BANDIENTHOAI/server/controllers/ProductController.js`](https://github.com/hominhdat2003/hominhdat_24ct2_bandienthoai/blob/main/HoMinhDat_24CT2_BANDIENTHOAI/server/controllers/ProductController.js) (Product Controller), [`HoMinhDat_24CT2_BANDIENTHOAI/client/src/services/product.service.js`](https://github.com/hominhdat2003/hominhdat_24ct2_bandienthoai/blob/main/HoMinhDat_24CT2_BANDIENTHOAI/client/src/services/product.service.js) (Product API Client), [`HoMinhDat_24CT2_BANDIENTHOAI/client/src/context/AuthContextProvider.js`](https://github.com/hominhdat2003/hominhdat_24ct2_bandienthoai/blob/main/HoMinhDat_24CT2_BANDIENTHOAI/client/src/context/AuthContextProvider.js) (Auth State)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Customer and Admin Client"]
  node_app["Application Routes<br/>[App.js]"]
  node_storefront["Storefront<br/>[index.js]"]
  node_product_view["Product Details<br/>[index.js]"]
  node_cart_view["Shopping Cart<br/>[index.js]"]
  node_admin_products["Product Admin<br/>[index.js]"]
  node_admin_orders["Order Admin<br/>[index.js]"]
end

subgraph group_identity["Identity"]
  node_login["Login<br/>[index.js]"]
  node_register["Registration<br/>[index.js]"]
  node_auth_context["Auth State"]
  node_auth_api["Auth API Client<br/>[auth.service.js]"]
  node_auth_routes["Auth Routes<br/>[auth.js]"]
  node_auth_controller["Auth Controller<br/>[AuthController.js]"]
  node_user_service["User Service<br/>[user.services.js]"]
end

subgraph group_catalog["Product Catalog"]
  node_product_api["Product API Client<br/>[product.service.js]"]
  node_product_routes["Product Routes<br/>[product.js]"]
  node_product_controller["Product Controller"]
  node_product_service["Product Service"]
end

subgraph group_orders["Orders"]
  node_bill_api["Bill API Client<br/>[bill.service.js]"]
  node_bill_routes["Bill Routes<br/>[bill.js]"]
  node_bill_controller["Bill Controller<br/>[BillController.js]"]
  node_bill_service["Bill Service<br/>[bill.services.js]"]
end

subgraph group_persistence["Persistence and Media"]
  node_mysql[("MySQL Pool<br/>[database.js]")]
  node_cloudinary["Cloudinary<br/>[cloudinary.js]"]
  node_image_service["Image Service<br/>[image.services.js]"]
end

node_shopper(("Shopper"))
node_admin(("Administrator"))

node_shopper -->|"browses and buys"| node_app
node_admin -->|"manages store"| node_app
node_app -->|"routes to"| node_storefront
node_app -->|"routes to"| node_product_view
node_app -->|"routes to"| node_cart_view
node_app -->|"routes to"| node_login
node_app -->|"routes to"| node_register
node_app -->|"routes to"| node_admin_products
node_app -->|"routes to"| node_admin_orders
node_login -->|"uses auth state"| node_auth_context
node_auth_context -.->|"registers via"| node_auth_api
node_register -.->|"submits registration"| node_auth_api
node_auth_context -->|"calls auth endpoints"| node_auth_routes
node_auth_api -->|"posts registration"| node_auth_routes
node_auth_routes -->|"dispatches"| node_auth_controller
node_auth_controller -->|"queries and creates users"| node_user_service
node_storefront -.->|"loads products"| node_product_api
node_product_view -->|"loads product"| node_product_api
node_admin_products -.->|"manages products"| node_product_api
node_product_api -->|"calls product endpoints"| node_product_routes
node_product_routes -->|"dispatches"| node_product_controller
node_product_controller -->|"runs product operations"| node_product_service
node_product_controller -->|"checks creator role"| node_user_service
node_cart_view -->|"creates bills"| node_bill_api
node_admin_orders -.->|"manages bills"| node_bill_api
node_bill_api -->|"calls bill endpoints"| node_bill_routes
node_bill_routes -.->|"dispatches"| node_bill_controller
node_bill_controller -->|"runs bill operations"| node_bill_service
node_product_service -->|"queries products"| node_mysql
node_user_service -->|"queries users"| node_mysql
node_bill_service -->|"queries bills"| node_mysql
node_product_controller -->|"uploads product images"| node_cloudinary
node_bill_controller -->|"reads product data"| node_product_service

click node_app "https://github.com/hominhdat2003/hominhdat_24ct2_bandienthoai/blob/main/HoMinhDat_24CT2_BANDIENTHOAI/client/src/App.js"
click node_storefront "https://github.com/hominhdat2003/hominhdat_24ct2_bandienthoai/blob/main/HoMinhDat_24CT2_BANDIENTHOAI/client/src/components/Modules/HomeTemplate/index.js"
click node_product_view "https://github.com/hominhdat2003/hominhdat_24ct2_bandienthoai/blob/main/HoMinhDat_24CT2_BANDIENTHOAI/client/src/components/Modules/ProductTemplate/index.js"
click node_cart_view "https://github.com/hominhdat2003/hominhdat_24ct2_bandienthoai/blob/main/HoMinhDat_24CT2_BANDIENTHOAI/client/src/components/Modules/ShoppingCartTemplate/index.js"
click node_admin_products "https://github.com/hominhdat2003/hominhdat_24ct2_bandienthoai/blob/main/HoMinhDat_24CT2_BANDIENTHOAI/client/src/components/Modules/AdminTemplate/AdminListProduct/index.js"
click node_admin_orders "https://github.com/hominhdat2003/hominhdat_24ct2_bandienthoai/blob/main/HoMinhDat_24CT2_BANDIENTHOAI/client/src/components/Modules/AdminTemplate/AdminOrder/index.js"
click node_login "https://github.com/hominhdat2003/hominhdat_24ct2_bandienthoai/blob/main/HoMinhDat_24CT2_BANDIENTHOAI/client/src/components/Modules/LoginTemplate/index.js"
click node_register "https://github.com/hominhdat2003/hominhdat_24ct2_bandienthoai/blob/main/HoMinhDat_24CT2_BANDIENTHOAI/client/src/components/Modules/RegisterTemplate/index.js"
click node_auth_context "https://github.com/hominhdat2003/hominhdat_24ct2_bandienthoai/blob/main/HoMinhDat_24CT2_BANDIENTHOAI/client/src/context/AuthContextProvider.js"
click node_auth_api "https://github.com/hominhdat2003/hominhdat_24ct2_bandienthoai/blob/main/HoMinhDat_24CT2_BANDIENTHOAI/client/src/services/auth.service.js"
click node_auth_routes "https://github.com/hominhdat2003/hominhdat_24ct2_bandienthoai/blob/main/HoMinhDat_24CT2_BANDIENTHOAI/server/routes/auth.js"
click node_auth_controller "https://github.com/hominhdat2003/hominhdat_24ct2_bandienthoai/blob/main/HoMinhDat_24CT2_BANDIENTHOAI/server/controllers/AuthController.js"
click node_user_service "https://github.com/hominhdat2003/hominhdat_24ct2_bandienthoai/blob/main/HoMinhDat_24CT2_BANDIENTHOAI/server/services/user.services.js"
click node_product_api "https://github.com/hominhdat2003/hominhdat_24ct2_bandienthoai/blob/main/HoMinhDat_24CT2_BANDIENTHOAI/client/src/services/product.service.js"
click node_product_routes "https://github.com/hominhdat2003/hominhdat_24ct2_bandienthoai/blob/main/HoMinhDat_24CT2_BANDIENTHOAI/server/routes/product.js"
click node_product_controller "https://github.com/hominhdat2003/hominhdat_24ct2_bandienthoai/blob/main/HoMinhDat_24CT2_BANDIENTHOAI/server/controllers/ProductController.js"
click node_product_service "https://github.com/hominhdat2003/hominhdat_24ct2_bandienthoai/blob/main/HoMinhDat_24CT2_BANDIENTHOAI/server/services/product.services.js"
click node_bill_api "https://github.com/hominhdat2003/hominhdat_24ct2_bandienthoai/blob/main/HoMinhDat_24CT2_BANDIENTHOAI/client/src/services/bill.service.js"
click node_bill_routes "https://github.com/hominhdat2003/hominhdat_24ct2_bandienthoai/blob/main/HoMinhDat_24CT2_BANDIENTHOAI/server/routes/bill.js"
click node_bill_controller "https://github.com/hominhdat2003/hominhdat_24ct2_bandienthoai/blob/main/HoMinhDat_24CT2_BANDIENTHOAI/server/controllers/BillController.js"
click node_bill_service "https://github.com/hominhdat2003/hominhdat_24ct2_bandienthoai/blob/main/HoMinhDat_24CT2_BANDIENTHOAI/server/services/bill.services.js"
click node_mysql "https://github.com/hominhdat2003/hominhdat_24ct2_bandienthoai/blob/main/HoMinhDat_24CT2_BANDIENTHOAI/server/database.js"
click node_cloudinary "https://github.com/hominhdat2003/hominhdat_24ct2_bandienthoai/blob/main/HoMinhDat_24CT2_BANDIENTHOAI/server/lib/cloudinary.js"
click node_image_service "https://github.com/hominhdat2003/hominhdat_24ct2_bandienthoai/blob/main/HoMinhDat_24CT2_BANDIENTHOAI/server/services/image.services.js"

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_app,node_storefront,node_product_view,node_cart_view,node_admin_products,node_admin_orders toneBlue
class node_login,node_register,node_auth_context,node_auth_api,node_auth_routes,node_auth_controller,node_user_service toneAmber
class node_product_api,node_product_routes,node_product_controller,node_product_service toneMint
class node_bill_api,node_bill_routes,node_bill_controller,node_bill_service toneRose
class node_mysql,node_cloudinary,node_image_service,node_shopper,node_admin toneIndigo
```

## Components

### Customer and Admin Client

- [Application Routes](https://github.com/hominhdat2003/hominhdat_24ct2_bandienthoai/blob/main/HoMinhDat_24CT2_BANDIENTHOAI/client/src/App.js): `HoMinhDat_24CT2_BANDIENTHOAI/client/src/App.js`
- [Storefront](https://github.com/hominhdat2003/hominhdat_24ct2_bandienthoai/blob/main/HoMinhDat_24CT2_BANDIENTHOAI/client/src/components/Modules/HomeTemplate/index.js): `HoMinhDat_24CT2_BANDIENTHOAI/client/src/components/Modules/HomeTemplate/index.js`
- [Product Details](https://github.com/hominhdat2003/hominhdat_24ct2_bandienthoai/blob/main/HoMinhDat_24CT2_BANDIENTHOAI/client/src/components/Modules/ProductTemplate/index.js): `HoMinhDat_24CT2_BANDIENTHOAI/client/src/components/Modules/ProductTemplate/index.js`
- [Shopping Cart](https://github.com/hominhdat2003/hominhdat_24ct2_bandienthoai/blob/main/HoMinhDat_24CT2_BANDIENTHOAI/client/src/components/Modules/ShoppingCartTemplate/index.js): `HoMinhDat_24CT2_BANDIENTHOAI/client/src/components/Modules/ShoppingCartTemplate/index.js`
- [Product Admin](https://github.com/hominhdat2003/hominhdat_24ct2_bandienthoai/blob/main/HoMinhDat_24CT2_BANDIENTHOAI/client/src/components/Modules/AdminTemplate/AdminListProduct/index.js): `HoMinhDat_24CT2_BANDIENTHOAI/client/src/components/Modules/AdminTemplate/AdminListProduct/index.js`
- [Order Admin](https://github.com/hominhdat2003/hominhdat_24ct2_bandienthoai/blob/main/HoMinhDat_24CT2_BANDIENTHOAI/client/src/components/Modules/AdminTemplate/AdminOrder/index.js): `HoMinhDat_24CT2_BANDIENTHOAI/client/src/components/Modules/AdminTemplate/AdminOrder/index.js`

### Identity

- [Login](https://github.com/hominhdat2003/hominhdat_24ct2_bandienthoai/blob/main/HoMinhDat_24CT2_BANDIENTHOAI/client/src/components/Modules/LoginTemplate/index.js): `HoMinhDat_24CT2_BANDIENTHOAI/client/src/components/Modules/LoginTemplate/index.js`
- [Registration](https://github.com/hominhdat2003/hominhdat_24ct2_bandienthoai/blob/main/HoMinhDat_24CT2_BANDIENTHOAI/client/src/components/Modules/RegisterTemplate/index.js): `HoMinhDat_24CT2_BANDIENTHOAI/client/src/components/Modules/RegisterTemplate/index.js`
- [Auth State](https://github.com/hominhdat2003/hominhdat_24ct2_bandienthoai/blob/main/HoMinhDat_24CT2_BANDIENTHOAI/client/src/context/AuthContextProvider.js): `HoMinhDat_24CT2_BANDIENTHOAI/client/src/context/AuthContextProvider.js`
- [Auth API Client](https://github.com/hominhdat2003/hominhdat_24ct2_bandienthoai/blob/main/HoMinhDat_24CT2_BANDIENTHOAI/client/src/services/auth.service.js): `HoMinhDat_24CT2_BANDIENTHOAI/client/src/services/auth.service.js`
- [Auth Routes](https://github.com/hominhdat2003/hominhdat_24ct2_bandienthoai/blob/main/HoMinhDat_24CT2_BANDIENTHOAI/server/routes/auth.js): `HoMinhDat_24CT2_BANDIENTHOAI/server/routes/auth.js`
- [Auth Controller](https://github.com/hominhdat2003/hominhdat_24ct2_bandienthoai/blob/main/HoMinhDat_24CT2_BANDIENTHOAI/server/controllers/AuthController.js): `HoMinhDat_24CT2_BANDIENTHOAI/server/controllers/AuthController.js`
- [User Service](https://github.com/hominhdat2003/hominhdat_24ct2_bandienthoai/blob/main/HoMinhDat_24CT2_BANDIENTHOAI/server/services/user.services.js): `HoMinhDat_24CT2_BANDIENTHOAI/server/services/user.services.js`

### Product Catalog

- [Product API Client](https://github.com/hominhdat2003/hominhdat_24ct2_bandienthoai/blob/main/HoMinhDat_24CT2_BANDIENTHOAI/client/src/services/product.service.js): `HoMinhDat_24CT2_BANDIENTHOAI/client/src/services/product.service.js`
- [Product Routes](https://github.com/hominhdat2003/hominhdat_24ct2_bandienthoai/blob/main/HoMinhDat_24CT2_BANDIENTHOAI/server/routes/product.js): `HoMinhDat_24CT2_BANDIENTHOAI/server/routes/product.js`
- [Product Controller](https://github.com/hominhdat2003/hominhdat_24ct2_bandienthoai/blob/main/HoMinhDat_24CT2_BANDIENTHOAI/server/controllers/ProductController.js): `HoMinhDat_24CT2_BANDIENTHOAI/server/controllers/ProductController.js`
- [Product Service](https://github.com/hominhdat2003/hominhdat_24ct2_bandienthoai/blob/main/HoMinhDat_24CT2_BANDIENTHOAI/server/services/product.services.js): `HoMinhDat_24CT2_BANDIENTHOAI/server/services/product.services.js`

### Orders

- [Bill API Client](https://github.com/hominhdat2003/hominhdat_24ct2_bandienthoai/blob/main/HoMinhDat_24CT2_BANDIENTHOAI/client/src/services/bill.service.js): `HoMinhDat_24CT2_BANDIENTHOAI/client/src/services/bill.service.js`
- [Bill Routes](https://github.com/hominhdat2003/hominhdat_24ct2_bandienthoai/blob/main/HoMinhDat_24CT2_BANDIENTHOAI/server/routes/bill.js): `HoMinhDat_24CT2_BANDIENTHOAI/server/routes/bill.js`
- [Bill Controller](https://github.com/hominhdat2003/hominhdat_24ct2_bandienthoai/blob/main/HoMinhDat_24CT2_BANDIENTHOAI/server/controllers/BillController.js): `HoMinhDat_24CT2_BANDIENTHOAI/server/controllers/BillController.js`
- [Bill Service](https://github.com/hominhdat2003/hominhdat_24ct2_bandienthoai/blob/main/HoMinhDat_24CT2_BANDIENTHOAI/server/services/bill.services.js): `HoMinhDat_24CT2_BANDIENTHOAI/server/services/bill.services.js`

### Persistence and Media

- [MySQL Pool](https://github.com/hominhdat2003/hominhdat_24ct2_bandienthoai/blob/main/HoMinhDat_24CT2_BANDIENTHOAI/server/database.js): `HoMinhDat_24CT2_BANDIENTHOAI/server/database.js`
- [Cloudinary](https://github.com/hominhdat2003/hominhdat_24ct2_bandienthoai/blob/main/HoMinhDat_24CT2_BANDIENTHOAI/server/lib/cloudinary.js): `HoMinhDat_24CT2_BANDIENTHOAI/server/lib/cloudinary.js`
- [Image Service](https://github.com/hominhdat2003/hominhdat_24ct2_bandienthoai/blob/main/HoMinhDat_24CT2_BANDIENTHOAI/server/services/image.services.js): `HoMinhDat_24CT2_BANDIENTHOAI/server/services/image.services.js`

### Other components

- **Shopper**
- **Administrator**

## Connections

- Shopper → Application Routes: browses and buys (evidence: `HoMinhDat_24CT2_BANDIENTHOAI/client/src/App.js`)
- Administrator → Application Routes: manages store (evidence: `HoMinhDat_24CT2_BANDIENTHOAI/client/src/App.js`)
- Application Routes → Storefront: routes to (evidence: `HoMinhDat_24CT2_BANDIENTHOAI/client/src/App.js`)
- Application Routes → Product Details: routes to (evidence: `HoMinhDat_24CT2_BANDIENTHOAI/client/src/App.js`)
- Application Routes → Shopping Cart: routes to (evidence: `HoMinhDat_24CT2_BANDIENTHOAI/client/src/App.js`)
- Application Routes → Login: routes to (evidence: `HoMinhDat_24CT2_BANDIENTHOAI/client/src/App.js`)
- Application Routes → Registration: routes to (evidence: `HoMinhDat_24CT2_BANDIENTHOAI/client/src/App.js`)
- Application Routes → Product Admin: routes to (evidence: `HoMinhDat_24CT2_BANDIENTHOAI/client/src/App.js`)
- Application Routes → Order Admin: routes to (evidence: `HoMinhDat_24CT2_BANDIENTHOAI/client/src/App.js`)
- Login → Auth State: uses auth state (evidence: `HoMinhDat_24CT2_BANDIENTHOAI/client/src/components/Modules/LoginTemplate/index.js`)
- Auth State → Auth API Client: registers via
- Registration → Auth API Client: submits registration (evidence: `HoMinhDat_24CT2_BANDIENTHOAI/client/src/components/Modules/RegisterTemplate/index.js`)
- Auth State → Auth Routes: calls auth endpoints (evidence: `HoMinhDat_24CT2_BANDIENTHOAI/client/src/context/AuthContextProvider.js`)
- Auth API Client → Auth Routes: posts registration (evidence: `HoMinhDat_24CT2_BANDIENTHOAI/client/src/services/auth.service.js`)
- Auth Routes → Auth Controller: dispatches (evidence: `HoMinhDat_24CT2_BANDIENTHOAI/server/routes/auth.js`)
- Auth Controller → User Service: queries and creates users (evidence: `HoMinhDat_24CT2_BANDIENTHOAI/server/controllers/AuthController.js`)
- Storefront → Product API Client: loads products (evidence: `HoMinhDat_24CT2_BANDIENTHOAI/client/src/components/Modules/HomeTemplate/index.js`)
- Product Details → Product API Client: loads product (evidence: `HoMinhDat_24CT2_BANDIENTHOAI/client/src/components/Modules/ProductTemplate/index.js`)
- Product Admin → Product API Client: manages products (evidence: `HoMinhDat_24CT2_BANDIENTHOAI/client/src/components/Modules/AdminTemplate/AdminListProduct/index.js`)
- Product API Client → Product Routes: calls product endpoints (evidence: `HoMinhDat_24CT2_BANDIENTHOAI/client/src/services/product.service.js`)
- Product Routes → Product Controller: dispatches (evidence: `HoMinhDat_24CT2_BANDIENTHOAI/server/routes/product.js`)
- Product Controller → Product Service: runs product operations (evidence: `HoMinhDat_24CT2_BANDIENTHOAI/server/controllers/ProductController.js`)
- Product Controller → User Service: checks creator role (evidence: `HoMinhDat_24CT2_BANDIENTHOAI/server/controllers/ProductController.js`)
- Shopping Cart → Bill API Client: creates bills (evidence: `HoMinhDat_24CT2_BANDIENTHOAI/client/src/components/Modules/ShoppingCartTemplate/index.js`)
- Order Admin → Bill API Client: manages bills (evidence: `HoMinhDat_24CT2_BANDIENTHOAI/client/src/components/Modules/AdminTemplate/AdminOrder/index.js`)
- Bill API Client → Bill Routes: calls bill endpoints (evidence: `HoMinhDat_24CT2_BANDIENTHOAI/client/src/services/bill.service.js`)
- Bill Routes → Bill Controller: dispatches
- Bill Controller → Bill Service: runs bill operations (evidence: `HoMinhDat_24CT2_BANDIENTHOAI/server/controllers/BillController.js`)
- Product Service → MySQL Pool: queries products (evidence: `HoMinhDat_24CT2_BANDIENTHOAI/server/services/product.services.js`)
- User Service → MySQL Pool: queries users (evidence: `HoMinhDat_24CT2_BANDIENTHOAI/server/services/user.services.js`)
- Bill Service → MySQL Pool: queries bills (evidence: `HoMinhDat_24CT2_BANDIENTHOAI/server/services/bill.services.js`)
- Product Controller → Cloudinary: uploads product images (evidence: `HoMinhDat_24CT2_BANDIENTHOAI/server/controllers/ProductController.js`)
- Bill Controller → Product Service: reads product data (evidence: `HoMinhDat_24CT2_BANDIENTHOAI/server/controllers/BillController.js`)
