# vinci404/mdce-finals architecture

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

- Interactive diagram: https://gitdiagram.com/vinci404/mdce-finals
- Repository: https://github.com/vinci404/mdce-finals

## Overview

MDCE FleetHub is an administrator-facing Flask application for managing fleet records and related documents, repairs, and activity. Administrators log in, use the application’s record workflows, and retain structured data in MySQL and uploaded files in file storage. The graph separates account and access workflows, fleet records, documents/OCR, and issues, with validation and persistence as shared internal layers. README documents capabilities beyond the sampled routes; unsampled relationships are omitted rather than inferred.

Main entry points: [`database/mdce_fleethub.sql`](https://github.com/vinci404/mdce-finals/blob/main/database/mdce_fleethub.sql) (MySQL records), [`app.py`](https://github.com/vinci404/mdce-finals/blob/main/app.py) (Request handling), [`db.py`](https://github.com/vinci404/mdce-finals/blob/main/db.py) (Database connection), [`templates`](https://github.com/vinci404/mdce-finals/tree/main/templates) (Fleet profiles)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_accounts["Accounts and access"]
  node_account_workflows["Admin accounts<br/>[app.py]"]
  node_account_profile["Admin profile<br/>[app.py]"]
  node_access_control["Login protection<br/>[app.py]"]
  node_email_service["Email service"]
end

subgraph group_fleet["FleetHub records"]
  node_fleet_records["Jeep records<br/>[app.py]"]
  node_driver_records["Driver records<br/>[app.py]"]
  node_fleet_profiles["Fleet profiles"]
  node_search["Record search<br/>[app.py]"]
end

subgraph group_documents["DockTrack documents"]
  node_documents["Document records<br/>[app.py]"]
  node_document_ui["Document preview and OCR UI<br/>[doc_preview.js]"]
  node_uploaded_files["Uploaded files"]
end

subgraph group_issues["IssueTrack repairs"]
  node_issues["Issue records<br/>[app.py]"]
  node_activity["Activity log<br/>[app.py]"]
end

subgraph group_shared["Shared application services"]
  node_flask_app["Request handling<br/>[app.py]"]
  node_form_validation["Form validation<br/>[validators.py]"]
  node_live_checks["Live field checks<br/>[forms.js]"]
  node_mysql[("MySQL records<br/>[mdce_fleethub.sql]")]
  node_database_connection["Database connection<br/>[db.py]"]
end

node_admin(("Administrator"))

node_admin -->|"submits requests"| node_flask_app
node_flask_app -->|"guards routes"| node_access_control
node_admin -->|"manages account"| node_account_workflows
node_admin -->|"updates profile"| node_account_profile
node_account_workflows -.->|"sends reset links"| node_email_service
node_admin -->|"maintains fleet"| node_fleet_records
node_admin -->|"maintains drivers"| node_driver_records
node_fleet_records -.->|"renders profiles"| node_fleet_profiles
node_driver_records -.->|"renders profiles"| node_fleet_profiles
node_admin -->|"manages documents"| node_documents
node_document_ui -->|"requests OCR"| node_documents
node_documents -->|"stores files"| node_uploaded_files
node_admin -->|"records repairs"| node_issues
node_admin -->|"reviews activity"| node_activity
node_flask_app -->|"validates input"| node_form_validation
node_live_checks -->|"checks fields"| node_flask_app
node_flask_app -->|"opens connection"| node_database_connection
node_database_connection -->|"connects to"| node_mysql
node_flask_app -->|"reads and writes"| node_mysql
node_fleet_records -->|"stores records"| node_mysql
node_driver_records -->|"stores records"| node_mysql
node_documents -->|"stores metadata"| node_mysql
node_issues -->|"stores reports"| node_mysql
node_activity -.->|"records actions"| node_mysql

click node_account_workflows "https://github.com/vinci404/mdce-finals/blob/main/app.py"
click node_account_profile "https://github.com/vinci404/mdce-finals/blob/main/app.py"
click node_access_control "https://github.com/vinci404/mdce-finals/blob/main/app.py"
click node_fleet_records "https://github.com/vinci404/mdce-finals/blob/main/app.py"
click node_driver_records "https://github.com/vinci404/mdce-finals/blob/main/app.py"
click node_fleet_profiles "https://github.com/vinci404/mdce-finals/tree/main/templates"
click node_search "https://github.com/vinci404/mdce-finals/blob/main/app.py"
click node_documents "https://github.com/vinci404/mdce-finals/blob/main/app.py"
click node_document_ui "https://github.com/vinci404/mdce-finals/blob/main/static/js/doc_preview.js"
click node_uploaded_files "https://github.com/vinci404/mdce-finals/tree/main/static/uploads"
click node_issues "https://github.com/vinci404/mdce-finals/blob/main/app.py"
click node_activity "https://github.com/vinci404/mdce-finals/blob/main/app.py"
click node_flask_app "https://github.com/vinci404/mdce-finals/blob/main/app.py"
click node_form_validation "https://github.com/vinci404/mdce-finals/blob/main/validators.py"
click node_live_checks "https://github.com/vinci404/mdce-finals/blob/main/static/js/forms.js"
click node_mysql "https://github.com/vinci404/mdce-finals/blob/main/database/mdce_fleethub.sql"
click node_database_connection "https://github.com/vinci404/mdce-finals/blob/main/db.py"

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_account_workflows,node_account_profile,node_access_control,node_email_service toneBlue
class node_fleet_records,node_driver_records,node_fleet_profiles,node_search toneAmber
class node_documents,node_document_ui,node_uploaded_files toneMint
class node_issues,node_activity toneRose
class node_flask_app,node_form_validation,node_live_checks,node_mysql,node_database_connection,node_admin toneIndigo
```

## Components

### Accounts and access

- [Admin accounts](https://github.com/vinci404/mdce-finals/blob/main/app.py): `app.py`
- [Admin profile](https://github.com/vinci404/mdce-finals/blob/main/app.py): `app.py`
- [Login protection](https://github.com/vinci404/mdce-finals/blob/main/app.py): `app.py`
- **Email service**

### FleetHub records

- [Jeep records](https://github.com/vinci404/mdce-finals/blob/main/app.py): `app.py`
- [Driver records](https://github.com/vinci404/mdce-finals/blob/main/app.py): `app.py`
- [Fleet profiles](https://github.com/vinci404/mdce-finals/tree/main/templates): `templates`
- [Record search](https://github.com/vinci404/mdce-finals/blob/main/app.py): `app.py`

### DockTrack documents

- [Document records](https://github.com/vinci404/mdce-finals/blob/main/app.py): `app.py`
- [Document preview and OCR UI](https://github.com/vinci404/mdce-finals/blob/main/static/js/doc_preview.js): `static/js/doc_preview.js`
- [Uploaded files](https://github.com/vinci404/mdce-finals/tree/main/static/uploads): `static/uploads`

### IssueTrack repairs

- [Issue records](https://github.com/vinci404/mdce-finals/blob/main/app.py): `app.py`
- [Activity log](https://github.com/vinci404/mdce-finals/blob/main/app.py): `app.py`

### Shared application services

- [Request handling](https://github.com/vinci404/mdce-finals/blob/main/app.py): `app.py`
- [Form validation](https://github.com/vinci404/mdce-finals/blob/main/validators.py): `validators.py`
- [Live field checks](https://github.com/vinci404/mdce-finals/blob/main/static/js/forms.js): `static/js/forms.js`
- [MySQL records](https://github.com/vinci404/mdce-finals/blob/main/database/mdce_fleethub.sql): `database/mdce_fleethub.sql`
- [Database connection](https://github.com/vinci404/mdce-finals/blob/main/db.py): `db.py`

### Other components

- **Administrator**

## Connections

- Administrator → Request handling: submits requests (evidence: `README.md`)
- Request handling → Login protection: guards routes (evidence: `app.py`)
- Administrator → Admin accounts: manages account (evidence: `README.md`)
- Administrator → Admin profile: updates profile (evidence: `README.md`)
- Admin accounts → Email service: sends reset links (evidence: `README.md`)
- Administrator → Jeep records: maintains fleet (evidence: `README.md`)
- Administrator → Driver records: maintains drivers (evidence: `README.md`)
- Jeep records → Fleet profiles: renders profiles (evidence: `README.md`)
- Driver records → Fleet profiles: renders profiles (evidence: `README.md`)
- Administrator → Document records: manages documents (evidence: `README.md`)
- Document preview and OCR UI → Document records: requests OCR (evidence: `static/js/doc_preview.js`)
- Document records → Uploaded files: stores files (evidence: `README.md`)
- Administrator → Issue records: records repairs (evidence: `README.md`)
- Administrator → Activity log: reviews activity (evidence: `README.md`)
- Request handling → Form validation: validates input (evidence: `app.py`)
- Live field checks → Request handling: checks fields (evidence: `static/js/forms.js`)
- Request handling → Database connection: opens connection (evidence: `app.py`)
- Database connection → MySQL records: connects to (evidence: `db.py`)
- Request handling → MySQL records: reads and writes (evidence: `README.md`)
- Jeep records → MySQL records: stores records (evidence: `README.md`)
- Driver records → MySQL records: stores records (evidence: `README.md`)
- Document records → MySQL records: stores metadata (evidence: `README.md`)
- Issue records → MySQL records: stores reports (evidence: `README.md`)
- Activity log → MySQL records: records actions (evidence: `README.md`)
