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

> Architecture diagram of the GitHub repository hoangnam2003-dau/kien-truc-auto-python, 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/hoangnam2003-dau/kien-truc-auto-python
- Repository: https://github.com/hoangnam2003-dau/kien-truc-auto-python

## Overview

This is a Flask car-sales storefront with customer accounts and an administration area. Customers browse cars, add them to a session cart, then place an order or make a deposit; staff manage cars, customers, orders, deposits, and reports. The central runtime and database access live together in app.py, with SQLite holding the domain records. The excerpts show only parts of the route implementation, so the graph preserves template-indicated capabilities but avoids guessing detailed links for unsampled routes.

Main entry points: [`app.py`](https://github.com/hoangnam2003-dau/kien-truc-auto-python/blob/main/app.py) (Flask routes), [`kientrucauto.db`](https://github.com/hoangnam2003-dau/kien-truc-auto-python/blob/main/kientrucauto.db) (SQLite records), [`static/js/app.js`](https://github.com/hoangnam2003-dau/kien-truc-auto-python/blob/main/static/js/app.js) (Cart and UI scripts), [`seed_db_current.py`](https://github.com/hoangnam2003-dau/kien-truc-auto-python/blob/main/seed_db_current.py) (Sample data seeder)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_storefront["Storefront"]
  node_webapp["Flask routes<br/>[app.py]"]
  node_catalog["Car catalog<br/>[catalog.html]"]
  node_home["Home page<br/>[trangchu.html]"]
  node_car_detail["Car details<br/>[chitietxe.html]"]
  node_cart["Shopping cart<br/>[giohang.html]"]
  node_browser_js["Cart and UI scripts<br/>[app.js]"]
end

subgraph group_customer["Customer"]
  node_auth["Login and registration<br/>[customer_auth.html]"]
  node_account["Customer account"]
  node_orders["Orders and invoices<br/>[invoice.html]"]
end

subgraph group_operations["Administration"]
  node_admin_cars["Car management<br/>[admin_cars.html]"]
  node_admin_customers["Customer management"]
  node_admin_orders["Order management<br/>[admin_orders.html]"]
  node_admin_deposits["Deposit management"]
  node_admin_reports["Sales reports<br/>[admin_reports.html]"]
end

subgraph group_persistence["Persistence"]
  node_seed_data["Sample data seeder<br/>[seed_db_current.py]"]
  node_sqlite[("SQLite records<br/>[kientrucauto.db]")]
end

node_visitor(("Shop visitor"))

node_visitor -->|"browses and submits"| node_webapp
node_webapp -->|"renders"| node_home
node_webapp -->|"renders"| node_catalog
node_webapp -.->|"renders"| node_car_detail
node_webapp -.->|"renders"| node_cart
node_browser_js -->|"posts cart actions"| node_webapp
node_webapp -.->|"renders"| node_auth
node_webapp -.->|"renders"| node_account
node_webapp -.->|"renders"| node_orders
node_webapp -.->|"renders"| node_admin_cars
node_webapp -.->|"renders"| node_admin_customers
node_webapp -.->|"renders"| node_admin_orders
node_webapp -.->|"renders"| node_admin_deposits
node_webapp -.->|"renders"| node_admin_reports
node_webapp -->|"reads and writes"| node_sqlite
node_seed_data -->|"seeds records"| node_sqlite

click node_webapp "https://github.com/hoangnam2003-dau/kien-truc-auto-python/blob/main/app.py"
click node_catalog "https://github.com/hoangnam2003-dau/kien-truc-auto-python/blob/main/templates/catalog.html"
click node_home "https://github.com/hoangnam2003-dau/kien-truc-auto-python/blob/main/templates/trangchu.html"
click node_car_detail "https://github.com/hoangnam2003-dau/kien-truc-auto-python/blob/main/templates/chitietxe.html"
click node_cart "https://github.com/hoangnam2003-dau/kien-truc-auto-python/blob/main/templates/giohang.html"
click node_browser_js "https://github.com/hoangnam2003-dau/kien-truc-auto-python/blob/main/static/js/app.js"
click node_auth "https://github.com/hoangnam2003-dau/kien-truc-auto-python/blob/main/templates/customer_auth.html"
click node_account "https://github.com/hoangnam2003-dau/kien-truc-auto-python/blob/main/templates/customer_account.html"
click node_orders "https://github.com/hoangnam2003-dau/kien-truc-auto-python/blob/main/templates/invoice.html"
click node_admin_cars "https://github.com/hoangnam2003-dau/kien-truc-auto-python/blob/main/templates/admin_cars.html"
click node_admin_customers "https://github.com/hoangnam2003-dau/kien-truc-auto-python/blob/main/templates/admin_customers.html"
click node_admin_orders "https://github.com/hoangnam2003-dau/kien-truc-auto-python/blob/main/templates/admin_orders.html"
click node_admin_deposits "https://github.com/hoangnam2003-dau/kien-truc-auto-python/blob/main/templates/admin_deposits.html"
click node_admin_reports "https://github.com/hoangnam2003-dau/kien-truc-auto-python/blob/main/templates/admin_reports.html"
click node_seed_data "https://github.com/hoangnam2003-dau/kien-truc-auto-python/blob/main/seed_db_current.py"
click node_sqlite "https://github.com/hoangnam2003-dau/kien-truc-auto-python/blob/main/kientrucauto.db"

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_webapp,node_catalog,node_home,node_car_detail,node_cart,node_browser_js toneBlue
class node_auth,node_account,node_orders toneAmber
class node_admin_cars,node_admin_customers,node_admin_orders,node_admin_deposits,node_admin_reports toneMint
class node_seed_data,node_sqlite toneRose
class node_visitor toneIndigo
```

## Components

### Storefront

- [Flask routes](https://github.com/hoangnam2003-dau/kien-truc-auto-python/blob/main/app.py): `app.py`
- [Car catalog](https://github.com/hoangnam2003-dau/kien-truc-auto-python/blob/main/templates/catalog.html): `templates/catalog.html`
- [Home page](https://github.com/hoangnam2003-dau/kien-truc-auto-python/blob/main/templates/trangchu.html): `templates/trangchu.html`
- [Car details](https://github.com/hoangnam2003-dau/kien-truc-auto-python/blob/main/templates/chitietxe.html): `templates/chitietxe.html`
- [Shopping cart](https://github.com/hoangnam2003-dau/kien-truc-auto-python/blob/main/templates/giohang.html): `templates/giohang.html`
- [Cart and UI scripts](https://github.com/hoangnam2003-dau/kien-truc-auto-python/blob/main/static/js/app.js): `static/js/app.js`

### Customer

- [Login and registration](https://github.com/hoangnam2003-dau/kien-truc-auto-python/blob/main/templates/customer_auth.html): `templates/customer_auth.html`
- [Customer account](https://github.com/hoangnam2003-dau/kien-truc-auto-python/blob/main/templates/customer_account.html): `templates/customer_account.html`
- [Orders and invoices](https://github.com/hoangnam2003-dau/kien-truc-auto-python/blob/main/templates/invoice.html): `templates/invoice.html`

### Administration

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

### Persistence

- [Sample data seeder](https://github.com/hoangnam2003-dau/kien-truc-auto-python/blob/main/seed_db_current.py): `seed_db_current.py`
- [SQLite records](https://github.com/hoangnam2003-dau/kien-truc-auto-python/blob/main/kientrucauto.db): `kientrucauto.db`

### Other components

- **Shop visitor**

## Connections

- Shop visitor → Flask routes: browses and submits (evidence: `app.py`)
- Flask routes → Home page: renders (evidence: `app.py`)
- Flask routes → Car catalog: renders (evidence: `app.py`)
- Flask routes → Car details: renders
- Flask routes → Shopping cart: renders
- Cart and UI scripts → Flask routes: posts cart actions (evidence: `static/js/app.js`)
- Flask routes → Login and registration: renders
- Flask routes → Customer account: renders
- Flask routes → Orders and invoices: renders
- Flask routes → Car management: renders
- Flask routes → Customer management: renders
- Flask routes → Order management: renders
- Flask routes → Deposit management: renders
- Flask routes → Sales reports: renders
- Flask routes → SQLite records: reads and writes (evidence: `app.py`)
- Sample data seeder → SQLite records: seeds records (evidence: `seed_db_current.py`)
