# aryamdiaz/aerotrace architecture

> Architecture diagram of the GitHub repository aryamdiaz/aerotrace, 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/aryamdiaz/aerotrace
- Repository: https://github.com/aryamdiaz/aerotrace

## Overview

AeroTrace is a small telemetry-ingestion application: a simulator generates flight readings and POSTs them to a FastAPI endpoint, which validates the payload and saves it to SQLite. The backend also exposes a basic health message. The excerpts show ingestion and storage, but no telemetry query or visualization workflow; the README is empty.

Main entry points: [`backend/main.py`](https://github.com/aryamdiaz/aerotrace/blob/main/backend/main.py) (Telemetry API), [`simulador/telemetry_simulator.py`](https://github.com/aryamdiaz/aerotrace/blob/main/simulador/telemetry_simulator.py) (Flight Simulator), [`backend/database.py`](https://github.com/aryamdiaz/aerotrace/blob/main/backend/database.py) (SQLite Telemetry)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_simulation["Telemetry Simulation"]
  node_simulator["Flight Simulator"]
end

subgraph group_backend["Ingestion API"]
  node_api["Telemetry API<br/>[main.py]"]
end

subgraph group_storage["Persistence"]
  node_database[("SQLite Telemetry<br/>[database.py]")]
end

node_simulator -->|"posts telemetry"| node_api
node_api -->|"saves readings"| node_database
node_api -->|"returns response"| node_simulator

click node_simulator "https://github.com/aryamdiaz/aerotrace/blob/main/simulador/telemetry_simulator.py"
click node_api "https://github.com/aryamdiaz/aerotrace/blob/main/backend/main.py"
click node_database "https://github.com/aryamdiaz/aerotrace/blob/main/backend/database.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_simulator toneBlue
class node_api toneAmber
class node_database toneMint
```

## Components

### Telemetry Simulation

- [Flight Simulator](https://github.com/aryamdiaz/aerotrace/blob/main/simulador/telemetry_simulator.py): `simulador/telemetry_simulator.py`

### Ingestion API

- [Telemetry API](https://github.com/aryamdiaz/aerotrace/blob/main/backend/main.py): `backend/main.py`

### Persistence

- [SQLite Telemetry](https://github.com/aryamdiaz/aerotrace/blob/main/backend/database.py): `backend/database.py`

## Connections

- Flight Simulator → Telemetry API: posts telemetry (evidence: `simulador/telemetry_simulator.py`)
- Telemetry API → SQLite Telemetry: saves readings (evidence: `backend/main.py`)
- Telemetry API → Flight Simulator: returns response (evidence: `simulador/telemetry_simulator.py`)
