How nickmwangemi/aircraft-fleet-management-api works
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: main.py FastAPI App · database.py DB Session & Engine · aircraft.py Aircraft API · flights.py Flight API
Components 19
HTTP API
- FastAPI App
app/main.py - Aircraft API
app/api/endpoints/aircraft.py - Flight API
app/api/endpoints/flights.py - Reports API
app/api/endpoints/reports.py - DB Dependency
app/api/deps.py
Fleet Domain
- Aircraft CRUD
app/api/crud/aircraft.py - Flight CRUD & Search
app/api/crud/flight.py - Aircraft Schemas
app/schemas/aircraft.py - Flight Schemas
app/schemas/flight.py - Aircraft Model
app/models/aircraft.py - Flight Model
app/models/flight.py - Fleet CLI
app/cli.py
Async Reporting
- Report Task
app/api/tasks/report_tasks.py - Celery Worker
celery_worker.py - Redis Broker
Runtime Services
- DB Session & Engine
app/database.py - Settings
app/config.py - PostgreSQL
Other components
- API Client
Connections 26
- API Client → FastAPI App: calls API
README.md - FastAPI App → Aircraft API: mounts routes
app/main.py - FastAPI App → Flight API: mounts routes
app/main.py - FastAPI App → Reports API: mounts routes
app/main.py - FastAPI App → DB Session & Engine: creates tables
app/main.py - Aircraft API → DB Dependency: gets DB session
app/api/endpoints/aircraft.py - Aircraft API → Aircraft CRUD: calls
app/api/endpoints/aircraft.py - Aircraft API → Aircraft Schemas: validates and returns
app/api/endpoints/aircraft.py - Flight API → DB Dependency: gets DB session
app/api/endpoints/flights.py - Flight API → Flight CRUD & Search: calls
app/api/endpoints/flights.py - Flight API → Flight Schemas: validates and returns
app/api/endpoints/flights.py - Reports API → Report Task: dispatches
app/api/endpoints/reports.py - Aircraft CRUD → Aircraft Model: queries and mutates
app/api/crud/aircraft.py - Aircraft CRUD → Aircraft Schemas: uses input schema
app/api/crud/aircraft.py - Flight CRUD & Search → Flight Model: queries and mutates
app/api/crud/flight.py - Flight CRUD & Search → Flight Schemas: uses input schema
app/api/crud/flight.py - Report Task → Flight Model: aggregates flight data
app/api/tasks/report_tasks.py - Report Task → DB Session & Engine: opens DB session
app/api/tasks/report_tasks.py - Report Task → Celery Worker: registers task
app/api/tasks/report_tasks.py - Celery Worker → Redis Broker: uses broker
README.md - DB Session & Engine → Settings: reads settings
app/database.py - DB Session & Engine → PostgreSQL: connects to
README.md - Celery Worker → Settings: reads broker settings
celery_worker.py - Fleet CLI → DB Session & Engine: uses sessions
app/cli.py - Fleet CLI → Aircraft Model: manages aircraft
app/cli.py - Fleet CLI → Flight Model: manages flights
app/cli.py