# hoangnam2003-dau/kien-truc-auto-python-main architecture

> Architecture diagram of the GitHub repository hoangnam2003-dau/kien-truc-auto-python-main, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-29). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/hoangnam2003-dau/kien-truc-auto-python-main
- Repository: https://github.com/hoangnam2003-dau/kien-truc-auto-python-main

## Overview

This is a Flask car-dealership storefront and back office. Customers browse vehicles, manage a session cart, and submit an order or deposit; staff manage inventory, customers, orders, deposits, and reporting. The sampled source shows route handlers, SQLite access, cart JavaScript, and some template rendering; several route implementations are omitted, so uncertain template and subsystem wiring is not inferred.

Main entry points: [`app.py`](https://github.com/hoangnam2003-dau/kien-truc-auto-python-main/blob/main/app.py) (Flask routes), [`static/js/app.js`](https://github.com/hoangnam2003-dau/kien-truc-auto-python-main/blob/main/static/js/app.js) (Cart interactions), [`templates/trangchu.html`](https://github.com/hoangnam2003-dau/kien-truc-auto-python-main/blob/main/templates/trangchu.html) (Homepage), [`templates/catalog.html`](https://github.com/hoangnam2003-dau/kien-truc-auto-python-main/blob/main/templates/catalog.html) (Vehicle catalog)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_storefront["Vehicle storefront"]
  node_home["Homepage<br/>[trangchu.html]"]
  node_catalog["Vehicle catalog<br/>[catalog.html]"]
  node_vehicle["Vehicle details<br/>[chitietxe.html]"]
end

subgraph group_sales["Customer sales"]
  node_cart["Shopping cart<br/>[giohang.html]"]
  node_auth["Customer sign-in<br/>[customer_auth.html]"]
  node_register["Customer registration<br/>[register.html]"]
  node_account["Customer account"]
  node_invoice["Order invoice<br/>[invoice.html]"]
end

subgraph group_backoffice["Administration"]
  node_admincars["Vehicle management<br/>[admin_cars.html]"]
  node_admincustomers["Customer management"]
  node_adminorders["Order management<br/>[admin_orders.html]"]
  node_admindeposits["Deposit management"]
  node_reports["Sales reports<br/>[admin_reports.html]"]
end

subgraph group_runtime["Application runtime"]
  node_app["Flask routes<br/>[app.py]"]
  node_database[("Dealership data<br/>[app.py]")]
  node_cartjs["Cart interactions<br/>[app.js]"]
end

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

node_customer -->|"requests pages"| node_app
node_staff -->|"requests management"| node_app
node_app -->|"reads and writes"| node_database
node_app -->|"renders homepage"| node_home
node_app -->|"serves cart API"| node_cartjs
node_cartjs -->|"posts cart changes"| node_app
node_app -->|"returns cart count"| node_cartjs
node_app -->|"renders catalog"| node_catalog
node_app -->|"renders vehicle details"| node_vehicle
node_app -->|"renders cart"| node_cart
node_app -->|"renders sign-in"| node_auth
node_app -->|"handles registration"| node_register
node_app -->|"renders account"| node_account
node_app -->|"renders invoice"| node_invoice
node_app -->|"renders car admin"| node_admincars
node_app -->|"renders customer admin"| node_admincustomers
node_app -->|"renders order admin"| node_adminorders
node_app -->|"renders deposit admin"| node_admindeposits
node_app -->|"renders reports"| node_reports

click node_app "https://github.com/hoangnam2003-dau/kien-truc-auto-python-main/blob/main/app.py"
click node_database "https://github.com/hoangnam2003-dau/kien-truc-auto-python-main/blob/main/app.py"
click node_cartjs "https://github.com/hoangnam2003-dau/kien-truc-auto-python-main/blob/main/static/js/app.js"
click node_home "https://github.com/hoangnam2003-dau/kien-truc-auto-python-main/blob/main/templates/trangchu.html"
click node_catalog "https://github.com/hoangnam2003-dau/kien-truc-auto-python-main/blob/main/templates/catalog.html"
click node_vehicle "https://github.com/hoangnam2003-dau/kien-truc-auto-python-main/blob/main/templates/chitietxe.html"
click node_cart "https://github.com/hoangnam2003-dau/kien-truc-auto-python-main/blob/main/templates/giohang.html"
click node_auth "https://github.com/hoangnam2003-dau/kien-truc-auto-python-main/blob/main/templates/customer_auth.html"
click node_register "https://github.com/hoangnam2003-dau/kien-truc-auto-python-main/blob/main/templates/register.html"
click node_account "https://github.com/hoangnam2003-dau/kien-truc-auto-python-main/blob/main/templates/customer_account.html"
click node_invoice "https://github.com/hoangnam2003-dau/kien-truc-auto-python-main/blob/main/templates/invoice.html"
click node_admincars "https://github.com/hoangnam2003-dau/kien-truc-auto-python-main/blob/main/templates/admin_cars.html"
click node_admincustomers "https://github.com/hoangnam2003-dau/kien-truc-auto-python-main/blob/main/templates/admin_customers.html"
click node_adminorders "https://github.com/hoangnam2003-dau/kien-truc-auto-python-main/blob/main/templates/admin_orders.html"
click node_admindeposits "https://github.com/hoangnam2003-dau/kien-truc-auto-python-main/blob/main/templates/admin_deposits.html"
click node_reports "https://github.com/hoangnam2003-dau/kien-truc-auto-python-main/blob/main/templates/admin_reports.html"

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_home,node_catalog,node_vehicle toneBlue
class node_cart,node_auth,node_register,node_account,node_invoice toneAmber
class node_admincars,node_admincustomers,node_adminorders,node_admindeposits,node_reports toneMint
class node_app,node_database,node_cartjs toneRose
class node_customer,node_staff toneIndigo
```

## Components

### Vehicle storefront

- [Homepage](https://github.com/hoangnam2003-dau/kien-truc-auto-python-main/blob/main/templates/trangchu.html): `templates/trangchu.html`
- [Vehicle catalog](https://github.com/hoangnam2003-dau/kien-truc-auto-python-main/blob/main/templates/catalog.html): `templates/catalog.html`
- [Vehicle details](https://github.com/hoangnam2003-dau/kien-truc-auto-python-main/blob/main/templates/chitietxe.html): `templates/chitietxe.html`

### Customer sales

- [Shopping cart](https://github.com/hoangnam2003-dau/kien-truc-auto-python-main/blob/main/templates/giohang.html): `templates/giohang.html`
- [Customer sign-in](https://github.com/hoangnam2003-dau/kien-truc-auto-python-main/blob/main/templates/customer_auth.html): `templates/customer_auth.html`
- [Customer registration](https://github.com/hoangnam2003-dau/kien-truc-auto-python-main/blob/main/templates/register.html): `templates/register.html`
- [Customer account](https://github.com/hoangnam2003-dau/kien-truc-auto-python-main/blob/main/templates/customer_account.html): `templates/customer_account.html`
- [Order invoice](https://github.com/hoangnam2003-dau/kien-truc-auto-python-main/blob/main/templates/invoice.html): `templates/invoice.html`

### Administration

- [Vehicle management](https://github.com/hoangnam2003-dau/kien-truc-auto-python-main/blob/main/templates/admin_cars.html): `templates/admin_cars.html`
- [Customer management](https://github.com/hoangnam2003-dau/kien-truc-auto-python-main/blob/main/templates/admin_customers.html): `templates/admin_customers.html`
- [Order management](https://github.com/hoangnam2003-dau/kien-truc-auto-python-main/blob/main/templates/admin_orders.html): `templates/admin_orders.html`
- [Deposit management](https://github.com/hoangnam2003-dau/kien-truc-auto-python-main/blob/main/templates/admin_deposits.html): `templates/admin_deposits.html`
- [Sales reports](https://github.com/hoangnam2003-dau/kien-truc-auto-python-main/blob/main/templates/admin_reports.html): `templates/admin_reports.html`

### Application runtime

- [Flask routes](https://github.com/hoangnam2003-dau/kien-truc-auto-python-main/blob/main/app.py): `app.py`
- [Dealership data](https://github.com/hoangnam2003-dau/kien-truc-auto-python-main/blob/main/app.py): `app.py`
- [Cart interactions](https://github.com/hoangnam2003-dau/kien-truc-auto-python-main/blob/main/static/js/app.js): `static/js/app.js`

### Other components

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

## Connections

- Customer → Flask routes: requests pages
- Staff → Flask routes: requests management
- Flask routes → Dealership data: reads and writes
- Flask routes → Homepage: renders homepage
- Flask routes → Cart interactions: serves cart API
- Cart interactions → Flask routes: posts cart changes
- Flask routes → Cart interactions: returns cart count
- Flask routes → Vehicle catalog: renders catalog
- Flask routes → Vehicle details: renders vehicle details
- Flask routes → Shopping cart: renders cart
- Flask routes → Customer sign-in: renders sign-in
- Flask routes → Customer registration: handles registration
- Flask routes → Customer account: renders account
- Flask routes → Order invoice: renders invoice
- Flask routes → Vehicle management: renders car admin
- Flask routes → Customer management: renders customer admin
- Flask routes → Order management: renders order admin
- Flask routes → Deposit management: renders deposit admin
- Flask routes → Sales reports: renders reports