# hoangle10ck-sys/cnpm_tmdt architecture

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

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

## Overview

This is a Laravel storefront with customer and admin workflows. Customers browse products, manage a cart, check out into an order, and view their orders; administrators manage catalog data and order status. The graph preserves those domain stages and the Eloquent model layer. Relationships use the supplied excerpts and SOURCE INDEX references; unsampled controllers and route wiring are represented only where the index supports them, so view-level and other unverified links are omitted.

Main entry points: [`backend/routes/web.php`](https://github.com/hoangle10ck-sys/cnpm_tmdt/blob/main/backend/routes/web.php) (Web Routes), [`backend/app/Models/Product.php`](https://github.com/hoangle10ck-sys/cnpm_tmdt/blob/main/backend/app/Models/Product.php) (Product Model), [`backend/app/Models/Order.php`](https://github.com/hoangle10ck-sys/cnpm_tmdt/blob/main/backend/app/Models/Order.php) (Order Model), [`backend/app/Models/Category.php`](https://github.com/hoangle10ck-sys/cnpm_tmdt/blob/main/backend/app/Models/Category.php) (Category Model)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_storefront["Storefront"]
  node_web_routes["Web Routes<br/>[web.php]"]
  node_home["Home<br/>[HomeController.php]"]
  node_product_browse["Product Browse"]
end

subgraph group_commerce["Cart and Orders"]
  node_cart["Cart Operations<br/>[CartController.php]"]
  node_checkout["Checkout"]
  node_customer_orders["Customer Orders"]
  node_customer_dashboard["Customer Dashboard"]
end

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

subgraph group_identity["Identity and Domain"]
  node_auth_routes["Auth Routes<br/>[auth.php]"]
  node_auth_sessions["Registration and Login"]
  node_user_profile["Profile"]
  node_product_model["Product Model<br/>[Product.php]"]
  node_category_model["Category Model<br/>[Category.php]"]
  node_cart_model["Cart Model<br/>[Cart.php]"]
  node_cart_item_model["Cart Item Model<br/>[CartItem.php]"]
  node_order_model["Order Model<br/>[Order.php]"]
  node_order_item_model["Order Item Model<br/>[OrderItem.php]"]
  node_user_model["User Model<br/>[User.php]"]
end

node_customer(("Customer"))

node_customer -.->|"sends requests"| node_web_routes
node_web_routes -->|"routes to"| node_home
node_web_routes -->|"routes to"| node_product_browse
node_web_routes -->|"routes to"| node_cart
node_web_routes -->|"routes to"| node_checkout
node_web_routes -->|"routes to"| node_customer_orders
node_web_routes -->|"routes to"| node_customer_dashboard
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_web_routes -->|"includes"| node_auth_routes
node_auth_routes -->|"routes to"| node_auth_sessions
node_home -->|"queries"| node_product_model
node_home -->|"queries"| node_category_model
node_product_browse -->|"queries"| node_product_model
node_product_browse -->|"queries"| node_category_model
node_cart -->|"reads and writes"| node_cart_model
node_cart -->|"reads and writes"| node_cart_item_model
node_cart -->|"checks stock"| node_product_model
node_checkout -->|"loads cart"| node_cart_model
node_checkout -->|"checks and decrements"| node_product_model
node_checkout -->|"creates order"| node_order_model
node_customer_orders -->|"queries"| node_order_model
node_customer_dashboard -->|"summarizes"| node_order_model
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 -->|"updates status"| node_order_model
node_admin_orders -->|"restores stock"| node_product_model
node_admin_customers -->|"queries"| node_user_model
node_admin_customers -->|"queries"| node_order_model
node_admin_dashboard -->|"summarizes"| node_product_model
node_admin_dashboard -->|"summarizes"| node_category_model
node_admin_dashboard -->|"summarizes"| node_order_model
node_admin_dashboard -->|"summarizes"| node_user_model
node_user_profile -->|"updates"| node_user_model
node_cart_model -->|"belongs to"| node_user_model
node_cart_model -->|"has items"| node_cart_item_model
node_order_model -->|"belongs to"| node_user_model
node_order_model -->|"has items"| node_order_item_model
node_product_model -->|"belongs to"| node_category_model
node_category_model -->|"has products"| node_product_model

click node_web_routes "https://github.com/hoangle10ck-sys/cnpm_tmdt/blob/main/backend/routes/web.php"
click node_home "https://github.com/hoangle10ck-sys/cnpm_tmdt/blob/main/backend/app/Http/Controllers/HomeController.php"
click node_product_browse "https://github.com/hoangle10ck-sys/cnpm_tmdt/blob/main/backend/app/Http/Controllers/ProductController.php"
click node_cart "https://github.com/hoangle10ck-sys/cnpm_tmdt/blob/main/backend/app/Http/Controllers/CartController.php"
click node_checkout "https://github.com/hoangle10ck-sys/cnpm_tmdt/blob/main/backend/app/Http/Controllers/CheckoutController.php"
click node_customer_orders "https://github.com/hoangle10ck-sys/cnpm_tmdt/blob/main/backend/app/Http/Controllers/OrderController.php"
click node_customer_dashboard "https://github.com/hoangle10ck-sys/cnpm_tmdt/blob/main/backend/app/Http/Controllers/Customer/DashboardController.php"
click node_admin_products "https://github.com/hoangle10ck-sys/cnpm_tmdt/blob/main/backend/app/Http/Controllers/Admin/ProductController.php"
click node_admin_categories "https://github.com/hoangle10ck-sys/cnpm_tmdt/blob/main/backend/app/Http/Controllers/Admin/CategoryController.php"
click node_admin_orders "https://github.com/hoangle10ck-sys/cnpm_tmdt/blob/main/backend/app/Http/Controllers/Admin/OrderController.php"
click node_admin_customers "https://github.com/hoangle10ck-sys/cnpm_tmdt/blob/main/backend/app/Http/Controllers/Admin/UserController.php"
click node_admin_dashboard "https://github.com/hoangle10ck-sys/cnpm_tmdt/blob/main/backend/app/Http/Controllers/Admin/DashboardController.php"
click node_auth_routes "https://github.com/hoangle10ck-sys/cnpm_tmdt/blob/main/backend/routes/auth.php"
click node_auth_sessions "https://github.com/hoangle10ck-sys/cnpm_tmdt/blob/main/backend/app/Http/Controllers/Auth/AuthenticatedSessionController.php"
click node_user_profile "https://github.com/hoangle10ck-sys/cnpm_tmdt/blob/main/backend/app/Http/Controllers/ProfileController.php"
click node_product_model "https://github.com/hoangle10ck-sys/cnpm_tmdt/blob/main/backend/app/Models/Product.php"
click node_category_model "https://github.com/hoangle10ck-sys/cnpm_tmdt/blob/main/backend/app/Models/Category.php"
click node_cart_model "https://github.com/hoangle10ck-sys/cnpm_tmdt/blob/main/backend/app/Models/Cart.php"
click node_cart_item_model "https://github.com/hoangle10ck-sys/cnpm_tmdt/blob/main/backend/app/Models/CartItem.php"
click node_order_model "https://github.com/hoangle10ck-sys/cnpm_tmdt/blob/main/backend/app/Models/Order.php"
click node_order_item_model "https://github.com/hoangle10ck-sys/cnpm_tmdt/blob/main/backend/app/Models/OrderItem.php"
click node_user_model "https://github.com/hoangle10ck-sys/cnpm_tmdt/blob/main/backend/app/Models/User.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_home,node_product_browse toneBlue
class node_cart,node_checkout,node_customer_orders,node_customer_dashboard toneAmber
class node_admin_products,node_admin_categories,node_admin_orders,node_admin_customers,node_admin_dashboard toneMint
class node_auth_routes,node_auth_sessions,node_user_profile,node_product_model,node_category_model,node_cart_model,node_cart_item_model,node_order_model,node_order_item_model,node_user_model toneRose
class node_customer toneIndigo
```

## Components

### Storefront

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

### Cart and Orders

- [Cart Operations](https://github.com/hoangle10ck-sys/cnpm_tmdt/blob/main/backend/app/Http/Controllers/CartController.php): `backend/app/Http/Controllers/CartController.php`
- [Checkout](https://github.com/hoangle10ck-sys/cnpm_tmdt/blob/main/backend/app/Http/Controllers/CheckoutController.php): `backend/app/Http/Controllers/CheckoutController.php`
- [Customer Orders](https://github.com/hoangle10ck-sys/cnpm_tmdt/blob/main/backend/app/Http/Controllers/OrderController.php): `backend/app/Http/Controllers/OrderController.php`
- [Customer Dashboard](https://github.com/hoangle10ck-sys/cnpm_tmdt/blob/main/backend/app/Http/Controllers/Customer/DashboardController.php): `backend/app/Http/Controllers/Customer/DashboardController.php`

### Administration

- [Product Management](https://github.com/hoangle10ck-sys/cnpm_tmdt/blob/main/backend/app/Http/Controllers/Admin/ProductController.php): `backend/app/Http/Controllers/Admin/ProductController.php`
- [Category Management](https://github.com/hoangle10ck-sys/cnpm_tmdt/blob/main/backend/app/Http/Controllers/Admin/CategoryController.php): `backend/app/Http/Controllers/Admin/CategoryController.php`
- [Order Management](https://github.com/hoangle10ck-sys/cnpm_tmdt/blob/main/backend/app/Http/Controllers/Admin/OrderController.php): `backend/app/Http/Controllers/Admin/OrderController.php`
- [Customer Management](https://github.com/hoangle10ck-sys/cnpm_tmdt/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/blob/main/backend/app/Http/Controllers/Admin/DashboardController.php): `backend/app/Http/Controllers/Admin/DashboardController.php`

### Identity and Domain

- [Auth Routes](https://github.com/hoangle10ck-sys/cnpm_tmdt/blob/main/backend/routes/auth.php): `backend/routes/auth.php`
- [Registration and Login](https://github.com/hoangle10ck-sys/cnpm_tmdt/blob/main/backend/app/Http/Controllers/Auth/AuthenticatedSessionController.php): `backend/app/Http/Controllers/Auth/AuthenticatedSessionController.php`
- [Profile](https://github.com/hoangle10ck-sys/cnpm_tmdt/blob/main/backend/app/Http/Controllers/ProfileController.php): `backend/app/Http/Controllers/ProfileController.php`
- [Product Model](https://github.com/hoangle10ck-sys/cnpm_tmdt/blob/main/backend/app/Models/Product.php): `backend/app/Models/Product.php`
- [Category Model](https://github.com/hoangle10ck-sys/cnpm_tmdt/blob/main/backend/app/Models/Category.php): `backend/app/Models/Category.php`
- [Cart Model](https://github.com/hoangle10ck-sys/cnpm_tmdt/blob/main/backend/app/Models/Cart.php): `backend/app/Models/Cart.php`
- [Cart Item Model](https://github.com/hoangle10ck-sys/cnpm_tmdt/blob/main/backend/app/Models/CartItem.php): `backend/app/Models/CartItem.php`
- [Order Model](https://github.com/hoangle10ck-sys/cnpm_tmdt/blob/main/backend/app/Models/Order.php): `backend/app/Models/Order.php`
- [Order Item Model](https://github.com/hoangle10ck-sys/cnpm_tmdt/blob/main/backend/app/Models/OrderItem.php): `backend/app/Models/OrderItem.php`
- [User Model](https://github.com/hoangle10ck-sys/cnpm_tmdt/blob/main/backend/app/Models/User.php): `backend/app/Models/User.php`

### Other components

- **Customer**

## Connections

- Customer → Web Routes: sends requests
- Web Routes → Home: routes to (evidence: `backend/routes/web.php`)
- Web Routes → Product Browse: routes to (evidence: `backend/routes/web.php`)
- Web Routes → Cart Operations: 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`)
- Web Routes → Customer Dashboard: routes to (evidence: `backend/routes/web.php`)
- Web Routes → Product Management: routes to (evidence: `backend/routes/web.php`)
- Web Routes → Category Management: routes to (evidence: `backend/routes/web.php`)
- Web Routes → Order Management: routes to (evidence: `backend/routes/web.php`)
- Web Routes → Customer Management: routes to (evidence: `backend/routes/web.php`)
- Web Routes → Admin Dashboard: routes to (evidence: `backend/routes/web.php`)
- Web Routes → Auth Routes: includes (evidence: `backend/routes/web.php`)
- Auth Routes → Registration and Login: routes to (evidence: `backend/routes/auth.php`)
- Home → Product Model: queries (evidence: `backend/app/Http/Controllers/HomeController.php`)
- Home → Category Model: queries (evidence: `backend/app/Http/Controllers/HomeController.php`)
- Product Browse → Product Model: queries (evidence: `backend/app/Http/Controllers/ProductController.php`)
- Product Browse → Category Model: queries (evidence: `backend/app/Http/Controllers/ProductController.php`)
- Cart Operations → Cart Model: reads and writes (evidence: `backend/app/Http/Controllers/CartController.php`)
- Cart Operations → Cart Item Model: reads and writes (evidence: `backend/app/Http/Controllers/CartController.php`)
- Cart Operations → Product Model: checks stock (evidence: `backend/app/Http/Controllers/CartController.php`)
- Checkout → Cart Model: loads cart (evidence: `backend/app/Http/Controllers/CheckoutController.php`)
- Checkout → Product Model: checks and decrements (evidence: `backend/app/Http/Controllers/CheckoutController.php`)
- Checkout → Order Model: creates order (evidence: `backend/app/Http/Controllers/CheckoutController.php`)
- Customer Orders → Order Model: queries (evidence: `backend/app/Http/Controllers/OrderController.php`)
- Customer Dashboard → Order Model: summarizes (evidence: `backend/app/Http/Controllers/Customer/DashboardController.php`)
- Product Management → Product Model: manages (evidence: `backend/app/Http/Controllers/Admin/ProductController.php`)
- Product Management → Category Model: loads categories (evidence: `backend/app/Http/Controllers/Admin/ProductController.php`)
- Category Management → Category Model: manages (evidence: `backend/app/Http/Controllers/Admin/CategoryController.php`)
- Order Management → Order Model: updates status (evidence: `backend/app/Http/Controllers/Admin/OrderController.php`)
- Order Management → Product Model: restores stock (evidence: `backend/app/Http/Controllers/Admin/OrderController.php`)
- Customer Management → User Model: queries (evidence: `backend/app/Http/Controllers/Admin/UserController.php`)
- Customer Management → Order Model: queries (evidence: `backend/app/Http/Controllers/Admin/UserController.php`)
- Admin Dashboard → Product Model: summarizes (evidence: `backend/app/Http/Controllers/Admin/DashboardController.php`)
- Admin Dashboard → Category Model: summarizes (evidence: `backend/app/Http/Controllers/Admin/DashboardController.php`)
- Admin Dashboard → Order Model: summarizes (evidence: `backend/app/Http/Controllers/Admin/DashboardController.php`)
- Admin Dashboard → User Model: summarizes (evidence: `backend/app/Http/Controllers/Admin/DashboardController.php`)
- Profile → User Model: updates (evidence: `backend/app/Http/Controllers/ProfileController.php`)
- Cart Model → User Model: belongs to (evidence: `backend/app/Models/Cart.php`)
- Cart Model → Cart Item Model: has items (evidence: `backend/app/Models/Cart.php`)
- Order Model → User Model: belongs to (evidence: `backend/app/Models/Order.php`)
- Order Model → Order Item Model: has items (evidence: `backend/app/Models/Order.php`)
- Product Model → Category Model: belongs to (evidence: `backend/app/Models/Product.php`)
- Category Model → Product Model: has products (evidence: `backend/app/Models/Category.php`)
