# peterlevis3327/vehicle-website architecture

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

- Interactive diagram: https://gitdiagram.com/peterlevis3327/vehicle-website
- Repository: https://github.com/peterlevis3327/vehicle-website

## Overview

This is a PHP vehicle-marketing catalog with a JavaScript browser UI and a small admin workflow. Visitors can load the vehicle gallery, search by vehicle type, or filter by price; the browser calls the corresponding PHP endpoint, which queries MySQL and returns JSON for display. Administrators log in using a PHP session, reach the vehicle-entry form, and submit vehicle details and an image for insertion. The graph covers the sampled runtime; the README is empty, and unsampled frontend pages and backend files are not assumed to add capabilities.

Main entry points: [`backend/config.php`](https://github.com/peterlevis3327/vehicle-website/blob/main/backend/config.php) (DB connection), [`frontend/script.js`](https://github.com/peterlevis3327/vehicle-website/blob/main/frontend/script.js) (Catalog UI), [`backend/get_vehicles.php`](https://github.com/peterlevis3327/vehicle-website/blob/main/backend/get_vehicles.php) (List vehicles), [`backend/search_vehicles.php`](https://github.com/peterlevis3327/vehicle-website/blob/main/backend/search_vehicles.php) (Search vehicles)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_browser["Browser catalog"]
  node_catalog_ui["Catalog UI<br/>[script.js]"]
  node_gallery["Vehicle gallery<br/>[script.js]"]
end

subgraph group_admin["Admin workflow"]
  node_login["Admin login<br/>[login.php]"]
  node_admin_form["Vehicle form<br/>[admin.php]"]
end

subgraph group_backend["PHP and storage"]
  node_add_vehicle["Vehicle upload<br/>[add_vehicle.php]"]
  node_get_vehicles["List vehicles<br/>[get_vehicles.php]"]
  node_search_vehicles["Search vehicles"]
  node_filter_price["Price filter"]
  node_db_config["DB connection<br/>[config.php]"]
  node_vehicle_db[("Vehicle database")]
end

node_visitor(("Visitor"))

node_catalog_ui -->|"fetches list"| node_get_vehicles
node_catalog_ui -->|"searches by type"| node_search_vehicles
node_catalog_ui -->|"filters prices"| node_filter_price
node_get_vehicles -->|"includes connection"| node_db_config
node_search_vehicles -->|"includes connection"| node_db_config
node_filter_price -->|"includes connection"| node_db_config
node_add_vehicle -->|"includes connection"| node_db_config
node_db_config -->|"opens MySQL connection"| node_vehicle_db
node_get_vehicles -->|"queries vehicles"| node_vehicle_db
node_search_vehicles -->|"searches vehicles"| node_vehicle_db
node_filter_price -->|"filters vehicles"| node_vehicle_db
node_add_vehicle -->|"inserts vehicle"| node_vehicle_db
node_catalog_ui -->|"renders results"| node_gallery
node_login -->|"redirects after login"| node_admin_form
node_admin_form -->|"submits vehicle form"| node_add_vehicle

click node_catalog_ui "https://github.com/peterlevis3327/vehicle-website/blob/main/frontend/script.js"
click node_gallery "https://github.com/peterlevis3327/vehicle-website/blob/main/frontend/script.js"
click node_login "https://github.com/peterlevis3327/vehicle-website/blob/main/frontend/login.php"
click node_admin_form "https://github.com/peterlevis3327/vehicle-website/blob/main/frontend/admin.php"
click node_add_vehicle "https://github.com/peterlevis3327/vehicle-website/blob/main/backend/add_vehicle.php"
click node_get_vehicles "https://github.com/peterlevis3327/vehicle-website/blob/main/backend/get_vehicles.php"
click node_search_vehicles "https://github.com/peterlevis3327/vehicle-website/blob/main/backend/search_vehicles.php"
click node_filter_price "https://github.com/peterlevis3327/vehicle-website/blob/main/backend/filter_by_price.php"
click node_db_config "https://github.com/peterlevis3327/vehicle-website/blob/main/backend/config.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_catalog_ui,node_gallery toneBlue
class node_login,node_admin_form toneAmber
class node_add_vehicle,node_get_vehicles,node_search_vehicles,node_filter_price,node_db_config,node_vehicle_db toneMint
class node_visitor toneIndigo
```

## Components

### Browser catalog

- [Catalog UI](https://github.com/peterlevis3327/vehicle-website/blob/main/frontend/script.js): `frontend/script.js`
- [Vehicle gallery](https://github.com/peterlevis3327/vehicle-website/blob/main/frontend/script.js): `frontend/script.js`

### Admin workflow

- [Admin login](https://github.com/peterlevis3327/vehicle-website/blob/main/frontend/login.php): `frontend/login.php`
- [Vehicle form](https://github.com/peterlevis3327/vehicle-website/blob/main/frontend/admin.php): `frontend/admin.php`

### PHP and storage

- [Vehicle upload](https://github.com/peterlevis3327/vehicle-website/blob/main/backend/add_vehicle.php): `backend/add_vehicle.php`
- [List vehicles](https://github.com/peterlevis3327/vehicle-website/blob/main/backend/get_vehicles.php): `backend/get_vehicles.php`
- [Search vehicles](https://github.com/peterlevis3327/vehicle-website/blob/main/backend/search_vehicles.php): `backend/search_vehicles.php`
- [Price filter](https://github.com/peterlevis3327/vehicle-website/blob/main/backend/filter_by_price.php): `backend/filter_by_price.php`
- [DB connection](https://github.com/peterlevis3327/vehicle-website/blob/main/backend/config.php): `backend/config.php`
- **Vehicle database**

### Other components

- **Visitor**

## Connections

- Catalog UI → List vehicles: fetches list (evidence: `frontend/script.js`)
- Catalog UI → Search vehicles: searches by type (evidence: `frontend/script.js`)
- Catalog UI → Price filter: filters prices (evidence: `frontend/script.js`)
- List vehicles → DB connection: includes connection (evidence: `backend/get_vehicles.php`)
- Search vehicles → DB connection: includes connection (evidence: `backend/search_vehicles.php`)
- Price filter → DB connection: includes connection (evidence: `backend/filter_by_price.php`)
- Vehicle upload → DB connection: includes connection (evidence: `backend/add_vehicle.php`)
- DB connection → Vehicle database: opens MySQL connection (evidence: `backend/config.php`)
- List vehicles → Vehicle database: queries vehicles (evidence: `backend/get_vehicles.php`)
- Search vehicles → Vehicle database: searches vehicles (evidence: `backend/search_vehicles.php`)
- Price filter → Vehicle database: filters vehicles (evidence: `backend/filter_by_price.php`)
- Vehicle upload → Vehicle database: inserts vehicle (evidence: `backend/add_vehicle.php`)
- Catalog UI → Vehicle gallery: renders results (evidence: `frontend/script.js`)
- Admin login → Vehicle form: redirects after login (evidence: `frontend/login.php`)
- Vehicle form → Vehicle upload: submits vehicle form (evidence: `frontend/admin.php`)
