# nguyennhathung-23130129/thuctaplaptrinhweb architecture

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

- Interactive diagram: https://gitdiagram.com/nguyennhathung-23130129/thuctaplaptrinhweb
- Repository: https://github.com/nguyennhathung-23130129/thuctaplaptrinhweb

## Overview

This is a Java servlet e-commerce application. Customers browse and search products, add them to a cart, then check out with shipping, vouchers, order persistence, and VNPay payment support. Separate capabilities cover account access, reviews, and administration of catalog, inventory, users, orders, and promotions. The checkout, product search, review persistence, admin authorization, and selected DAO behavior are supported by excerpts or the source index; other listed servlet features are represented conservatively because their implementation was not sampled.

Main entry points: [`src/main/java/vn/edu/hcmuaf/fit/doanweb/controller/CheckoutServlet.java`](https://github.com/nguyennhathung-23130129/thuctaplaptrinhweb/blob/main/src/main/java/vn/edu/hcmuaf/fit/doanweb/controller/CheckoutServlet.java) (Checkout), [`src/main/java/vn/edu/hcmuaf/fit/doanweb/dao/ProductDao.java`](https://github.com/nguyennhathung-23130129/thuctaplaptrinhweb/blob/main/src/main/java/vn/edu/hcmuaf/fit/doanweb/dao/ProductDao.java) (Product data), [`src/main/java/vn/edu/hcmuaf/fit/doanweb/controller/ProductListServlet.java`](https://github.com/nguyennhathung-23130129/thuctaplaptrinhweb/blob/main/src/main/java/vn/edu/hcmuaf/fit/doanweb/controller/ProductListServlet.java) (Product browsing), [`src/main/java/vn/edu/hcmuaf/fit/doanweb/Cart/AddCart.java`](https://github.com/nguyennhathung-23130129/thuctaplaptrinhweb/blob/main/src/main/java/vn/edu/hcmuaf/fit/doanweb/Cart/AddCart.java) (Cart actions)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_storefront["Storefront"]
  node_catalog["Product browsing"]
  node_search["Product search<br/>[SearchServlet.java]"]
  node_product["Product model<br/>[Product.java]"]
  node_review["Product reviews<br/>[ReviewServlet.java]"]
end

subgraph group_commerce["Cart and checkout"]
  node_cartentry["Cart actions<br/>[AddCart.java]"]
  node_cart["Shopping cart<br/>[Cart.java]"]
  node_checkout["Checkout"]
  node_shipping["Shipping service"]
  node_payment["VNPay integration<br/>[VnPayLibrary.java]"]
end

subgraph group_identity["Accounts and access"]
  node_accounts["Account workflows<br/>[SignupServlet.java]"]
  node_adminfilter["Admin authorization<br/>[Admin.java]"]
end

subgraph group_operations["Administration"]
  node_admin["Admin management"]
  node_adminproduct["Catalog management"]
  node_upload["Image uploads"]
end

subgraph group_persistence["Persistence and integrations"]
  node_productdao["Product data<br/>[ProductDao.java]"]
  node_voucherdao["Voucher data<br/>[VoucherDao.java]"]
  node_orderdao["Order data<br/>[OrderDao.java]"]
  node_database[("MySQL database")]
  node_reviewdao["Review data<br/>[ReviewDao.java]"]
  node_userdao["User data<br/>[UserDao.java]"]
  node_basedao["Database access base<br/>[BaseDao.java]"]
end

node_customer(("Customer"))

node_customer -->|"searches"| node_search
node_search -->|"queries"| node_productdao
node_catalog -.->|"loads products"| node_productdao
node_customer -.->|"browses"| node_catalog
node_customer -.->|"adds items"| node_cartentry
node_cartentry -->|"loads product"| node_productdao
node_cartentry -->|"updates"| node_cart
node_checkout -->|"reads cart"| node_cart
node_checkout -->|"calculates shipping"| node_shipping
node_checkout -->|"creates order"| node_orderdao
node_checkout -->|"uses product data"| node_productdao
node_checkout -->|"uses voucher data"| node_voucherdao
node_checkout -->|"creates payment"| node_payment
node_orderdao -->|"uses product data"| node_productdao
node_review -->|"persists reviews"| node_reviewdao
node_accounts -->|"manages accounts"| node_userdao
node_adminfilter -->|"guards routes"| node_admin
node_adminproduct -->|"manages products"| node_productdao
node_adminproduct -->|"uploads images"| node_upload
node_productdao -->|"inherits access"| node_basedao
node_orderdao -->|"inherits access"| node_basedao
node_reviewdao -->|"reads and writes"| node_database
node_basedao -->|"opens connection"| node_database
node_catalog -.->|"returns product models"| node_product
node_admin -.->|"manages commerce records"| node_database

click node_catalog "https://github.com/nguyennhathung-23130129/thuctaplaptrinhweb/blob/main/src/main/java/vn/edu/hcmuaf/fit/doanweb/controller/ProductListServlet.java"
click node_search "https://github.com/nguyennhathung-23130129/thuctaplaptrinhweb/blob/main/src/main/java/vn/edu/hcmuaf/fit/doanweb/controller/SearchServlet.java"
click node_productdao "https://github.com/nguyennhathung-23130129/thuctaplaptrinhweb/blob/main/src/main/java/vn/edu/hcmuaf/fit/doanweb/dao/ProductDao.java"
click node_product "https://github.com/nguyennhathung-23130129/thuctaplaptrinhweb/blob/main/src/main/java/vn/edu/hcmuaf/fit/doanweb/model/Product.java"
click node_cartentry "https://github.com/nguyennhathung-23130129/thuctaplaptrinhweb/blob/main/src/main/java/vn/edu/hcmuaf/fit/doanweb/Cart/AddCart.java"
click node_cart "https://github.com/nguyennhathung-23130129/thuctaplaptrinhweb/blob/main/src/main/java/vn/edu/hcmuaf/fit/doanweb/Cart/Cart.java"
click node_checkout "https://github.com/nguyennhathung-23130129/thuctaplaptrinhweb/blob/main/src/main/java/vn/edu/hcmuaf/fit/doanweb/controller/CheckoutServlet.java"
click node_shipping "https://github.com/nguyennhathung-23130129/thuctaplaptrinhweb/blob/main/src/main/java/vn/edu/hcmuaf/fit/doanweb/services/ShippingService.java"
click node_voucherdao "https://github.com/nguyennhathung-23130129/thuctaplaptrinhweb/blob/main/src/main/java/vn/edu/hcmuaf/fit/doanweb/dao/VoucherDao.java"
click node_orderdao "https://github.com/nguyennhathung-23130129/thuctaplaptrinhweb/blob/main/src/main/java/vn/edu/hcmuaf/fit/doanweb/dao/OrderDao.java"
click node_payment "https://github.com/nguyennhathung-23130129/thuctaplaptrinhweb/blob/main/src/main/java/vn/edu/hcmuaf/fit/doanweb/services/VnPayLibrary.java"
click node_review "https://github.com/nguyennhathung-23130129/thuctaplaptrinhweb/blob/main/src/main/java/vn/edu/hcmuaf/fit/doanweb/controller/ReviewServlet.java"
click node_reviewdao "https://github.com/nguyennhathung-23130129/thuctaplaptrinhweb/blob/main/src/main/java/vn/edu/hcmuaf/fit/doanweb/dao/ReviewDao.java"
click node_accounts "https://github.com/nguyennhathung-23130129/thuctaplaptrinhweb/blob/main/src/main/java/vn/edu/hcmuaf/fit/doanweb/controller/SignupServlet.java"
click node_userdao "https://github.com/nguyennhathung-23130129/thuctaplaptrinhweb/blob/main/src/main/java/vn/edu/hcmuaf/fit/doanweb/dao/UserDao.java"
click node_adminfilter "https://github.com/nguyennhathung-23130129/thuctaplaptrinhweb/blob/main/src/main/java/vn/edu/hcmuaf/fit/doanweb/Filter/Admin.java"
click node_admin "https://github.com/nguyennhathung-23130129/thuctaplaptrinhweb/tree/main/src/main/java/vn/edu/hcmuaf/fit/doanweb/Admin"
click node_adminproduct "https://github.com/nguyennhathung-23130129/thuctaplaptrinhweb/blob/main/src/main/java/vn/edu/hcmuaf/fit/doanweb/Admin/AdminProductManage.java"
click node_upload "https://github.com/nguyennhathung-23130129/thuctaplaptrinhweb/blob/main/src/main/java/vn/edu/hcmuaf/fit/doanweb/utils/CloudinaryUpload.java"
click node_basedao "https://github.com/nguyennhathung-23130129/thuctaplaptrinhweb/blob/main/src/main/java/vn/edu/hcmuaf/fit/doanweb/dao/BaseDao.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_search,node_product,node_review toneBlue
class node_cartentry,node_cart,node_checkout,node_shipping,node_payment toneAmber
class node_accounts,node_adminfilter toneMint
class node_admin,node_adminproduct,node_upload toneRose
class node_productdao,node_voucherdao,node_orderdao,node_database,node_reviewdao,node_userdao,node_basedao,node_customer toneIndigo
```

## Components

### Storefront

- [Product browsing](https://github.com/nguyennhathung-23130129/thuctaplaptrinhweb/blob/main/src/main/java/vn/edu/hcmuaf/fit/doanweb/controller/ProductListServlet.java): `src/main/java/vn/edu/hcmuaf/fit/doanweb/controller/ProductListServlet.java`
- [Product search](https://github.com/nguyennhathung-23130129/thuctaplaptrinhweb/blob/main/src/main/java/vn/edu/hcmuaf/fit/doanweb/controller/SearchServlet.java): `src/main/java/vn/edu/hcmuaf/fit/doanweb/controller/SearchServlet.java`
- [Product model](https://github.com/nguyennhathung-23130129/thuctaplaptrinhweb/blob/main/src/main/java/vn/edu/hcmuaf/fit/doanweb/model/Product.java): `src/main/java/vn/edu/hcmuaf/fit/doanweb/model/Product.java`
- [Product reviews](https://github.com/nguyennhathung-23130129/thuctaplaptrinhweb/blob/main/src/main/java/vn/edu/hcmuaf/fit/doanweb/controller/ReviewServlet.java): `src/main/java/vn/edu/hcmuaf/fit/doanweb/controller/ReviewServlet.java`

### Cart and checkout

- [Cart actions](https://github.com/nguyennhathung-23130129/thuctaplaptrinhweb/blob/main/src/main/java/vn/edu/hcmuaf/fit/doanweb/Cart/AddCart.java): `src/main/java/vn/edu/hcmuaf/fit/doanweb/Cart/AddCart.java`
- [Shopping cart](https://github.com/nguyennhathung-23130129/thuctaplaptrinhweb/blob/main/src/main/java/vn/edu/hcmuaf/fit/doanweb/Cart/Cart.java): `src/main/java/vn/edu/hcmuaf/fit/doanweb/Cart/Cart.java`
- [Checkout](https://github.com/nguyennhathung-23130129/thuctaplaptrinhweb/blob/main/src/main/java/vn/edu/hcmuaf/fit/doanweb/controller/CheckoutServlet.java): `src/main/java/vn/edu/hcmuaf/fit/doanweb/controller/CheckoutServlet.java`
- [Shipping service](https://github.com/nguyennhathung-23130129/thuctaplaptrinhweb/blob/main/src/main/java/vn/edu/hcmuaf/fit/doanweb/services/ShippingService.java): `src/main/java/vn/edu/hcmuaf/fit/doanweb/services/ShippingService.java`
- [VNPay integration](https://github.com/nguyennhathung-23130129/thuctaplaptrinhweb/blob/main/src/main/java/vn/edu/hcmuaf/fit/doanweb/services/VnPayLibrary.java): `src/main/java/vn/edu/hcmuaf/fit/doanweb/services/VnPayLibrary.java`

### Accounts and access

- [Account workflows](https://github.com/nguyennhathung-23130129/thuctaplaptrinhweb/blob/main/src/main/java/vn/edu/hcmuaf/fit/doanweb/controller/SignupServlet.java): `src/main/java/vn/edu/hcmuaf/fit/doanweb/controller/SignupServlet.java`
- [Admin authorization](https://github.com/nguyennhathung-23130129/thuctaplaptrinhweb/blob/main/src/main/java/vn/edu/hcmuaf/fit/doanweb/Filter/Admin.java): `src/main/java/vn/edu/hcmuaf/fit/doanweb/Filter/Admin.java`

### Administration

- [Admin management](https://github.com/nguyennhathung-23130129/thuctaplaptrinhweb/tree/main/src/main/java/vn/edu/hcmuaf/fit/doanweb/Admin): `src/main/java/vn/edu/hcmuaf/fit/doanweb/Admin`
- [Catalog management](https://github.com/nguyennhathung-23130129/thuctaplaptrinhweb/blob/main/src/main/java/vn/edu/hcmuaf/fit/doanweb/Admin/AdminProductManage.java): `src/main/java/vn/edu/hcmuaf/fit/doanweb/Admin/AdminProductManage.java`
- [Image uploads](https://github.com/nguyennhathung-23130129/thuctaplaptrinhweb/blob/main/src/main/java/vn/edu/hcmuaf/fit/doanweb/utils/CloudinaryUpload.java): `src/main/java/vn/edu/hcmuaf/fit/doanweb/utils/CloudinaryUpload.java`

### Persistence and integrations

- [Product data](https://github.com/nguyennhathung-23130129/thuctaplaptrinhweb/blob/main/src/main/java/vn/edu/hcmuaf/fit/doanweb/dao/ProductDao.java): `src/main/java/vn/edu/hcmuaf/fit/doanweb/dao/ProductDao.java`
- [Voucher data](https://github.com/nguyennhathung-23130129/thuctaplaptrinhweb/blob/main/src/main/java/vn/edu/hcmuaf/fit/doanweb/dao/VoucherDao.java): `src/main/java/vn/edu/hcmuaf/fit/doanweb/dao/VoucherDao.java`
- [Order data](https://github.com/nguyennhathung-23130129/thuctaplaptrinhweb/blob/main/src/main/java/vn/edu/hcmuaf/fit/doanweb/dao/OrderDao.java): `src/main/java/vn/edu/hcmuaf/fit/doanweb/dao/OrderDao.java`
- **MySQL database**
- [Review data](https://github.com/nguyennhathung-23130129/thuctaplaptrinhweb/blob/main/src/main/java/vn/edu/hcmuaf/fit/doanweb/dao/ReviewDao.java): `src/main/java/vn/edu/hcmuaf/fit/doanweb/dao/ReviewDao.java`
- [User data](https://github.com/nguyennhathung-23130129/thuctaplaptrinhweb/blob/main/src/main/java/vn/edu/hcmuaf/fit/doanweb/dao/UserDao.java): `src/main/java/vn/edu/hcmuaf/fit/doanweb/dao/UserDao.java`
- [Database access base](https://github.com/nguyennhathung-23130129/thuctaplaptrinhweb/blob/main/src/main/java/vn/edu/hcmuaf/fit/doanweb/dao/BaseDao.java): `src/main/java/vn/edu/hcmuaf/fit/doanweb/dao/BaseDao.java`

### Other components

- **Customer**

## Connections

- Customer → Product search: searches (evidence: `src/main/java/vn/edu/hcmuaf/fit/doanweb/controller/SearchServlet.java`)
- Product search → Product data: queries (evidence: `src/main/java/vn/edu/hcmuaf/fit/doanweb/controller/SearchServlet.java`)
- Product browsing → Product data: loads products
- Customer → Product browsing: browses
- Customer → Cart actions: adds items
- Cart actions → Product data: loads product (evidence: `src/main/java/vn/edu/hcmuaf/fit/doanweb/Cart/AddCart.java`)
- Cart actions → Shopping cart: updates (evidence: `src/main/java/vn/edu/hcmuaf/fit/doanweb/Cart/AddCart.java`)
- Checkout → Shopping cart: reads cart (evidence: `src/main/java/vn/edu/hcmuaf/fit/doanweb/controller/CheckoutServlet.java`)
- Checkout → Shipping service: calculates shipping (evidence: `src/main/java/vn/edu/hcmuaf/fit/doanweb/controller/CheckoutServlet.java`)
- Checkout → Order data: creates order (evidence: `src/main/java/vn/edu/hcmuaf/fit/doanweb/controller/CheckoutServlet.java`)
- Checkout → Product data: uses product data (evidence: `src/main/java/vn/edu/hcmuaf/fit/doanweb/controller/CheckoutServlet.java`)
- Checkout → Voucher data: uses voucher data (evidence: `src/main/java/vn/edu/hcmuaf/fit/doanweb/controller/CheckoutServlet.java`)
- Checkout → VNPay integration: creates payment (evidence: `src/main/java/vn/edu/hcmuaf/fit/doanweb/controller/CheckoutServlet.java`)
- Order data → Product data: uses product data (evidence: `src/main/java/vn/edu/hcmuaf/fit/doanweb/dao/OrderDao.java`)
- Product reviews → Review data: persists reviews (evidence: `src/main/java/vn/edu/hcmuaf/fit/doanweb/controller/ReviewServlet.java`)
- Account workflows → User data: manages accounts (evidence: `src/main/java/vn/edu/hcmuaf/fit/doanweb/controller/SignupServlet.java`)
- Admin authorization → Admin management: guards routes (evidence: `src/main/java/vn/edu/hcmuaf/fit/doanweb/Filter/Admin.java`)
- Catalog management → Product data: manages products (evidence: `src/main/java/vn/edu/hcmuaf/fit/doanweb/Admin/AdminProductManage.java`)
- Catalog management → Image uploads: uploads images (evidence: `src/main/java/vn/edu/hcmuaf/fit/doanweb/Admin/AdminProductManage.java`)
- Product data → Database access base: inherits access (evidence: `src/main/java/vn/edu/hcmuaf/fit/doanweb/dao/ProductDao.java`)
- Order data → Database access base: inherits access (evidence: `src/main/java/vn/edu/hcmuaf/fit/doanweb/dao/OrderDao.java`)
- Review data → MySQL database: reads and writes (evidence: `src/main/java/vn/edu/hcmuaf/fit/doanweb/dao/ReviewDao.java`)
- Database access base → MySQL database: opens connection (evidence: `src/main/java/vn/edu/hcmuaf/fit/doanweb/dao/BaseDao.java`)
- Product browsing → Product model: returns product models
- Admin management → MySQL database: manages commerce records
