# neeradian/fleet_manager architecture

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

- Interactive diagram: https://gitdiagram.com/neeradian/fleet_manager
- Repository: https://github.com/neeradian/fleet_manager

## Overview

FleetTrack Pro is a Django fleet-management web app. Users authenticate, then manage vehicles and their RTO, tyre, service, and fuel records; dashboard and filtered reports summarize fleet state. Views own request handling and use forms and models, while the models persist records and implement fuel calculations and odometer synchronization. The README documents role permissions, audit fields, uploaded RTO documents, and presentation behavior; sampled excerpts do not expose every view implementation, so those feature-level relationships are documented rather than inferred from unsampled code.

Main entry points: [`vehicles/views.py`](https://github.com/neeradian/fleet_manager/blob/main/vehicles/views.py) (Request views), [`vehicles/forms.py`](https://github.com/neeradian/fleet_manager/blob/main/vehicles/forms.py) (Input forms), [`fleet_manager/settings.py`](https://github.com/neeradian/fleet_manager/blob/main/fleet_manager/settings.py) (SQLite database), [`static/js/fleet.js`](https://github.com/neeradian/fleet_manager/blob/main/static/js/fleet.js) (Browser interactions)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web interface"]
  node_routes["HTTP routes<br/>[urls.py]"]
  node_views["Request views<br/>[views.py]"]
  node_forms["Input forms<br/>[forms.py]"]
  node_templates["Page templates"]
  node_static_ui["Browser interactions<br/>[fleet.js]"]
  node_fleet_css["Fleet styles<br/>[fleet.css]"]
end

subgraph group_records["Fleet records"]
  node_identity["Users and roles<br/>[models.py]"]
  node_vehicles["Vehicle records<br/>[models.py]"]
  node_rto["RTO compliance<br/>[models.py]"]
  node_rto_docs["RTO documents<br/>[models.py]"]
  node_tyres["Tyre history<br/>[models.py]"]
  node_services["Service history<br/>[models.py]"]
  node_fuel["Fuel history<br/>[models.py]"]
end

subgraph group_insights["Fleet insights"]
  node_dashboard["Fleet dashboard<br/>[views.py]"]
  node_reports["Filtered reports<br/>[views.py]"]
end

subgraph group_persistence["Persistence"]
  node_database[("SQLite database<br/>[settings.py]")]
  node_media[("Uploaded documents<br/>[settings.py]")]
end

node_user(("Fleet user"))

node_user -->|"requests pages"| node_routes
node_routes -->|"dispatches to"| node_views
node_views -->|"uses forms"| node_forms
node_views -->|"renders pages"| node_templates
node_views -->|"manages accounts"| node_identity
node_views -->|"manages fleet"| node_vehicles
node_views -->|"manages compliance"| node_rto
node_views -->|"uploads documents"| node_rto_docs
node_views -->|"manages records"| node_tyres
node_views -->|"manages records"| node_services
node_views -->|"manages records"| node_fuel
node_views -->|"builds overview"| node_dashboard
node_views -->|"builds reports"| node_reports
node_forms -->|"validates user data"| node_identity
node_forms -->|"validates vehicle data"| node_vehicles
node_forms -->|"validates RTO data"| node_rto
node_forms -->|"validates uploads"| node_rto_docs
node_forms -->|"validates tyre data"| node_tyres
node_forms -->|"validates service data"| node_services
node_forms -->|"validates fuel data"| node_fuel
node_forms -->|"filters reports"| node_reports
node_static_ui -->|"previews totals"| node_fuel
node_static_ui -->|"supports file upload"| node_rto_docs
node_static_ui -->|"toggles sections"| node_reports
node_templates -->|"loads styles"| node_fleet_css
node_templates -->|"loads scripts"| node_static_ui
node_views -.->|"reads and writes"| node_database
node_vehicles -.->|"stores vehicle state"| node_database
node_rto -.->|"stores compliance data"| node_database
node_rto_docs -->|"stores uploaded files"| node_media
node_tyres -.->|"stores tyre history"| node_database
node_services -.->|"stores service history"| node_database
node_fuel -.->|"stores fuel history"| node_database

click node_routes "https://github.com/neeradian/fleet_manager/blob/main/vehicles/urls.py"
click node_views "https://github.com/neeradian/fleet_manager/blob/main/vehicles/views.py"
click node_forms "https://github.com/neeradian/fleet_manager/blob/main/vehicles/forms.py"
click node_templates "https://github.com/neeradian/fleet_manager/tree/main/vehicles/templates/vehicles"
click node_static_ui "https://github.com/neeradian/fleet_manager/blob/main/static/js/fleet.js"
click node_fleet_css "https://github.com/neeradian/fleet_manager/blob/main/static/css/fleet.css"
click node_identity "https://github.com/neeradian/fleet_manager/blob/main/vehicles/models.py"
click node_vehicles "https://github.com/neeradian/fleet_manager/blob/main/vehicles/models.py"
click node_rto "https://github.com/neeradian/fleet_manager/blob/main/vehicles/models.py"
click node_rto_docs "https://github.com/neeradian/fleet_manager/blob/main/vehicles/models.py"
click node_tyres "https://github.com/neeradian/fleet_manager/blob/main/vehicles/models.py"
click node_services "https://github.com/neeradian/fleet_manager/blob/main/vehicles/models.py"
click node_fuel "https://github.com/neeradian/fleet_manager/blob/main/vehicles/models.py"
click node_dashboard "https://github.com/neeradian/fleet_manager/blob/main/vehicles/views.py"
click node_reports "https://github.com/neeradian/fleet_manager/blob/main/vehicles/views.py"
click node_database "https://github.com/neeradian/fleet_manager/blob/main/fleet_manager/settings.py"
click node_media "https://github.com/neeradian/fleet_manager/blob/main/fleet_manager/settings.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_routes,node_views,node_forms,node_templates,node_static_ui,node_fleet_css,node_user toneBlue
class node_identity,node_vehicles,node_rto,node_rto_docs,node_tyres,node_services,node_fuel toneAmber
class node_dashboard,node_reports toneMint
class node_database,node_media toneRose
```

## Components

### Web interface

- [HTTP routes](https://github.com/neeradian/fleet_manager/blob/main/vehicles/urls.py): `vehicles/urls.py`
- [Request views](https://github.com/neeradian/fleet_manager/blob/main/vehicles/views.py): `vehicles/views.py`
- [Input forms](https://github.com/neeradian/fleet_manager/blob/main/vehicles/forms.py): `vehicles/forms.py`
- [Page templates](https://github.com/neeradian/fleet_manager/tree/main/vehicles/templates/vehicles): `vehicles/templates/vehicles`
- [Browser interactions](https://github.com/neeradian/fleet_manager/blob/main/static/js/fleet.js): `static/js/fleet.js`
- [Fleet styles](https://github.com/neeradian/fleet_manager/blob/main/static/css/fleet.css): `static/css/fleet.css`

### Fleet records

- [Users and roles](https://github.com/neeradian/fleet_manager/blob/main/vehicles/models.py): `vehicles/models.py`
- [Vehicle records](https://github.com/neeradian/fleet_manager/blob/main/vehicles/models.py): `vehicles/models.py`
- [RTO compliance](https://github.com/neeradian/fleet_manager/blob/main/vehicles/models.py): `vehicles/models.py`
- [RTO documents](https://github.com/neeradian/fleet_manager/blob/main/vehicles/models.py): `vehicles/models.py`
- [Tyre history](https://github.com/neeradian/fleet_manager/blob/main/vehicles/models.py): `vehicles/models.py`
- [Service history](https://github.com/neeradian/fleet_manager/blob/main/vehicles/models.py): `vehicles/models.py`
- [Fuel history](https://github.com/neeradian/fleet_manager/blob/main/vehicles/models.py): `vehicles/models.py`

### Fleet insights

- [Fleet dashboard](https://github.com/neeradian/fleet_manager/blob/main/vehicles/views.py): `vehicles/views.py`
- [Filtered reports](https://github.com/neeradian/fleet_manager/blob/main/vehicles/views.py): `vehicles/views.py`

### Persistence

- [SQLite database](https://github.com/neeradian/fleet_manager/blob/main/fleet_manager/settings.py): `fleet_manager/settings.py`
- [Uploaded documents](https://github.com/neeradian/fleet_manager/blob/main/fleet_manager/settings.py): `fleet_manager/settings.py`

### Other components

- **Fleet user**

## Connections

- Fleet user → HTTP routes: requests pages (evidence: `vehicles/urls.py`)
- HTTP routes → Request views: dispatches to (evidence: `vehicles/urls.py`)
- Request views → Input forms: uses forms (evidence: `vehicles/views.py`)
- Request views → Page templates: renders pages (evidence: `vehicles/views.py`)
- Request views → Users and roles: manages accounts (evidence: `vehicles/views.py`)
- Request views → Vehicle records: manages fleet (evidence: `vehicles/views.py`)
- Request views → RTO compliance: manages compliance (evidence: `README.md`)
- Request views → RTO documents: uploads documents (evidence: `README.md`)
- Request views → Tyre history: manages records (evidence: `README.md`)
- Request views → Service history: manages records (evidence: `vehicles/views.py`)
- Request views → Fuel history: manages records (evidence: `vehicles/views.py`)
- Request views → Fleet dashboard: builds overview (evidence: `vehicles/views.py`)
- Request views → Filtered reports: builds reports (evidence: `vehicles/views.py`)
- Input forms → Users and roles: validates user data (evidence: `vehicles/forms.py`)
- Input forms → Vehicle records: validates vehicle data (evidence: `vehicles/forms.py`)
- Input forms → RTO compliance: validates RTO data (evidence: `vehicles/forms.py`)
- Input forms → RTO documents: validates uploads (evidence: `vehicles/forms.py`)
- Input forms → Tyre history: validates tyre data (evidence: `vehicles/forms.py`)
- Input forms → Service history: validates service data (evidence: `vehicles/forms.py`)
- Input forms → Fuel history: validates fuel data (evidence: `vehicles/forms.py`)
- Input forms → Filtered reports: filters reports (evidence: `vehicles/forms.py`)
- Browser interactions → Fuel history: previews totals (evidence: `README.md`)
- Browser interactions → RTO documents: supports file upload (evidence: `README.md`)
- Browser interactions → Filtered reports: toggles sections (evidence: `README.md`)
- Page templates → Fleet styles: loads styles (evidence: `README.md`)
- Page templates → Browser interactions: loads scripts (evidence: `README.md`)
- Request views → SQLite database: reads and writes
- Vehicle records → SQLite database: stores vehicle state
- RTO compliance → SQLite database: stores compliance data
- RTO documents → Uploaded documents: stores uploaded files (evidence: `fleet_manager/settings.py`)
- Tyre history → SQLite database: stores tyre history
- Service history → SQLite database: stores service history
- Fuel history → SQLite database: stores fuel history
