# thong2451220073-code/phanvanthong24ct2_cnpm architecture

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

## Overview

This is a Vietnamese technology-store commerce application with a Java/Spring backend and a static JavaScript frontend. Its principal customer journey is browsing products, managing a cart, placing an order, and paying; staff and administrators also manage orders, inventory, returns, warranties, users, and reporting. The map preserves those distinct product areas, but many controller/service implementations and frontend modules were not sampled. Dashed links indicate likely workflow relationships that could not be verified from the available excerpts.

Main entry points: [`src/backend/java/com/cuahangcongnghe/thanhtoan`](https://github.com/thong2451220073-code/phanvanthong24ct2_cnpm/tree/main/src/backend/java/com/cuahangcongnghe/thanhtoan) (Payment handling), [`src/frontend/static/js/nhan-vien`](https://github.com/thong2451220073-code/phanvanthong24ct2_cnpm/tree/main/src/frontend/static/js/nhan-vien) (Staff and admin UI), [`src/backend/java/com/cuahangcongnghe/donhang`](https://github.com/thong2451220073-code/phanvanthong24ct2_cnpm/tree/main/src/backend/java/com/cuahangcongnghe/donhang) (Order management), [`src/frontend/static/js/khach-hang`](https://github.com/thong2451220073-code/phanvanthong24ct2_cnpm/tree/main/src/frontend/static/js/khach-hang) (Storefront UI)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_shop["Customer commerce"]
  node_storefront["Storefront UI"]
  node_catalog["Product catalog"]
  node_cart["Shopping cart"]
  node_orders[("Order management")]
  node_payments["Payment handling"]
  node_invoice["Invoice PDF"]
  node_addresses[("Delivery addresses")]
end

subgraph group_ops["Store operations"]
  node_inventory[("Stock management")]
  node_stock_in["Stock receiving"]
  node_stock_out["Stock issuing"]
  node_returns[("Returns and exchanges")]
  node_warranty[("Warranty service")]
  node_analytics["Sales reporting"]
  node_staff_ui["Staff and admin UI"]
end

subgraph group_identity["Identity and access"]
  node_auth["Authentication"]
  node_users[("User management")]
  node_security["JWT security"]
end

subgraph group_platform["Shared services"]
  node_payments_db[("Payment records<br/>[ThanhToan.java]")]
  node_vnpay["VNPAY gateway<br/>[VnPayService.java]"]
  node_vietqr["VietQR links<br/>[VietQrService.java]"]
end

node_customer(("Customer"))
node_staff(("Staff and admin"))

node_customer -.->|"uses"| node_storefront
node_storefront -.->|"browses"| node_catalog
node_storefront -.->|"manages cart"| node_cart
node_cart -.->|"starts checkout"| node_orders
node_orders -.->|"initiates payment"| node_payments
node_payments -->|"creates payment URL"| node_vnpay
node_payments -->|"creates QR URL"| node_vietqr
node_payments -->|"reads and writes"| node_payments_db
node_payments -->|"reads and updates"| node_orders
node_staff -.->|"uses"| node_staff_ui
node_staff_ui -.->|"manages stock"| node_inventory
node_staff_ui -.->|"handles requests"| node_returns
node_staff_ui -.->|"handles claims"| node_warranty
node_staff_ui -.->|"views reports"| node_analytics
node_stock_in -.->|"updates stock"| node_inventory
node_stock_out -.->|"updates stock"| node_inventory
node_auth -.->|"authenticates users"| node_users
node_security -->|"loads identity"| node_users
node_orders -->|"supplies order data"| node_invoice

click node_storefront "https://github.com/thong2451220073-code/phanvanthong24ct2_cnpm/tree/main/src/frontend/static/js/khach-hang"
click node_catalog "https://github.com/thong2451220073-code/phanvanthong24ct2_cnpm/tree/main/src/backend/java/com/cuahangcongnghe/sanpham"
click node_cart "https://github.com/thong2451220073-code/phanvanthong24ct2_cnpm/tree/main/src/backend/java/com/cuahangcongnghe/giohang"
click node_orders "https://github.com/thong2451220073-code/phanvanthong24ct2_cnpm/tree/main/src/backend/java/com/cuahangcongnghe/donhang"
click node_payments "https://github.com/thong2451220073-code/phanvanthong24ct2_cnpm/tree/main/src/backend/java/com/cuahangcongnghe/thanhtoan"
click node_invoice "https://github.com/thong2451220073-code/phanvanthong24ct2_cnpm/blob/main/src/backend/java/com/cuahangcongnghe/hoadon/HoaDonPdfService.java"
click node_addresses "https://github.com/thong2451220073-code/phanvanthong24ct2_cnpm/tree/main/src/backend/java/com/cuahangcongnghe/diachi"
click node_inventory "https://github.com/thong2451220073-code/phanvanthong24ct2_cnpm/tree/main/src/backend/java/com/cuahangcongnghe/kho"
click node_stock_in "https://github.com/thong2451220073-code/phanvanthong24ct2_cnpm/tree/main/src/backend/java/com/cuahangcongnghe/nhapkho"
click node_stock_out "https://github.com/thong2451220073-code/phanvanthong24ct2_cnpm/tree/main/src/backend/java/com/cuahangcongnghe/xuatkho"
click node_returns "https://github.com/thong2451220073-code/phanvanthong24ct2_cnpm/tree/main/src/backend/java/com/cuahangcongnghe/doitra"
click node_warranty "https://github.com/thong2451220073-code/phanvanthong24ct2_cnpm/tree/main/src/backend/java/com/cuahangcongnghe/baohanh"
click node_analytics "https://github.com/thong2451220073-code/phanvanthong24ct2_cnpm/tree/main/src/backend/java/com/cuahangcongnghe/thongke"
click node_staff_ui "https://github.com/thong2451220073-code/phanvanthong24ct2_cnpm/tree/main/src/frontend/static/js/nhan-vien"
click node_auth "https://github.com/thong2451220073-code/phanvanthong24ct2_cnpm/tree/main/src/backend/java/com/cuahangcongnghe/xacthuc"
click node_users "https://github.com/thong2451220073-code/phanvanthong24ct2_cnpm/tree/main/src/backend/java/com/cuahangcongnghe/nguoidung"
click node_security "https://github.com/thong2451220073-code/phanvanthong24ct2_cnpm/tree/main/src/backend/java/com/cuahangcongnghe/baomat"
click node_payments_db "https://github.com/thong2451220073-code/phanvanthong24ct2_cnpm/blob/main/src/backend/java/com/cuahangcongnghe/thanhtoan/entity/ThanhToan.java"
click node_vnpay "https://github.com/thong2451220073-code/phanvanthong24ct2_cnpm/blob/main/src/backend/java/com/cuahangcongnghe/thanhtoan/vnpay/VnPayService.java"
click node_vietqr "https://github.com/thong2451220073-code/phanvanthong24ct2_cnpm/blob/main/src/backend/java/com/cuahangcongnghe/thanhtoan/vietqr/VietQrService.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_storefront,node_catalog,node_cart,node_orders,node_payments,node_invoice,node_addresses toneBlue
class node_inventory,node_stock_in,node_stock_out,node_returns,node_warranty,node_analytics,node_staff_ui toneAmber
class node_auth,node_users,node_security toneMint
class node_payments_db,node_vnpay,node_vietqr toneRose
class node_customer,node_staff toneIndigo
```

## Components

### Customer commerce

- [Storefront UI](https://github.com/thong2451220073-code/phanvanthong24ct2_cnpm/tree/main/src/frontend/static/js/khach-hang): `src/frontend/static/js/khach-hang`
- [Product catalog](https://github.com/thong2451220073-code/phanvanthong24ct2_cnpm/tree/main/src/backend/java/com/cuahangcongnghe/sanpham): `src/backend/java/com/cuahangcongnghe/sanpham`
- [Shopping cart](https://github.com/thong2451220073-code/phanvanthong24ct2_cnpm/tree/main/src/backend/java/com/cuahangcongnghe/giohang): `src/backend/java/com/cuahangcongnghe/giohang`
- [Order management](https://github.com/thong2451220073-code/phanvanthong24ct2_cnpm/tree/main/src/backend/java/com/cuahangcongnghe/donhang): `src/backend/java/com/cuahangcongnghe/donhang`
- [Payment handling](https://github.com/thong2451220073-code/phanvanthong24ct2_cnpm/tree/main/src/backend/java/com/cuahangcongnghe/thanhtoan): `src/backend/java/com/cuahangcongnghe/thanhtoan`
- [Invoice PDF](https://github.com/thong2451220073-code/phanvanthong24ct2_cnpm/blob/main/src/backend/java/com/cuahangcongnghe/hoadon/HoaDonPdfService.java): `src/backend/java/com/cuahangcongnghe/hoadon/HoaDonPdfService.java`
- [Delivery addresses](https://github.com/thong2451220073-code/phanvanthong24ct2_cnpm/tree/main/src/backend/java/com/cuahangcongnghe/diachi): `src/backend/java/com/cuahangcongnghe/diachi`

### Store operations

- [Stock management](https://github.com/thong2451220073-code/phanvanthong24ct2_cnpm/tree/main/src/backend/java/com/cuahangcongnghe/kho): `src/backend/java/com/cuahangcongnghe/kho`
- [Stock receiving](https://github.com/thong2451220073-code/phanvanthong24ct2_cnpm/tree/main/src/backend/java/com/cuahangcongnghe/nhapkho): `src/backend/java/com/cuahangcongnghe/nhapkho`
- [Stock issuing](https://github.com/thong2451220073-code/phanvanthong24ct2_cnpm/tree/main/src/backend/java/com/cuahangcongnghe/xuatkho): `src/backend/java/com/cuahangcongnghe/xuatkho`
- [Returns and exchanges](https://github.com/thong2451220073-code/phanvanthong24ct2_cnpm/tree/main/src/backend/java/com/cuahangcongnghe/doitra): `src/backend/java/com/cuahangcongnghe/doitra`
- [Warranty service](https://github.com/thong2451220073-code/phanvanthong24ct2_cnpm/tree/main/src/backend/java/com/cuahangcongnghe/baohanh): `src/backend/java/com/cuahangcongnghe/baohanh`
- [Sales reporting](https://github.com/thong2451220073-code/phanvanthong24ct2_cnpm/tree/main/src/backend/java/com/cuahangcongnghe/thongke): `src/backend/java/com/cuahangcongnghe/thongke`
- [Staff and admin UI](https://github.com/thong2451220073-code/phanvanthong24ct2_cnpm/tree/main/src/frontend/static/js/nhan-vien): `src/frontend/static/js/nhan-vien`

### Identity and access

- [Authentication](https://github.com/thong2451220073-code/phanvanthong24ct2_cnpm/tree/main/src/backend/java/com/cuahangcongnghe/xacthuc): `src/backend/java/com/cuahangcongnghe/xacthuc`
- [User management](https://github.com/thong2451220073-code/phanvanthong24ct2_cnpm/tree/main/src/backend/java/com/cuahangcongnghe/nguoidung): `src/backend/java/com/cuahangcongnghe/nguoidung`
- [JWT security](https://github.com/thong2451220073-code/phanvanthong24ct2_cnpm/tree/main/src/backend/java/com/cuahangcongnghe/baomat): `src/backend/java/com/cuahangcongnghe/baomat`

### Shared services

- [Payment records](https://github.com/thong2451220073-code/phanvanthong24ct2_cnpm/blob/main/src/backend/java/com/cuahangcongnghe/thanhtoan/entity/ThanhToan.java): `src/backend/java/com/cuahangcongnghe/thanhtoan/entity/ThanhToan.java`
- [VNPAY gateway](https://github.com/thong2451220073-code/phanvanthong24ct2_cnpm/blob/main/src/backend/java/com/cuahangcongnghe/thanhtoan/vnpay/VnPayService.java): `src/backend/java/com/cuahangcongnghe/thanhtoan/vnpay/VnPayService.java`
- [VietQR links](https://github.com/thong2451220073-code/phanvanthong24ct2_cnpm/blob/main/src/backend/java/com/cuahangcongnghe/thanhtoan/vietqr/VietQrService.java): `src/backend/java/com/cuahangcongnghe/thanhtoan/vietqr/VietQrService.java`

### Other components

- **Customer**
- **Staff and admin**

## Connections

- Customer → Storefront UI: uses
- Storefront UI → Product catalog: browses
- Storefront UI → Shopping cart: manages cart
- Shopping cart → Order management: starts checkout
- Order management → Payment handling: initiates payment (evidence: `src/backend/java/com/cuahangcongnghe/thanhtoan/service/ThanhToanQuanTriService.java`)
- Payment handling → VNPAY gateway: creates payment URL (evidence: `src/backend/java/com/cuahangcongnghe/thanhtoan/controller/ThanhToanController.java`)
- Payment handling → VietQR links: creates QR URL (evidence: `src/backend/java/com/cuahangcongnghe/thanhtoan/controller/ThanhToanController.java`)
- Payment handling → Payment records: reads and writes (evidence: `src/backend/java/com/cuahangcongnghe/thanhtoan/controller/ThanhToanController.java`)
- Payment handling → Order management: reads and updates (evidence: `src/backend/java/com/cuahangcongnghe/thanhtoan/controller/ThanhToanController.java`)
- Staff and admin → Staff and admin UI: uses
- Staff and admin UI → Stock management: manages stock
- Staff and admin UI → Returns and exchanges: handles requests
- Staff and admin UI → Warranty service: handles claims
- Staff and admin UI → Sales reporting: views reports
- Stock receiving → Stock management: updates stock (evidence: `src/backend/java/com/cuahangcongnghe/nhapkho/service/NhapKhoService.java`)
- Stock issuing → Stock management: updates stock (evidence: `src/backend/java/com/cuahangcongnghe/xuatkho/service/XuatKhoService.java`)
- Authentication → User management: authenticates users
- JWT security → User management: loads identity (evidence: `src/backend/java/com/cuahangcongnghe/baomat/ChiTietNguoiDung.java`)
- Order management → Invoice PDF: supplies order data (evidence: `src/backend/java/com/cuahangcongnghe/hoadon/HoaDonPdfService.java`)
