# nickmwangemi/aircraft-fleet-management-api architecture

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

- Interactive diagram: https://gitdiagram.com/nickmwangemi/aircraft-fleet-management-api
- Repository: https://github.com/nickmwangemi/aircraft-fleet-management-api

## Overview

This is a FastAPI aircraft-fleet management API. Clients create and manage aircraft and flights, search flights by airports and time range, and request asynchronous flight reports. The main runtime path is API entry point → endpoint → CRUD → relational models/database; report requests dispatch a Celery task that queries flight data. The README also documents CLI commands for seeding, checking, and clearing data. Connections are limited to those shown in excerpts, the source index, or README; PostgreSQL and Redis roles are documented rather than directly exercised in sampled runtime code.

Main entry points: [`app/main.py`](https://github.com/nickmwangemi/aircraft-fleet-management-api/blob/main/app/main.py) (FastAPI App), [`app/database.py`](https://github.com/nickmwangemi/aircraft-fleet-management-api/blob/main/app/database.py) (DB Session & Engine), [`app/api/endpoints/aircraft.py`](https://github.com/nickmwangemi/aircraft-fleet-management-api/blob/main/app/api/endpoints/aircraft.py) (Aircraft API), [`app/api/endpoints/flights.py`](https://github.com/nickmwangemi/aircraft-fleet-management-api/blob/main/app/api/endpoints/flights.py) (Flight API)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["HTTP API"]
  node_app["FastAPI App<br/>[main.py]"]
  node_aircraft_api["Aircraft API<br/>[aircraft.py]"]
  node_flight_api["Flight API<br/>[flights.py]"]
  node_report_api["Reports API<br/>[reports.py]"]
  node_dependencies["DB Dependency<br/>[deps.py]"]
end

subgraph group_domain["Fleet Domain"]
  node_aircraft_crud["Aircraft CRUD<br/>[aircraft.py]"]
  node_flight_crud["Flight CRUD &amp; Search<br/>[flight.py]"]
  node_aircraft_schema["Aircraft Schemas<br/>[aircraft.py]"]
  node_flight_schema["Flight Schemas<br/>[flight.py]"]
  node_aircraft_model["Aircraft Model<br/>[aircraft.py]"]
  node_flight_model["Flight Model<br/>[flight.py]"]
  node_cli["Fleet CLI<br/>[cli.py]"]
end

subgraph group_reporting["Async Reporting"]
  node_report_task["Report Task<br/>[report_tasks.py]"]
  node_celery["Celery Worker<br/>[celery_worker.py]"]
  node_redis["Redis Broker"]
end

subgraph group_runtime["Runtime Services"]
  node_database["DB Session &amp; Engine<br/>[database.py]"]
  node_config["Settings<br/>[config.py]"]
  node_postgres[("PostgreSQL")]
end

node_client(("API Client"))

node_client -->|"calls API"| node_app
node_app -->|"mounts routes"| node_aircraft_api
node_app -->|"mounts routes"| node_flight_api
node_app -->|"mounts routes"| node_report_api
node_app -->|"creates tables"| node_database
node_aircraft_api -->|"gets DB session"| node_dependencies
node_aircraft_api -->|"calls"| node_aircraft_crud
node_aircraft_api -->|"validates and returns"| node_aircraft_schema
node_flight_api -->|"gets DB session"| node_dependencies
node_flight_api -->|"calls"| node_flight_crud
node_flight_api -->|"validates and returns"| node_flight_schema
node_report_api -->|"dispatches"| node_report_task
node_aircraft_crud -->|"queries and mutates"| node_aircraft_model
node_aircraft_crud -->|"uses input schema"| node_aircraft_schema
node_flight_crud -->|"queries and mutates"| node_flight_model
node_flight_crud -->|"uses input schema"| node_flight_schema
node_report_task -->|"aggregates flight data"| node_flight_model
node_report_task -->|"opens DB session"| node_database
node_report_task -->|"registers task"| node_celery
node_celery -->|"uses broker"| node_redis
node_database -->|"reads settings"| node_config
node_database -->|"connects to"| node_postgres
node_celery -->|"reads broker settings"| node_config
node_cli -->|"uses sessions"| node_database
node_cli -->|"manages aircraft"| node_aircraft_model
node_cli -->|"manages flights"| node_flight_model

click node_app "https://github.com/nickmwangemi/aircraft-fleet-management-api/blob/main/app/main.py"
click node_aircraft_api "https://github.com/nickmwangemi/aircraft-fleet-management-api/blob/main/app/api/endpoints/aircraft.py"
click node_flight_api "https://github.com/nickmwangemi/aircraft-fleet-management-api/blob/main/app/api/endpoints/flights.py"
click node_report_api "https://github.com/nickmwangemi/aircraft-fleet-management-api/blob/main/app/api/endpoints/reports.py"
click node_dependencies "https://github.com/nickmwangemi/aircraft-fleet-management-api/blob/main/app/api/deps.py"
click node_aircraft_crud "https://github.com/nickmwangemi/aircraft-fleet-management-api/blob/main/app/api/crud/aircraft.py"
click node_flight_crud "https://github.com/nickmwangemi/aircraft-fleet-management-api/blob/main/app/api/crud/flight.py"
click node_aircraft_schema "https://github.com/nickmwangemi/aircraft-fleet-management-api/blob/main/app/schemas/aircraft.py"
click node_flight_schema "https://github.com/nickmwangemi/aircraft-fleet-management-api/blob/main/app/schemas/flight.py"
click node_aircraft_model "https://github.com/nickmwangemi/aircraft-fleet-management-api/blob/main/app/models/aircraft.py"
click node_flight_model "https://github.com/nickmwangemi/aircraft-fleet-management-api/blob/main/app/models/flight.py"
click node_cli "https://github.com/nickmwangemi/aircraft-fleet-management-api/blob/main/app/cli.py"
click node_report_task "https://github.com/nickmwangemi/aircraft-fleet-management-api/blob/main/app/api/tasks/report_tasks.py"
click node_celery "https://github.com/nickmwangemi/aircraft-fleet-management-api/blob/main/celery_worker.py"
click node_database "https://github.com/nickmwangemi/aircraft-fleet-management-api/blob/main/app/database.py"
click node_config "https://github.com/nickmwangemi/aircraft-fleet-management-api/blob/main/app/config.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_aircraft_api,node_flight_api,node_report_api,node_dependencies,node_client toneBlue
class node_aircraft_crud,node_flight_crud,node_aircraft_schema,node_flight_schema,node_aircraft_model,node_flight_model,node_cli toneAmber
class node_report_task,node_celery,node_redis toneMint
class node_database,node_config,node_postgres toneRose
```

## Components

### HTTP API

- [FastAPI App](https://github.com/nickmwangemi/aircraft-fleet-management-api/blob/main/app/main.py): `app/main.py`
- [Aircraft API](https://github.com/nickmwangemi/aircraft-fleet-management-api/blob/main/app/api/endpoints/aircraft.py): `app/api/endpoints/aircraft.py`
- [Flight API](https://github.com/nickmwangemi/aircraft-fleet-management-api/blob/main/app/api/endpoints/flights.py): `app/api/endpoints/flights.py`
- [Reports API](https://github.com/nickmwangemi/aircraft-fleet-management-api/blob/main/app/api/endpoints/reports.py): `app/api/endpoints/reports.py`
- [DB Dependency](https://github.com/nickmwangemi/aircraft-fleet-management-api/blob/main/app/api/deps.py): `app/api/deps.py`

### Fleet Domain

- [Aircraft CRUD](https://github.com/nickmwangemi/aircraft-fleet-management-api/blob/main/app/api/crud/aircraft.py): `app/api/crud/aircraft.py`
- [Flight CRUD & Search](https://github.com/nickmwangemi/aircraft-fleet-management-api/blob/main/app/api/crud/flight.py): `app/api/crud/flight.py`
- [Aircraft Schemas](https://github.com/nickmwangemi/aircraft-fleet-management-api/blob/main/app/schemas/aircraft.py): `app/schemas/aircraft.py`
- [Flight Schemas](https://github.com/nickmwangemi/aircraft-fleet-management-api/blob/main/app/schemas/flight.py): `app/schemas/flight.py`
- [Aircraft Model](https://github.com/nickmwangemi/aircraft-fleet-management-api/blob/main/app/models/aircraft.py): `app/models/aircraft.py`
- [Flight Model](https://github.com/nickmwangemi/aircraft-fleet-management-api/blob/main/app/models/flight.py): `app/models/flight.py`
- [Fleet CLI](https://github.com/nickmwangemi/aircraft-fleet-management-api/blob/main/app/cli.py): `app/cli.py`

### Async Reporting

- [Report Task](https://github.com/nickmwangemi/aircraft-fleet-management-api/blob/main/app/api/tasks/report_tasks.py): `app/api/tasks/report_tasks.py`
- [Celery Worker](https://github.com/nickmwangemi/aircraft-fleet-management-api/blob/main/celery_worker.py): `celery_worker.py`
- **Redis Broker**

### Runtime Services

- [DB Session & Engine](https://github.com/nickmwangemi/aircraft-fleet-management-api/blob/main/app/database.py): `app/database.py`
- [Settings](https://github.com/nickmwangemi/aircraft-fleet-management-api/blob/main/app/config.py): `app/config.py`
- **PostgreSQL**

### Other components

- **API Client**

## Connections

- API Client → FastAPI App: calls API (evidence: `README.md`)
- FastAPI App → Aircraft API: mounts routes (evidence: `app/main.py`)
- FastAPI App → Flight API: mounts routes (evidence: `app/main.py`)
- FastAPI App → Reports API: mounts routes (evidence: `app/main.py`)
- FastAPI App → DB Session & Engine: creates tables (evidence: `app/main.py`)
- Aircraft API → DB Dependency: gets DB session (evidence: `app/api/endpoints/aircraft.py`)
- Aircraft API → Aircraft CRUD: calls (evidence: `app/api/endpoints/aircraft.py`)
- Aircraft API → Aircraft Schemas: validates and returns (evidence: `app/api/endpoints/aircraft.py`)
- Flight API → DB Dependency: gets DB session (evidence: `app/api/endpoints/flights.py`)
- Flight API → Flight CRUD & Search: calls (evidence: `app/api/endpoints/flights.py`)
- Flight API → Flight Schemas: validates and returns (evidence: `app/api/endpoints/flights.py`)
- Reports API → Report Task: dispatches (evidence: `app/api/endpoints/reports.py`)
- Aircraft CRUD → Aircraft Model: queries and mutates (evidence: `app/api/crud/aircraft.py`)
- Aircraft CRUD → Aircraft Schemas: uses input schema (evidence: `app/api/crud/aircraft.py`)
- Flight CRUD & Search → Flight Model: queries and mutates (evidence: `app/api/crud/flight.py`)
- Flight CRUD & Search → Flight Schemas: uses input schema (evidence: `app/api/crud/flight.py`)
- Report Task → Flight Model: aggregates flight data (evidence: `app/api/tasks/report_tasks.py`)
- Report Task → DB Session & Engine: opens DB session (evidence: `app/api/tasks/report_tasks.py`)
- Report Task → Celery Worker: registers task (evidence: `app/api/tasks/report_tasks.py`)
- Celery Worker → Redis Broker: uses broker (evidence: `README.md`)
- DB Session & Engine → Settings: reads settings (evidence: `app/database.py`)
- DB Session & Engine → PostgreSQL: connects to (evidence: `README.md`)
- Celery Worker → Settings: reads broker settings (evidence: `celery_worker.py`)
- Fleet CLI → DB Session & Engine: uses sessions (evidence: `app/cli.py`)
- Fleet CLI → Aircraft Model: manages aircraft (evidence: `app/cli.py`)
- Fleet CLI → Flight Model: manages flights (evidence: `app/cli.py`)
