# hoangle10ck-sys/cnpm_tmdt_24ct2 architecture

> Architecture diagram of the GitHub repository hoangle10ck-sys/cnpm_tmdt_24ct2, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-13). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/hoangle10ck-sys/cnpm_tmdt_24ct2
- Repository: https://github.com/hoangle10ck-sys/cnpm_tmdt_24ct2

## Overview

TechStore is a Laravel MVC storefront and administration application. Shoppers browse products, manage a cart, and check out to create orders; checkout can redirect to VNPAY. Staff manage catalog content and order status, while customers register and access their accounts and orders. Eloquent models persist domain data in MySQL. The graph follows documented capabilities and the sampled controllers; several route targets and payment callback details are represented only where the README or source index supports them.

Main entry points: [`backend/routes/web.php`](https://github.com/hoangle10ck-sys/cnpm_tmdt_24ct2/blob/main/backend/routes/web.php) (Web Routes), [`backend/app/Models/Product.php`](https://github.com/hoangle10ck-sys/cnpm_tmdt_24ct2/blob/main/backend/app/Models/Product.php) (Product), [`backend/app/Http/Controllers/CheckoutController.php`](https://github.com/hoangle10ck-sys/cnpm_tmdt_24ct2/blob/main/backend/app/Http/Controllers/CheckoutController.php) (Checkout), [`backend/app/Models/User.php`](https://github.com/hoangle10ck-sys/cnpm_tmdt_24ct2/blob/main/backend/app/Models/User.php) (User)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_storefront["Storefront"]
  node_web_routes["Web Routes<br/>[web.php]"]
  node_catalog["Product Catalog"]
end

subgraph group_commerce["Commerce"]
  node_cart_handler["Cart Actions<br/>[CartController.php]"]
  node_checkout["Checkout"]
  node_payment_service["VNPAY Service"]
  node_orders["Customer Orders"]
  node_product_model["Product<br/>[Product.php]"]
  node_category_model["Category<br/>[Category.php]"]
  node_cart_model["Cart<br/>[Cart.php]"]
  node_cart_item_model["Cart Item<br/>[CartItem.php]"]
  node_order_model["Order<br/>[Order.php]"]
  node_order_item_model["Order Item<br/>[OrderItem.php]"]
  node_review_model["Review<br/>[Review.php]"]
end

subgraph group_accounts["Accounts"]
  node_auth_routes["Auth Routes<br/>[auth.php]"]
  node_registration["Registration"]
  node_user_model["User<br/>[User.php]"]
end

subgraph group_admin["Administration"]
  node_admin_products["Product Admin"]
  node_admin_categories["Category Admin"]
  node_admin_orders["Order Admin"]
  node_admin_customers["Customer Admin<br/>[UserController.php]"]
  node_admin_dashboard["Admin Dashboard"]
end

node_shopper(("Shopper"))
node_vnpay(("VNPAY"))
node_mysql[("MySQL")]

node_shopper -->|"sends requests"| node_web_routes
node_web_routes -->|"routes to"| node_catalog
node_web_routes -->|"routes to"| node_cart_handler
node_web_routes -->|"routes to"| node_checkout
node_web_routes -->|"routes to"| node_orders
node_catalog -->|"queries"| node_product_model
node_catalog -->|"queries"| node_category_model
node_cart_handler -->|"creates and loads"| node_cart_model
node_cart_handler -->|"creates and updates"| node_cart_item_model
node_cart_handler -->|"checks stock"| node_product_model
node_checkout -->|"loads and clears"| node_cart_model
node_checkout -->|"checks and decrements"| node_product_model
node_checkout -->|"creates order"| node_order_model
node_checkout -->|"creates items"| node_order_item_model
node_checkout -->|"requests payment URL"| node_payment_service
node_payment_service -.->|"builds payment redirect"| node_vnpay
node_product_model -->|"belongs to"| node_category_model
node_order_model -->|"has many"| node_order_item_model
node_user_model -->|"has one"| node_cart_model
node_user_model -->|"has many"| node_order_model
node_review_model -->|"belongs to"| node_user_model
node_review_model -->|"belongs to"| node_product_model
node_product_model -->|"persists through Eloquent"| node_mysql
node_category_model -->|"persists through Eloquent"| node_mysql
node_cart_model -->|"persists through Eloquent"| node_mysql
node_cart_item_model -->|"persists through Eloquent"| node_mysql
node_order_model -->|"persists through Eloquent"| node_mysql
node_order_item_model -->|"persists through Eloquent"| node_mysql
node_user_model -->|"persists through Eloquent"| node_mysql
node_auth_routes -->|"routes registration"| node_registration
node_registration -->|"creates user"| node_user_model
node_web_routes -->|"routes to"| node_admin_products
node_web_routes -->|"routes to"| node_admin_categories
node_web_routes -->|"routes to"| node_admin_orders
node_web_routes -->|"routes to"| node_admin_customers
node_web_routes -->|"routes to"| node_admin_dashboard
node_admin_products -->|"manages"| node_product_model
node_admin_products -->|"loads categories"| node_category_model
node_admin_categories -->|"manages"| node_category_model
node_admin_orders -->|"manages"| node_order_model
node_admin_orders -->|"restores stock"| node_product_model
node_admin_customers -->|"manages"| node_user_model

click node_web_routes "https://github.com/hoangle10ck-sys/cnpm_tmdt_24ct2/blob/main/backend/routes/web.php"
click node_catalog "https://github.com/hoangle10ck-sys/cnpm_tmdt_24ct2/blob/main/backend/app/Http/Controllers/ProductController.php"
click node_cart_handler "https://github.com/hoangle10ck-sys/cnpm_tmdt_24ct2/blob/main/backend/app/Http/Controllers/CartController.php"
click node_checkout "https://github.com/hoangle10ck-sys/cnpm_tmdt_24ct2/blob/main/backend/app/Http/Controllers/CheckoutController.php"
click node_payment_service "https://github.com/hoangle10ck-sys/cnpm_tmdt_24ct2/blob/main/backend/app/Services/VnpayPaymentService.php"
click node_orders "https://github.com/hoangle10ck-sys/cnpm_tmdt_24ct2/blob/main/backend/app/Http/Controllers/OrderController.php"
click node_product_model "https://github.com/hoangle10ck-sys/cnpm_tmdt_24ct2/blob/main/backend/app/Models/Product.php"
click node_category_model "https://github.com/hoangle10ck-sys/cnpm_tmdt_24ct2/blob/main/backend/app/Models/Category.php"
click node_cart_model "https://github.com/hoangle10ck-sys/cnpm_tmdt_24ct2/blob/main/backend/app/Models/Cart.php"
click node_cart_item_model "https://github.com/hoangle10ck-sys/cnpm_tmdt_24ct2/blob/main/backend/app/Models/CartItem.php"
click node_order_model "https://github.com/hoangle10ck-sys/cnpm_tmdt_24ct2/blob/main/backend/app/Models/Order.php"
click node_order_item_model "https://github.com/hoangle10ck-sys/cnpm_tmdt_24ct2/blob/main/backend/app/Models/OrderItem.php"
click node_review_model "https://github.com/hoangle10ck-sys/cnpm_tmdt_24ct2/blob/main/backend/app/Models/Review.php"
click node_auth_routes "https://github.com/hoangle10ck-sys/cnpm_tmdt_24ct2/blob/main/backend/routes/auth.php"
click node_registration "https://github.com/hoangle10ck-sys/cnpm_tmdt_24ct2/blob/main/backend/app/Http/Controllers/Auth/RegisteredUserController.php"
click node_user_model "https://github.com/hoangle10ck-sys/cnpm_tmdt_24ct2/blob/main/backend/app/Models/User.php"
click node_admin_products "https://github.com/hoangle10ck-sys/cnpm_tmdt_24ct2/blob/main/backend/app/Http/Controllers/Admin/ProductController.php"
click node_admin_categories "https://github.com/hoangle10ck-sys/cnpm_tmdt_24ct2/blob/main/backend/app/Http/Controllers/Admin/CategoryController.php"
click node_admin_orders "https://github.com/hoangle10ck-sys/cnpm_tmdt_24ct2/blob/main/backend/app/Http/Controllers/Admin/OrderController.php"
click node_admin_customers "https://github.com/hoangle10ck-sys/cnpm_tmdt_24ct2/blob/main/backend/app/Http/Controllers/Admin/UserController.php"
click node_admin_dashboard "https://github.com/hoangle10ck-sys/cnpm_tmdt_24ct2/blob/main/backend/app/Http/Controllers/Admin/DashboardController.php"

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_web_routes,node_catalog toneBlue
class node_cart_handler,node_checkout,node_payment_service,node_orders,node_product_model,node_category_model,node_cart_model,node_cart_item_model,node_order_model,node_order_item_model,node_review_model,node_mysql toneAmber
class node_auth_routes,node_registration,node_user_model toneMint
class node_admin_products,node_admin_categories,node_admin_orders,node_admin_customers,node_admin_dashboard toneRose
class node_shopper,node_vnpay toneIndigo
```

## Components

### Storefront

- [Web Routes](https://github.com/hoangle10ck-sys/cnpm_tmdt_24ct2/blob/main/backend/routes/web.php): `backend/routes/web.php`
- [Product Catalog](https://github.com/hoangle10ck-sys/cnpm_tmdt_24ct2/blob/main/backend/app/Http/Controllers/ProductController.php): `backend/app/Http/Controllers/ProductController.php`

### Commerce

- [Cart Actions](https://github.com/hoangle10ck-sys/cnpm_tmdt_24ct2/blob/main/backend/app/Http/Controllers/CartController.php): `backend/app/Http/Controllers/CartController.php`
- [Checkout](https://github.com/hoangle10ck-sys/cnpm_tmdt_24ct2/blob/main/backend/app/Http/Controllers/CheckoutController.php): `backend/app/Http/Controllers/CheckoutController.php`
- [VNPAY Service](https://github.com/hoangle10ck-sys/cnpm_tmdt_24ct2/blob/main/backend/app/Services/VnpayPaymentService.php): `backend/app/Services/VnpayPaymentService.php`
- [Customer Orders](https://github.com/hoangle10ck-sys/cnpm_tmdt_24ct2/blob/main/backend/app/Http/Controllers/OrderController.php): `backend/app/Http/Controllers/OrderController.php`
- [Product](https://github.com/hoangle10ck-sys/cnpm_tmdt_24ct2/blob/main/backend/app/Models/Product.php): `backend/app/Models/Product.php`
- [Category](https://github.com/hoangle10ck-sys/cnpm_tmdt_24ct2/blob/main/backend/app/Models/Category.php): `backend/app/Models/Category.php`
- [Cart](https://github.com/hoangle10ck-sys/cnpm_tmdt_24ct2/blob/main/backend/app/Models/Cart.php): `backend/app/Models/Cart.php`
- [Cart Item](https://github.com/hoangle10ck-sys/cnpm_tmdt_24ct2/blob/main/backend/app/Models/CartItem.php): `backend/app/Models/CartItem.php`
- [Order](https://github.com/hoangle10ck-sys/cnpm_tmdt_24ct2/blob/main/backend/app/Models/Order.php): `backend/app/Models/Order.php`
- [Order Item](https://github.com/hoangle10ck-sys/cnpm_tmdt_24ct2/blob/main/backend/app/Models/OrderItem.php): `backend/app/Models/OrderItem.php`
- [Review](https://github.com/hoangle10ck-sys/cnpm_tmdt_24ct2/blob/main/backend/app/Models/Review.php): `backend/app/Models/Review.php`

### Accounts

- [Auth Routes](https://github.com/hoangle10ck-sys/cnpm_tmdt_24ct2/blob/main/backend/routes/auth.php): `backend/routes/auth.php`
- [Registration](https://github.com/hoangle10ck-sys/cnpm_tmdt_24ct2/blob/main/backend/app/Http/Controllers/Auth/RegisteredUserController.php): `backend/app/Http/Controllers/Auth/RegisteredUserController.php`
- [User](https://github.com/hoangle10ck-sys/cnpm_tmdt_24ct2/blob/main/backend/app/Models/User.php): `backend/app/Models/User.php`

### Administration

- [Product Admin](https://github.com/hoangle10ck-sys/cnpm_tmdt_24ct2/blob/main/backend/app/Http/Controllers/Admin/ProductController.php): `backend/app/Http/Controllers/Admin/ProductController.php`
- [Category Admin](https://github.com/hoangle10ck-sys/cnpm_tmdt_24ct2/blob/main/backend/app/Http/Controllers/Admin/CategoryController.php): `backend/app/Http/Controllers/Admin/CategoryController.php`
- [Order Admin](https://github.com/hoangle10ck-sys/cnpm_tmdt_24ct2/blob/main/backend/app/Http/Controllers/Admin/OrderController.php): `backend/app/Http/Controllers/Admin/OrderController.php`
- [Customer Admin](https://github.com/hoangle10ck-sys/cnpm_tmdt_24ct2/blob/main/backend/app/Http/Controllers/Admin/UserController.php): `backend/app/Http/Controllers/Admin/UserController.php`
- [Admin Dashboard](https://github.com/hoangle10ck-sys/cnpm_tmdt_24ct2/blob/main/backend/app/Http/Controllers/Admin/DashboardController.php): `backend/app/Http/Controllers/Admin/DashboardController.php`

### Other components

- **Shopper**
- **VNPAY**
- **MySQL**

## Connections

- Shopper → Web Routes: sends requests (evidence: `README.md`)
- Web Routes → Product Catalog: routes to (evidence: `backend/routes/web.php`)
- Web Routes → Cart Actions: routes to (evidence: `backend/routes/web.php`)
- Web Routes → Checkout: routes to (evidence: `backend/routes/web.php`)
- Web Routes → Customer Orders: routes to (evidence: `backend/routes/web.php`)
- Product Catalog → Product: queries (evidence: `backend/app/Http/Controllers/ProductController.php`)
- Product Catalog → Category: queries (evidence: `backend/app/Http/Controllers/ProductController.php`)
- Cart Actions → Cart: creates and loads (evidence: `backend/app/Http/Controllers/CartController.php`)
- Cart Actions → Cart Item: creates and updates (evidence: `backend/app/Http/Controllers/CartController.php`)
- Cart Actions → Product: checks stock (evidence: `backend/app/Http/Controllers/CartController.php`)
- Checkout → Cart: loads and clears (evidence: `backend/app/Http/Controllers/CheckoutController.php`)
- Checkout → Product: checks and decrements (evidence: `backend/app/Http/Controllers/CheckoutController.php`)
- Checkout → Order: creates order (evidence: `backend/app/Http/Controllers/CheckoutController.php`)
- Checkout → Order Item: creates items (evidence: `backend/app/Http/Controllers/CheckoutController.php`)
- Checkout → VNPAY Service: requests payment URL (evidence: `backend/app/Http/Controllers/CheckoutController.php`)
- VNPAY Service → VNPAY: builds payment redirect
- Product → Category: belongs to (evidence: `backend/app/Models/Product.php`)
- Order → Order Item: has many (evidence: `backend/app/Models/Order.php`)
- User → Cart: has one (evidence: `backend/app/Models/User.php`)
- User → Order: has many (evidence: `backend/app/Models/User.php`)
- Review → User: belongs to (evidence: `README.md`)
- Review → Product: belongs to (evidence: `README.md`)
- Product → MySQL: persists through Eloquent (evidence: `README.md`)
- Category → MySQL: persists through Eloquent (evidence: `README.md`)
- Cart → MySQL: persists through Eloquent (evidence: `README.md`)
- Cart Item → MySQL: persists through Eloquent (evidence: `README.md`)
- Order → MySQL: persists through Eloquent (evidence: `README.md`)
- Order Item → MySQL: persists through Eloquent (evidence: `README.md`)
- User → MySQL: persists through Eloquent (evidence: `README.md`)
- Auth Routes → Registration: routes registration (evidence: `backend/routes/auth.php`)
- Registration → User: creates user (evidence: `backend/app/Http/Controllers/Auth/RegisteredUserController.php`)
- Web Routes → Product Admin: routes to (evidence: `backend/routes/web.php`)
- Web Routes → Category Admin: routes to (evidence: `backend/routes/web.php`)
- Web Routes → Order Admin: routes to (evidence: `backend/routes/web.php`)
- Web Routes → Customer Admin: routes to (evidence: `backend/routes/web.php`)
- Web Routes → Admin Dashboard: routes to (evidence: `backend/routes/web.php`)
- Product Admin → Product: manages (evidence: `backend/app/Http/Controllers/Admin/ProductController.php`)
- Product Admin → Category: loads categories (evidence: `backend/app/Http/Controllers/Admin/ProductController.php`)
- Category Admin → Category: manages (evidence: `backend/app/Http/Controllers/Admin/CategoryController.php`)
- Order Admin → Order: manages (evidence: `backend/app/Http/Controllers/Admin/OrderController.php`)
- Order Admin → Product: restores stock (evidence: `backend/app/Http/Controllers/Admin/OrderController.php`)
- Customer Admin → User: manages (evidence: `backend/app/Http/Controllers/Admin/UserController.php`)
