# thong2451220073-code/cuahangdienthoai architecture

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

## Overview

This is a Spring-based technology-store commerce and operations application. Its principal customer workflow is browsing products, managing a cart, placing an order, and arranging payment; staff also manage fulfillment, inventory, returns, and service. The tree documents these distinct domains, while the excerpts confirm payment-provider handling, order/payment state, and PDF invoice generation. Most controllers and service implementations were not sampled, so their internal call links are omitted or marked unverified rather than treated as inspected.

Main entry points: [`src/main/java/com/cuahangcongnghe/thanhtoan/controller/ThanhToanController.java`](https://github.com/thong2451220073-code/cuahangdienthoai/blob/main/src/main/java/com/cuahangcongnghe/thanhtoan/controller/ThanhToanController.java) (Payment Handling), [`src/main/java/com/cuahangcongnghe/donhang/service/DonHangServiceImpl.java`](https://github.com/thong2451220073-code/cuahangdienthoai/blob/main/src/main/java/com/cuahangcongnghe/donhang/service/DonHangServiceImpl.java) (Order Management), [`src/main/java/com/cuahangcongnghe/thanhtoan/vnpay/VnPayService.java`](https://github.com/thong2451220073-code/cuahangdienthoai/blob/main/src/main/java/com/cuahangcongnghe/thanhtoan/vnpay/VnPayService.java) (VNPAY Gateway), [`src/main/java/com/cuahangcongnghe/xacthuc/service/XacThucServiceImpl.java`](https://github.com/thong2451220073-code/cuahangdienthoai/blob/main/src/main/java/com/cuahangcongnghe/xacthuc/service/XacThucServiceImpl.java) (Authentication)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_commerce["Customer Commerce"]
  node_catalog["Product Catalog"]
  node_cart["Shopping Cart"]
  node_addresses["Delivery Addresses"]
  node_orders["Order Management"]
  node_orderdata[("Order Records<br/>[DonHang.java]")]
end

subgraph group_payments["Payments and Documents"]
  node_payments["Payment Handling"]
  node_paymentdata[("Payment Records<br/>[ThanhToan.java]")]
  node_vnpay["VNPAY Gateway<br/>[VnPayService.java]"]
  node_vietqr["VietQR<br/>[VietQrService.java]"]
  node_invoice["Invoice PDF"]
end

subgraph group_operations["Store Operations"]
  node_inventory[("Stock Management")]
  node_receiving["Stock Receiving"]
  node_dispatch["Stock Dispatch"]
  node_returns["Returns"]
  node_warranty["Warranty"]
end

subgraph group_identity["Identity and Access"]
  node_users[("User Management")]
  node_auth["Authentication"]
  node_security["JWT Security<br/>[BoLocJwt.java]"]
end

subgraph group_insights["Reporting"]
  node_analytics["Sales Analytics"]
end

node_customer(("Customer"))
node_staff(("Staff"))

node_customer -.->|"browses"| node_catalog
node_customer -.->|"manages items"| node_cart
node_customer -.->|"sets delivery"| node_addresses
node_customer -.->|"places order"| node_orders
node_orders -.->|"persists"| node_orderdata
node_customer -.->|"starts payment"| node_payments
node_payments -->|"reads and updates"| node_orderdata
node_payments -->|"reads and updates"| node_paymentdata
node_payments -->|"creates and verifies"| node_vnpay
node_payments -->|"creates QR URL"| node_vietqr
node_vnpay -.->|"redirects for payment"| node_customer
node_orders -.->|"generates invoice"| node_invoice
node_staff -.->|"manages stock"| node_inventory
node_staff -.->|"records receipts"| node_receiving
node_staff -.->|"records dispatch"| node_dispatch
node_staff -.->|"handles returns"| node_returns
node_staff -.->|"handles warranty"| node_warranty
node_staff -.->|"administers users"| node_users
node_customer -.->|"registers or signs in"| node_auth
node_auth -.->|"issues JWT"| node_security
node_staff -.->|"reviews sales"| node_analytics

click node_catalog "https://github.com/thong2451220073-code/cuahangdienthoai/blob/main/src/main/java/com/cuahangcongnghe/sanpham/service/SanPhamServiceImpl.java"
click node_cart "https://github.com/thong2451220073-code/cuahangdienthoai/blob/main/src/main/java/com/cuahangcongnghe/giohang/service/GioHangServiceImpl.java"
click node_addresses "https://github.com/thong2451220073-code/cuahangdienthoai/blob/main/src/main/java/com/cuahangcongnghe/diachi/controller/DiaChiController.java"
click node_orders "https://github.com/thong2451220073-code/cuahangdienthoai/blob/main/src/main/java/com/cuahangcongnghe/donhang/service/DonHangServiceImpl.java"
click node_orderdata "https://github.com/thong2451220073-code/cuahangdienthoai/blob/main/src/main/java/com/cuahangcongnghe/donhang/entity/DonHang.java"
click node_payments "https://github.com/thong2451220073-code/cuahangdienthoai/blob/main/src/main/java/com/cuahangcongnghe/thanhtoan/controller/ThanhToanController.java"
click node_paymentdata "https://github.com/thong2451220073-code/cuahangdienthoai/blob/main/src/main/java/com/cuahangcongnghe/thanhtoan/entity/ThanhToan.java"
click node_vnpay "https://github.com/thong2451220073-code/cuahangdienthoai/blob/main/src/main/java/com/cuahangcongnghe/thanhtoan/vnpay/VnPayService.java"
click node_vietqr "https://github.com/thong2451220073-code/cuahangdienthoai/blob/main/src/main/java/com/cuahangcongnghe/thanhtoan/vietqr/VietQrService.java"
click node_invoice "https://github.com/thong2451220073-code/cuahangdienthoai/blob/main/src/main/java/com/cuahangcongnghe/hoadon/HoaDonPdfService.java"
click node_inventory "https://github.com/thong2451220073-code/cuahangdienthoai/blob/main/src/main/java/com/cuahangcongnghe/kho/service/TonKhoServiceImpl.java"
click node_receiving "https://github.com/thong2451220073-code/cuahangdienthoai/blob/main/src/main/java/com/cuahangcongnghe/nhapkho/service/NhapKhoServiceImpl.java"
click node_dispatch "https://github.com/thong2451220073-code/cuahangdienthoai/blob/main/src/main/java/com/cuahangcongnghe/xuatkho/service/XuatKhoServiceImpl.java"
click node_returns "https://github.com/thong2451220073-code/cuahangdienthoai/blob/main/src/main/java/com/cuahangcongnghe/doitra/service/DoiTraServiceImpl.java"
click node_warranty "https://github.com/thong2451220073-code/cuahangdienthoai/blob/main/src/main/java/com/cuahangcongnghe/baohanh/service/BaoHanhServiceImpl.java"
click node_users "https://github.com/thong2451220073-code/cuahangdienthoai/blob/main/src/main/java/com/cuahangcongnghe/nguoidung/service/NguoiDungServiceImpl.java"
click node_auth "https://github.com/thong2451220073-code/cuahangdienthoai/blob/main/src/main/java/com/cuahangcongnghe/xacthuc/service/XacThucServiceImpl.java"
click node_security "https://github.com/thong2451220073-code/cuahangdienthoai/blob/main/src/main/java/com/cuahangcongnghe/baomat/BoLocJwt.java"
click node_analytics "https://github.com/thong2451220073-code/cuahangdienthoai/blob/main/src/main/java/com/cuahangcongnghe/thongke/service/ThongKeServiceImpl.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_catalog,node_cart,node_addresses,node_orders,node_orderdata toneBlue
class node_payments,node_paymentdata,node_vnpay,node_vietqr,node_invoice toneAmber
class node_inventory,node_receiving,node_dispatch,node_returns,node_warranty toneMint
class node_users,node_auth,node_security toneRose
class node_analytics,node_customer,node_staff toneIndigo
```

## Components

### Customer Commerce

- [Product Catalog](https://github.com/thong2451220073-code/cuahangdienthoai/blob/main/src/main/java/com/cuahangcongnghe/sanpham/service/SanPhamServiceImpl.java): `src/main/java/com/cuahangcongnghe/sanpham/service/SanPhamServiceImpl.java`
- [Shopping Cart](https://github.com/thong2451220073-code/cuahangdienthoai/blob/main/src/main/java/com/cuahangcongnghe/giohang/service/GioHangServiceImpl.java): `src/main/java/com/cuahangcongnghe/giohang/service/GioHangServiceImpl.java`
- [Delivery Addresses](https://github.com/thong2451220073-code/cuahangdienthoai/blob/main/src/main/java/com/cuahangcongnghe/diachi/controller/DiaChiController.java): `src/main/java/com/cuahangcongnghe/diachi/controller/DiaChiController.java`
- [Order Management](https://github.com/thong2451220073-code/cuahangdienthoai/blob/main/src/main/java/com/cuahangcongnghe/donhang/service/DonHangServiceImpl.java): `src/main/java/com/cuahangcongnghe/donhang/service/DonHangServiceImpl.java`
- [Order Records](https://github.com/thong2451220073-code/cuahangdienthoai/blob/main/src/main/java/com/cuahangcongnghe/donhang/entity/DonHang.java): `src/main/java/com/cuahangcongnghe/donhang/entity/DonHang.java`

### Payments and Documents

- [Payment Handling](https://github.com/thong2451220073-code/cuahangdienthoai/blob/main/src/main/java/com/cuahangcongnghe/thanhtoan/controller/ThanhToanController.java): `src/main/java/com/cuahangcongnghe/thanhtoan/controller/ThanhToanController.java`
- [Payment Records](https://github.com/thong2451220073-code/cuahangdienthoai/blob/main/src/main/java/com/cuahangcongnghe/thanhtoan/entity/ThanhToan.java): `src/main/java/com/cuahangcongnghe/thanhtoan/entity/ThanhToan.java`
- [VNPAY Gateway](https://github.com/thong2451220073-code/cuahangdienthoai/blob/main/src/main/java/com/cuahangcongnghe/thanhtoan/vnpay/VnPayService.java): `src/main/java/com/cuahangcongnghe/thanhtoan/vnpay/VnPayService.java`
- [VietQR](https://github.com/thong2451220073-code/cuahangdienthoai/blob/main/src/main/java/com/cuahangcongnghe/thanhtoan/vietqr/VietQrService.java): `src/main/java/com/cuahangcongnghe/thanhtoan/vietqr/VietQrService.java`
- [Invoice PDF](https://github.com/thong2451220073-code/cuahangdienthoai/blob/main/src/main/java/com/cuahangcongnghe/hoadon/HoaDonPdfService.java): `src/main/java/com/cuahangcongnghe/hoadon/HoaDonPdfService.java`

### Store Operations

- [Stock Management](https://github.com/thong2451220073-code/cuahangdienthoai/blob/main/src/main/java/com/cuahangcongnghe/kho/service/TonKhoServiceImpl.java): `src/main/java/com/cuahangcongnghe/kho/service/TonKhoServiceImpl.java`
- [Stock Receiving](https://github.com/thong2451220073-code/cuahangdienthoai/blob/main/src/main/java/com/cuahangcongnghe/nhapkho/service/NhapKhoServiceImpl.java): `src/main/java/com/cuahangcongnghe/nhapkho/service/NhapKhoServiceImpl.java`
- [Stock Dispatch](https://github.com/thong2451220073-code/cuahangdienthoai/blob/main/src/main/java/com/cuahangcongnghe/xuatkho/service/XuatKhoServiceImpl.java): `src/main/java/com/cuahangcongnghe/xuatkho/service/XuatKhoServiceImpl.java`
- [Returns](https://github.com/thong2451220073-code/cuahangdienthoai/blob/main/src/main/java/com/cuahangcongnghe/doitra/service/DoiTraServiceImpl.java): `src/main/java/com/cuahangcongnghe/doitra/service/DoiTraServiceImpl.java`
- [Warranty](https://github.com/thong2451220073-code/cuahangdienthoai/blob/main/src/main/java/com/cuahangcongnghe/baohanh/service/BaoHanhServiceImpl.java): `src/main/java/com/cuahangcongnghe/baohanh/service/BaoHanhServiceImpl.java`

### Identity and Access

- [User Management](https://github.com/thong2451220073-code/cuahangdienthoai/blob/main/src/main/java/com/cuahangcongnghe/nguoidung/service/NguoiDungServiceImpl.java): `src/main/java/com/cuahangcongnghe/nguoidung/service/NguoiDungServiceImpl.java`
- [Authentication](https://github.com/thong2451220073-code/cuahangdienthoai/blob/main/src/main/java/com/cuahangcongnghe/xacthuc/service/XacThucServiceImpl.java): `src/main/java/com/cuahangcongnghe/xacthuc/service/XacThucServiceImpl.java`
- [JWT Security](https://github.com/thong2451220073-code/cuahangdienthoai/blob/main/src/main/java/com/cuahangcongnghe/baomat/BoLocJwt.java): `src/main/java/com/cuahangcongnghe/baomat/BoLocJwt.java`

### Reporting

- [Sales Analytics](https://github.com/thong2451220073-code/cuahangdienthoai/blob/main/src/main/java/com/cuahangcongnghe/thongke/service/ThongKeServiceImpl.java): `src/main/java/com/cuahangcongnghe/thongke/service/ThongKeServiceImpl.java`

### Other components

- **Customer**
- **Staff**

## Connections

- Customer → Product Catalog: browses
- Customer → Shopping Cart: manages items
- Customer → Delivery Addresses: sets delivery
- Customer → Order Management: places order
- Order Management → Order Records: persists
- Customer → Payment Handling: starts payment
- Payment Handling → Order Records: reads and updates (evidence: `src/main/java/com/cuahangcongnghe/thanhtoan/controller/ThanhToanController.java`)
- Payment Handling → Payment Records: reads and updates (evidence: `src/main/java/com/cuahangcongnghe/thanhtoan/controller/ThanhToanController.java`)
- Payment Handling → VNPAY Gateway: creates and verifies (evidence: `src/main/java/com/cuahangcongnghe/thanhtoan/controller/ThanhToanController.java`)
- Payment Handling → VietQR: creates QR URL (evidence: `src/main/java/com/cuahangcongnghe/thanhtoan/controller/ThanhToanController.java`)
- VNPAY Gateway → Customer: redirects for payment
- Order Management → Invoice PDF: generates invoice
- Staff → Stock Management: manages stock
- Staff → Stock Receiving: records receipts
- Staff → Stock Dispatch: records dispatch
- Staff → Returns: handles returns
- Staff → Warranty: handles warranty
- Staff → User Management: administers users
- Customer → Authentication: registers or signs in
- Authentication → JWT Security: issues JWT
- Staff → Sales Analytics: reviews sales
