# preetkukreja556-beep/airpower-pm architecture

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

- Interactive diagram: https://gitdiagram.com/preetkukreja556-beep/airpower-pm
- Repository: https://github.com/preetkukreja556-beep/airpower-pm

## Overview

AirPower-PM is a synthetic-data aircraft maintenance decision-support prototype. Its documented workflow is fleet monitoring, aircraft risk prediction and explanation, maintenance prioritization, availability planning, and questions to a grounded copilot. The excerpts show the model/data pipeline, API routes, planning and retrieval logic in `backend/main.py`; the README documents the dashboard workflow and broader capabilities. The frontend source and some implementation sections were not sampled, so frontend/API wiring and unsampled internals are not expanded.

Main entry points: [`backend/main.py`](https://github.com/preetkukreja556-beep/airpower-pm/blob/main/backend/main.py) (FastAPI and auth), [`backend/static/index.html`](https://github.com/preetkukreja556-beep/airpower-pm/blob/main/backend/static/index.html) (Fleet dashboard), [`backend/pipeline.py`](https://github.com/preetkukreja556-beep/airpower-pm/blob/main/backend/pipeline.py) (Synthetic data and ML)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interface["User interface"]
  node_dashboard["Fleet dashboard<br/>[index.html]"]
  node_api["FastAPI and auth<br/>[main.py]"]
end

subgraph group_risk["Risk assessment"]
  node_pipeline["Synthetic data and ML<br/>[pipeline.py]"]
  node_fleet["Fleet risk overview<br/>[main.py]"]
  node_aircraft["Aircraft detail<br/>[main.py]"]
  node_explanations["Risk factors<br/>[main.py]"]
  node_history["Sensor history<br/>[pipeline.py]"]
end

subgraph group_planning["Maintenance planning"]
  node_records["Maintenance records<br/>[main.py]"]
  node_priority["Inspection priority<br/>[main.py]"]
  node_availability["Fleet availability<br/>[main.py]"]
end

subgraph group_copilot["Copilot"]
  node_retrieval["Knowledge retrieval<br/>[main.py]"]
  node_copilot["Maintenance copilot<br/>[main.py]"]
  node_llm["Anthropic service"]
end

node_team(("Maintenance team"))

node_team -->|"uses"| node_dashboard
node_dashboard -.->|"requests results"| node_api
node_api -->|"trains and predicts"| node_pipeline
node_api -->|"serves fleet"| node_fleet
node_api -->|"serves detail"| node_aircraft
node_aircraft -->|"computes factors"| node_explanations
node_aircraft -->|"generates trends"| node_history
node_api -->|"serves plan"| node_priority
node_api -->|"serves summary"| node_availability
node_api -->|"serves records"| node_records
node_api -->|"routes questions"| node_copilot
node_copilot -->|"reads plan"| node_priority
node_copilot -->|"reads status"| node_availability
node_copilot -->|"retrieves sources"| node_retrieval
node_copilot -.->|"requests answer"| node_llm

click node_dashboard "https://github.com/preetkukreja556-beep/airpower-pm/blob/main/backend/static/index.html"
click node_api "https://github.com/preetkukreja556-beep/airpower-pm/blob/main/backend/main.py"
click node_pipeline "https://github.com/preetkukreja556-beep/airpower-pm/blob/main/backend/pipeline.py"
click node_fleet "https://github.com/preetkukreja556-beep/airpower-pm/blob/main/backend/main.py"
click node_aircraft "https://github.com/preetkukreja556-beep/airpower-pm/blob/main/backend/main.py"
click node_explanations "https://github.com/preetkukreja556-beep/airpower-pm/blob/main/backend/main.py"
click node_history "https://github.com/preetkukreja556-beep/airpower-pm/blob/main/backend/pipeline.py"
click node_records "https://github.com/preetkukreja556-beep/airpower-pm/blob/main/backend/main.py"
click node_priority "https://github.com/preetkukreja556-beep/airpower-pm/blob/main/backend/main.py"
click node_availability "https://github.com/preetkukreja556-beep/airpower-pm/blob/main/backend/main.py"
click node_retrieval "https://github.com/preetkukreja556-beep/airpower-pm/blob/main/backend/main.py"
click node_copilot "https://github.com/preetkukreja556-beep/airpower-pm/blob/main/backend/main.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_dashboard,node_api toneBlue
class node_pipeline,node_fleet,node_aircraft,node_explanations,node_history toneAmber
class node_records,node_priority,node_availability toneMint
class node_retrieval,node_copilot,node_llm toneRose
class node_team toneIndigo
```

## Components

### User interface

- [Fleet dashboard](https://github.com/preetkukreja556-beep/airpower-pm/blob/main/backend/static/index.html): `backend/static/index.html`
- [FastAPI and auth](https://github.com/preetkukreja556-beep/airpower-pm/blob/main/backend/main.py): `backend/main.py`

### Risk assessment

- [Synthetic data and ML](https://github.com/preetkukreja556-beep/airpower-pm/blob/main/backend/pipeline.py): `backend/pipeline.py`
- [Fleet risk overview](https://github.com/preetkukreja556-beep/airpower-pm/blob/main/backend/main.py): `backend/main.py`
- [Aircraft detail](https://github.com/preetkukreja556-beep/airpower-pm/blob/main/backend/main.py): `backend/main.py`
- [Risk factors](https://github.com/preetkukreja556-beep/airpower-pm/blob/main/backend/main.py): `backend/main.py`
- [Sensor history](https://github.com/preetkukreja556-beep/airpower-pm/blob/main/backend/pipeline.py): `backend/pipeline.py`

### Maintenance planning

- [Maintenance records](https://github.com/preetkukreja556-beep/airpower-pm/blob/main/backend/main.py): `backend/main.py`
- [Inspection priority](https://github.com/preetkukreja556-beep/airpower-pm/blob/main/backend/main.py): `backend/main.py`
- [Fleet availability](https://github.com/preetkukreja556-beep/airpower-pm/blob/main/backend/main.py): `backend/main.py`

### Copilot

- [Knowledge retrieval](https://github.com/preetkukreja556-beep/airpower-pm/blob/main/backend/main.py): `backend/main.py`
- [Maintenance copilot](https://github.com/preetkukreja556-beep/airpower-pm/blob/main/backend/main.py): `backend/main.py`
- **Anthropic service**

### Other components

- **Maintenance team**

## Connections

- Maintenance team → Fleet dashboard: uses (evidence: `README.md`)
- Fleet dashboard → FastAPI and auth: requests results
- FastAPI and auth → Synthetic data and ML: trains and predicts (evidence: `backend/main.py`)
- FastAPI and auth → Fleet risk overview: serves fleet (evidence: `backend/main.py`)
- FastAPI and auth → Aircraft detail: serves detail (evidence: `backend/main.py`)
- Aircraft detail → Risk factors: computes factors (evidence: `backend/main.py`)
- Aircraft detail → Sensor history: generates trends (evidence: `backend/main.py`)
- FastAPI and auth → Inspection priority: serves plan (evidence: `backend/main.py`)
- FastAPI and auth → Fleet availability: serves summary (evidence: `backend/main.py`)
- FastAPI and auth → Maintenance records: serves records (evidence: `backend/main.py`)
- FastAPI and auth → Maintenance copilot: routes questions (evidence: `backend/main.py`)
- Maintenance copilot → Inspection priority: reads plan (evidence: `backend/main.py`)
- Maintenance copilot → Fleet availability: reads status (evidence: `backend/main.py`)
- Maintenance copilot → Knowledge retrieval: retrieves sources (evidence: `backend/main.py`)
- Maintenance copilot → Anthropic service: requests answer (evidence: `backend/main.py`)
