# paduladiego/aerocar architecture

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

- Interactive diagram: https://gitdiagram.com/paduladiego/aerocar
- Repository: https://github.com/paduladiego/aerocar

## Overview

AeroCar is a Flask fleet-management application for corporate users and facilities staff. Users authenticate, request driver approval, reserve vehicles, and complete check-in/check-out; facilities manage vehicles, drivers, and units, while the system also supports carpools, incident/fine tracking, auditing, and administration. The model layer provides shared SQLAlchemy domain entities, with PostgreSQL as the documented database. The scheduler handles abandoned bookings and daily fleet alerts. Relationships among registered blueprints and sampled modules are supported by the app excerpt and SOURCE INDEX; unsampled route behavior is not inferred beyond documented capabilities.

Main entry points: [`app.py`](https://github.com/paduladiego/aerocar/blob/main/app.py) (Flask application), [`models.py`](https://github.com/paduladiego/aerocar/blob/main/models.py) (Fleet domain models), [`routes/auth.py`](https://github.com/paduladiego/aerocar/blob/main/routes/auth.py) (Authentication), [`utils/scheduler.py`](https://github.com/paduladiego/aerocar/blob/main/utils/scheduler.py) (Fleet scheduler)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Application Entry"]
  node_app["Flask application<br/>[app.py]"]
  node_auth["Authentication<br/>[auth.py]"]
end

subgraph group_operations["Fleet Operations"]
  node_dashboard["Fleet dashboard<br/>[dashboard.py]"]
  node_reservations["Reservations &amp; check-in<br/>[reservations.py]"]
  node_facilities["Vehicles &amp; drivers<br/>[facilities.py]"]
  node_carpool["Carpooling<br/>[carpool.py]"]
  node_incidents["Incidents &amp; fines<br/>[incidents.py]"]
end

subgraph group_governance["Administration"]
  node_auditing["Audit records<br/>[auditing.py]"]
  node_admin["Users &amp; units<br/>[admin.py]"]
end

subgraph group_support["Shared Services"]
  node_domain["Fleet domain models<br/>[models.py]"]
  node_database[("PostgreSQL")]
  node_security["Credential &amp; data security<br/>[security.py]"]
  node_scheduler["Fleet scheduler<br/>[scheduler.py]"]
  node_notifications["Email notifications<br/>[notifications.py]"]
end

node_user(("Fleet users"))
node_smtp["SMTP service"]

node_user -->|"uses"| node_app
node_app -->|"registers"| node_auth
node_app -->|"registers"| node_dashboard
node_app -->|"registers"| node_facilities
node_app -->|"registers"| node_reservations
node_app -->|"registers"| node_carpool
node_app -->|"registers"| node_incidents
node_app -->|"registers"| node_auditing
node_app -->|"registers"| node_admin
node_auth -->|"queries &amp; updates"| node_domain
node_auth -->|"hashes passwords"| node_security
node_auth -->|"sends mail"| node_notifications
node_dashboard -->|"queries"| node_domain
node_reservations -->|"creates &amp; updates"| node_domain
node_facilities -->|"manages"| node_domain
node_carpool -->|"uses"| node_domain
node_incidents -->|"uses"| node_domain
node_auditing -->|"queries"| node_domain
node_admin -->|"manages"| node_domain
node_domain -.->|"persists entities"| node_database
node_domain -->|"encrypts personal data"| node_security
node_app -->|"starts jobs"| node_scheduler
node_scheduler -->|"checks fleet state"| node_domain
node_scheduler -->|"sends alerts"| node_notifications
node_notifications -->|"sends email"| node_smtp

click node_app "https://github.com/paduladiego/aerocar/blob/main/app.py"
click node_auth "https://github.com/paduladiego/aerocar/blob/main/routes/auth.py"
click node_dashboard "https://github.com/paduladiego/aerocar/blob/main/routes/dashboard.py"
click node_reservations "https://github.com/paduladiego/aerocar/blob/main/routes/reservations.py"
click node_facilities "https://github.com/paduladiego/aerocar/blob/main/routes/facilities.py"
click node_carpool "https://github.com/paduladiego/aerocar/blob/main/routes/carpool.py"
click node_incidents "https://github.com/paduladiego/aerocar/blob/main/routes/incidents.py"
click node_auditing "https://github.com/paduladiego/aerocar/blob/main/routes/auditing.py"
click node_admin "https://github.com/paduladiego/aerocar/blob/main/routes/admin.py"
click node_domain "https://github.com/paduladiego/aerocar/blob/main/models.py"
click node_security "https://github.com/paduladiego/aerocar/blob/main/utils/security.py"
click node_scheduler "https://github.com/paduladiego/aerocar/blob/main/utils/scheduler.py"
click node_notifications "https://github.com/paduladiego/aerocar/blob/main/utils/notifications.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_app,node_auth,node_user toneBlue
class node_dashboard,node_reservations,node_facilities,node_carpool,node_incidents toneAmber
class node_auditing,node_admin toneMint
class node_domain,node_database,node_security,node_scheduler,node_notifications toneRose
class node_smtp toneIndigo
```

## Components

### Application Entry

- [Flask application](https://github.com/paduladiego/aerocar/blob/main/app.py): `app.py`
- [Authentication](https://github.com/paduladiego/aerocar/blob/main/routes/auth.py): `routes/auth.py`

### Fleet Operations

- [Fleet dashboard](https://github.com/paduladiego/aerocar/blob/main/routes/dashboard.py): `routes/dashboard.py`
- [Reservations & check-in](https://github.com/paduladiego/aerocar/blob/main/routes/reservations.py): `routes/reservations.py`
- [Vehicles & drivers](https://github.com/paduladiego/aerocar/blob/main/routes/facilities.py): `routes/facilities.py`
- [Carpooling](https://github.com/paduladiego/aerocar/blob/main/routes/carpool.py): `routes/carpool.py`
- [Incidents & fines](https://github.com/paduladiego/aerocar/blob/main/routes/incidents.py): `routes/incidents.py`

### Administration

- [Audit records](https://github.com/paduladiego/aerocar/blob/main/routes/auditing.py): `routes/auditing.py`
- [Users & units](https://github.com/paduladiego/aerocar/blob/main/routes/admin.py): `routes/admin.py`

### Shared Services

- [Fleet domain models](https://github.com/paduladiego/aerocar/blob/main/models.py): `models.py`
- **PostgreSQL**
- [Credential & data security](https://github.com/paduladiego/aerocar/blob/main/utils/security.py): `utils/security.py`
- [Fleet scheduler](https://github.com/paduladiego/aerocar/blob/main/utils/scheduler.py): `utils/scheduler.py`
- [Email notifications](https://github.com/paduladiego/aerocar/blob/main/utils/notifications.py): `utils/notifications.py`

### Other components

- **Fleet users**
- **SMTP service**

## Connections

- Fleet users → Flask application: uses (evidence: `README.md`)
- Flask application → Authentication: registers (evidence: `app.py`)
- Flask application → Fleet dashboard: registers (evidence: `app.py`)
- Flask application → Vehicles & drivers: registers (evidence: `app.py`)
- Flask application → Reservations & check-in: registers (evidence: `app.py`)
- Flask application → Carpooling: registers (evidence: `app.py`)
- Flask application → Incidents & fines: registers (evidence: `app.py`)
- Flask application → Audit records: registers (evidence: `app.py`)
- Flask application → Users & units: registers (evidence: `app.py`)
- Authentication → Fleet domain models: queries & updates (evidence: `routes/auth.py`)
- Authentication → Credential & data security: hashes passwords (evidence: `routes/auth.py`)
- Authentication → Email notifications: sends mail (evidence: `routes/auth.py`)
- Fleet dashboard → Fleet domain models: queries (evidence: `routes/dashboard.py`)
- Reservations & check-in → Fleet domain models: creates & updates (evidence: `routes/reservations.py`)
- Vehicles & drivers → Fleet domain models: manages (evidence: `routes/facilities.py`)
- Carpooling → Fleet domain models: uses (evidence: `routes/carpool.py`)
- Incidents & fines → Fleet domain models: uses (evidence: `routes/incidents.py`)
- Audit records → Fleet domain models: queries (evidence: `routes/auditing.py`)
- Users & units → Fleet domain models: manages (evidence: `routes/admin.py`)
- Fleet domain models → PostgreSQL: persists entities (evidence: `README.md`)
- Fleet domain models → Credential & data security: encrypts personal data (evidence: `models.py`)
- Flask application → Fleet scheduler: starts jobs (evidence: `app.py`)
- Fleet scheduler → Fleet domain models: checks fleet state (evidence: `utils/scheduler.py`)
- Fleet scheduler → Email notifications: sends alerts (evidence: `utils/scheduler.py`)
- Email notifications → SMTP service: sends email (evidence: `utils/notifications.py`)
