# 16aisu/aeropredict architecture

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

- Interactive diagram: https://gitdiagram.com/16aisu/aeropredict
- Repository: https://github.com/16aisu/aeropredict

## Overview

AeroPredict is an aircraft-fleet predictive-maintenance and readiness platform. Operators use the dashboard to inspect fleet health and aircraft digital twins, review ML predictions, optimize maintenance against resources and missions, and manage spares and sorties. The React pages call a FastAPI service, whose domain endpoints use a shared SQLite model; prediction and scheduling engines provide the principal decision-support layers. The README also describes telemetry and operational feeds, but their ingestion implementation is not established by the sampled source, so those links are shown as unverified.

Main entry points: [`backend/main.py`](https://github.com/16aisu/aeropredict/blob/main/backend/main.py) (FastAPI application), [`frontend/src/App.tsx`](https://github.com/16aisu/aeropredict/blob/main/frontend/src/App.tsx) (Application routes), [`frontend/src/services/api.ts`](https://github.com/16aisu/aeropredict/blob/main/frontend/src/services/api.ts) (API client), [`backend/app/database/connection.py`](https://github.com/16aisu/aeropredict/blob/main/backend/app/database/connection.py) (SQLite database)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Operations interface"]
  node_app["Application routes<br/>[App.tsx]"]
  node_overview["Fleet overview<br/>[OverviewPage.tsx]"]
  node_fleet["Fleet inventory<br/>[FleetPage.tsx]"]
  node_twin["Aircraft digital twin"]
  node_prediction_ui["Prediction hub"]
  node_maintenance_ui["Maintenance planner"]
  node_spares_ui["Spares logistics<br/>[SparePartsPage.tsx]"]
  node_missions_ui["Mission planner<br/>[MissionsPage.tsx]"]
  node_analytics_ui["Readiness analytics<br/>[AnalyticsPage.tsx]"]
  node_sources_ui["Data sources"]
  node_search_ui["Global search"]
  node_client["API client<br/>[api.ts]"]
end

subgraph group_api["Service API"]
  node_server["FastAPI application<br/>[main.py]"]
  node_aircraft_api["Aircraft service<br/>[aircraft.py]"]
  node_dashboard_api["Dashboard service<br/>[dashboard.py]"]
  node_prediction_api["Prediction service<br/>[predictions.py]"]
  node_maintenance_api["Maintenance service<br/>[maintenance.py]"]
  node_spares_api["Spares service<br/>[spares.py]"]
  node_missions_api["Mission service<br/>[missions.py]"]
  node_analytics_api["Analytics service<br/>[analytics.py]"]
  node_datasources_api["Feed status service<br/>[datasources.py]"]
  node_search_api["Search service<br/>[search.py]"]
  node_alerts_api["Alerts service<br/>[alerts.py]"]
end

subgraph group_data["Fleet data"]
  node_db[("SQLite database<br/>[connection.py]")]
  node_models["Fleet domain models<br/>[models.py]"]
  node_seed["Demo data seeding<br/>[seed_data.py]"]
  node_schemas["API schemas<br/>[schemas.py]"]
end

subgraph group_decision["Decision engines"]
  node_ml["RUL and failure inference<br/>[engine.py]"]
  node_scheduler["CP-SAT scheduler<br/>[scheduler.py]"]
end

subgraph group_operations["Readiness workflows"]
  node_telemetry(("Aircraft telemetry feeds"))
  node_records(("Maintenance records"))
  node_depot(("Spares depot"))
  node_ato(("Sorties and missions"))
end

node_operator(("Fleet operator"))

node_operator -->|"uses"| node_app
node_app -->|"routes to"| node_overview
node_app -->|"routes to"| node_fleet
node_app -->|"routes to"| node_twin
node_app -->|"routes to"| node_prediction_ui
node_app -->|"routes to"| node_maintenance_ui
node_app -->|"routes to"| node_spares_ui
node_app -->|"routes to"| node_missions_ui
node_app -->|"routes to"| node_analytics_ui
node_app -->|"routes to"| node_sources_ui
node_overview -->|"requests data"| node_client
node_fleet -->|"requests data"| node_client
node_twin -->|"requests data"| node_client
node_prediction_ui -->|"requests predictions"| node_client
node_maintenance_ui -->|"optimizes plan"| node_client
node_spares_ui -->|"manages spares"| node_client
node_missions_ui -->|"manages missions"| node_client
node_analytics_ui -->|"requests analytics"| node_client
node_sources_ui -->|"requests feed status"| node_client
node_search_ui -->|"searches"| node_client
node_client -->|"calls API"| node_server
node_server -->|"registers router"| node_dashboard_api
node_server -->|"registers router"| node_aircraft_api
node_server -->|"registers router"| node_prediction_api
node_server -->|"registers router"| node_maintenance_api
node_server -->|"registers router"| node_spares_api
node_server -->|"registers router"| node_missions_api
node_server -->|"registers router"| node_analytics_api
node_server -->|"registers router"| node_datasources_api
node_server -->|"registers router"| node_search_api
node_server -->|"registers router"| node_alerts_api
node_server -->|"seeds on startup"| node_seed
node_seed -->|"populates"| node_db
node_aircraft_api -->|"queries"| node_db
node_dashboard_api -->|"queries"| node_db
node_prediction_api -->|"queries and updates"| node_db
node_maintenance_api -->|"queries and updates"| node_db
node_spares_api -->|"queries and updates"| node_db
node_missions_api -->|"queries and updates"| node_db
node_analytics_api -->|"queries"| node_db
node_search_api -->|"searches"| node_db
node_alerts_api -->|"queries"| node_db
node_datasources_api -->|"uses schemas"| node_schemas
node_prediction_api -->|"runs inference"| node_ml
node_maintenance_api -->|"optimizes schedule"| node_scheduler
node_ml -->|"reads and updates"| node_models
node_scheduler -->|"uses domain data"| node_models
node_aircraft_api -->|"queries models"| node_models

click node_app "https://github.com/16aisu/aeropredict/blob/main/frontend/src/App.tsx"
click node_overview "https://github.com/16aisu/aeropredict/blob/main/frontend/src/pages/OverviewPage.tsx"
click node_fleet "https://github.com/16aisu/aeropredict/blob/main/frontend/src/pages/FleetPage.tsx"
click node_twin "https://github.com/16aisu/aeropredict/blob/main/frontend/src/pages/DigitalTwinPage.tsx"
click node_prediction_ui "https://github.com/16aisu/aeropredict/blob/main/frontend/src/pages/PredictionsPage.tsx"
click node_maintenance_ui "https://github.com/16aisu/aeropredict/blob/main/frontend/src/pages/MaintenancePlannerPage.tsx"
click node_spares_ui "https://github.com/16aisu/aeropredict/blob/main/frontend/src/pages/SparePartsPage.tsx"
click node_missions_ui "https://github.com/16aisu/aeropredict/blob/main/frontend/src/pages/MissionsPage.tsx"
click node_analytics_ui "https://github.com/16aisu/aeropredict/blob/main/frontend/src/pages/AnalyticsPage.tsx"
click node_sources_ui "https://github.com/16aisu/aeropredict/blob/main/frontend/src/pages/DataSourcesPage.tsx"
click node_search_ui "https://github.com/16aisu/aeropredict/blob/main/frontend/src/components/common/GlobalSearchModal.tsx"
click node_client "https://github.com/16aisu/aeropredict/blob/main/frontend/src/services/api.ts"
click node_server "https://github.com/16aisu/aeropredict/blob/main/backend/main.py"
click node_aircraft_api "https://github.com/16aisu/aeropredict/blob/main/backend/app/api/aircraft.py"
click node_dashboard_api "https://github.com/16aisu/aeropredict/blob/main/backend/app/api/dashboard.py"
click node_prediction_api "https://github.com/16aisu/aeropredict/blob/main/backend/app/api/predictions.py"
click node_maintenance_api "https://github.com/16aisu/aeropredict/blob/main/backend/app/api/maintenance.py"
click node_spares_api "https://github.com/16aisu/aeropredict/blob/main/backend/app/api/spares.py"
click node_missions_api "https://github.com/16aisu/aeropredict/blob/main/backend/app/api/missions.py"
click node_analytics_api "https://github.com/16aisu/aeropredict/blob/main/backend/app/api/analytics.py"
click node_datasources_api "https://github.com/16aisu/aeropredict/blob/main/backend/app/api/datasources.py"
click node_search_api "https://github.com/16aisu/aeropredict/blob/main/backend/app/api/search.py"
click node_alerts_api "https://github.com/16aisu/aeropredict/blob/main/backend/app/api/alerts.py"
click node_db "https://github.com/16aisu/aeropredict/blob/main/backend/app/database/connection.py"
click node_models "https://github.com/16aisu/aeropredict/blob/main/backend/app/models/models.py"
click node_seed "https://github.com/16aisu/aeropredict/blob/main/backend/app/database/seed_data.py"
click node_schemas "https://github.com/16aisu/aeropredict/blob/main/backend/app/schemas/schemas.py"
click node_ml "https://github.com/16aisu/aeropredict/blob/main/backend/app/ml/engine.py"
click node_scheduler "https://github.com/16aisu/aeropredict/blob/main/backend/app/optimization/scheduler.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_overview,node_fleet,node_twin,node_prediction_ui,node_maintenance_ui,node_spares_ui,node_missions_ui,node_analytics_ui,node_sources_ui,node_search_ui,node_client toneBlue
class node_server,node_aircraft_api,node_dashboard_api,node_prediction_api,node_maintenance_api,node_spares_api,node_missions_api,node_analytics_api,node_datasources_api,node_search_api,node_alerts_api toneAmber
class node_db,node_models,node_seed,node_schemas toneMint
class node_ml,node_scheduler toneRose
class node_telemetry,node_records,node_depot,node_ato,node_operator toneIndigo
```

## Components

### Operations interface

- [Application routes](https://github.com/16aisu/aeropredict/blob/main/frontend/src/App.tsx): `frontend/src/App.tsx`
- [Fleet overview](https://github.com/16aisu/aeropredict/blob/main/frontend/src/pages/OverviewPage.tsx): `frontend/src/pages/OverviewPage.tsx`
- [Fleet inventory](https://github.com/16aisu/aeropredict/blob/main/frontend/src/pages/FleetPage.tsx): `frontend/src/pages/FleetPage.tsx`
- [Aircraft digital twin](https://github.com/16aisu/aeropredict/blob/main/frontend/src/pages/DigitalTwinPage.tsx): `frontend/src/pages/DigitalTwinPage.tsx`
- [Prediction hub](https://github.com/16aisu/aeropredict/blob/main/frontend/src/pages/PredictionsPage.tsx): `frontend/src/pages/PredictionsPage.tsx`
- [Maintenance planner](https://github.com/16aisu/aeropredict/blob/main/frontend/src/pages/MaintenancePlannerPage.tsx): `frontend/src/pages/MaintenancePlannerPage.tsx`
- [Spares logistics](https://github.com/16aisu/aeropredict/blob/main/frontend/src/pages/SparePartsPage.tsx): `frontend/src/pages/SparePartsPage.tsx`
- [Mission planner](https://github.com/16aisu/aeropredict/blob/main/frontend/src/pages/MissionsPage.tsx): `frontend/src/pages/MissionsPage.tsx`
- [Readiness analytics](https://github.com/16aisu/aeropredict/blob/main/frontend/src/pages/AnalyticsPage.tsx): `frontend/src/pages/AnalyticsPage.tsx`
- [Data sources](https://github.com/16aisu/aeropredict/blob/main/frontend/src/pages/DataSourcesPage.tsx): `frontend/src/pages/DataSourcesPage.tsx`
- [Global search](https://github.com/16aisu/aeropredict/blob/main/frontend/src/components/common/GlobalSearchModal.tsx): `frontend/src/components/common/GlobalSearchModal.tsx`
- [API client](https://github.com/16aisu/aeropredict/blob/main/frontend/src/services/api.ts): `frontend/src/services/api.ts`

### Service API

- [FastAPI application](https://github.com/16aisu/aeropredict/blob/main/backend/main.py): `backend/main.py`
- [Aircraft service](https://github.com/16aisu/aeropredict/blob/main/backend/app/api/aircraft.py): `backend/app/api/aircraft.py`
- [Dashboard service](https://github.com/16aisu/aeropredict/blob/main/backend/app/api/dashboard.py): `backend/app/api/dashboard.py`
- [Prediction service](https://github.com/16aisu/aeropredict/blob/main/backend/app/api/predictions.py): `backend/app/api/predictions.py`
- [Maintenance service](https://github.com/16aisu/aeropredict/blob/main/backend/app/api/maintenance.py): `backend/app/api/maintenance.py`
- [Spares service](https://github.com/16aisu/aeropredict/blob/main/backend/app/api/spares.py): `backend/app/api/spares.py`
- [Mission service](https://github.com/16aisu/aeropredict/blob/main/backend/app/api/missions.py): `backend/app/api/missions.py`
- [Analytics service](https://github.com/16aisu/aeropredict/blob/main/backend/app/api/analytics.py): `backend/app/api/analytics.py`
- [Feed status service](https://github.com/16aisu/aeropredict/blob/main/backend/app/api/datasources.py): `backend/app/api/datasources.py`
- [Search service](https://github.com/16aisu/aeropredict/blob/main/backend/app/api/search.py): `backend/app/api/search.py`
- [Alerts service](https://github.com/16aisu/aeropredict/blob/main/backend/app/api/alerts.py): `backend/app/api/alerts.py`

### Fleet data

- [SQLite database](https://github.com/16aisu/aeropredict/blob/main/backend/app/database/connection.py): `backend/app/database/connection.py`
- [Fleet domain models](https://github.com/16aisu/aeropredict/blob/main/backend/app/models/models.py): `backend/app/models/models.py`
- [Demo data seeding](https://github.com/16aisu/aeropredict/blob/main/backend/app/database/seed_data.py): `backend/app/database/seed_data.py`
- [API schemas](https://github.com/16aisu/aeropredict/blob/main/backend/app/schemas/schemas.py): `backend/app/schemas/schemas.py`

### Decision engines

- [RUL and failure inference](https://github.com/16aisu/aeropredict/blob/main/backend/app/ml/engine.py): `backend/app/ml/engine.py`
- [CP-SAT scheduler](https://github.com/16aisu/aeropredict/blob/main/backend/app/optimization/scheduler.py): `backend/app/optimization/scheduler.py`

### Readiness workflows

- **Aircraft telemetry feeds**
- **Maintenance records**
- **Spares depot**
- **Sorties and missions**

### Other components

- **Fleet operator**

## Connections

- Fleet operator → Application routes: uses (evidence: `frontend/src/App.tsx`)
- Application routes → Fleet overview: routes to (evidence: `frontend/src/App.tsx`)
- Application routes → Fleet inventory: routes to (evidence: `frontend/src/App.tsx`)
- Application routes → Aircraft digital twin: routes to (evidence: `frontend/src/App.tsx`)
- Application routes → Prediction hub: routes to (evidence: `frontend/src/App.tsx`)
- Application routes → Maintenance planner: routes to (evidence: `frontend/src/App.tsx`)
- Application routes → Spares logistics: routes to (evidence: `frontend/src/App.tsx`)
- Application routes → Mission planner: routes to (evidence: `frontend/src/App.tsx`)
- Application routes → Readiness analytics: routes to (evidence: `frontend/src/App.tsx`)
- Application routes → Data sources: routes to (evidence: `frontend/src/App.tsx`)
- Fleet overview → API client: requests data (evidence: `frontend/src/pages/OverviewPage.tsx`)
- Fleet inventory → API client: requests data (evidence: `frontend/src/pages/FleetPage.tsx`)
- Aircraft digital twin → API client: requests data (evidence: `frontend/src/pages/DigitalTwinPage.tsx`)
- Prediction hub → API client: requests predictions (evidence: `frontend/src/pages/PredictionsPage.tsx`)
- Maintenance planner → API client: optimizes plan (evidence: `frontend/src/pages/MaintenancePlannerPage.tsx`)
- Spares logistics → API client: manages spares (evidence: `frontend/src/pages/SparePartsPage.tsx`)
- Mission planner → API client: manages missions (evidence: `frontend/src/pages/MissionsPage.tsx`)
- Readiness analytics → API client: requests analytics
- Data sources → API client: requests feed status (evidence: `frontend/src/pages/DataSourcesPage.tsx`)
- Global search → API client: searches (evidence: `frontend/src/components/common/GlobalSearchModal.tsx`)
- API client → FastAPI application: calls API (evidence: `frontend/src/services/api.ts`)
- FastAPI application → Dashboard service: registers router (evidence: `backend/main.py`)
- FastAPI application → Aircraft service: registers router (evidence: `backend/main.py`)
- FastAPI application → Prediction service: registers router (evidence: `backend/main.py`)
- FastAPI application → Maintenance service: registers router (evidence: `backend/main.py`)
- FastAPI application → Spares service: registers router (evidence: `backend/main.py`)
- FastAPI application → Mission service: registers router (evidence: `backend/main.py`)
- FastAPI application → Analytics service: registers router (evidence: `backend/main.py`)
- FastAPI application → Feed status service: registers router (evidence: `backend/main.py`)
- FastAPI application → Search service: registers router (evidence: `backend/main.py`)
- FastAPI application → Alerts service: registers router (evidence: `backend/main.py`)
- FastAPI application → Demo data seeding: seeds on startup (evidence: `backend/main.py`)
- Demo data seeding → SQLite database: populates (evidence: `backend/app/database/seed_data.py`)
- Aircraft service → SQLite database: queries (evidence: `backend/app/api/aircraft.py`)
- Dashboard service → SQLite database: queries (evidence: `backend/app/api/dashboard.py`)
- Prediction service → SQLite database: queries and updates (evidence: `backend/app/api/predictions.py`)
- Maintenance service → SQLite database: queries and updates (evidence: `backend/app/api/maintenance.py`)
- Spares service → SQLite database: queries and updates (evidence: `backend/app/api/spares.py`)
- Mission service → SQLite database: queries and updates (evidence: `backend/app/api/missions.py`)
- Analytics service → SQLite database: queries (evidence: `backend/app/api/analytics.py`)
- Search service → SQLite database: searches (evidence: `backend/app/api/search.py`)
- Alerts service → SQLite database: queries (evidence: `backend/app/api/alerts.py`)
- Feed status service → API schemas: uses schemas (evidence: `backend/app/api/datasources.py`)
- Prediction service → RUL and failure inference: runs inference (evidence: `backend/app/api/predictions.py`)
- Maintenance service → CP-SAT scheduler: optimizes schedule (evidence: `backend/app/api/maintenance.py`)
- RUL and failure inference → Fleet domain models: reads and updates (evidence: `backend/app/ml/engine.py`)
- CP-SAT scheduler → Fleet domain models: uses domain data (evidence: `backend/app/optimization/scheduler.py`)
- Aircraft service → Fleet domain models: queries models (evidence: `backend/app/api/aircraft.py`)
