# adarshhule/skyfleet-distributed-drone-fleet-mission-management-platform architecture

> Architecture diagram of the GitHub repository adarshhule/skyfleet-distributed-drone-fleet-mission-management-platform, 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/adarshhule/skyfleet-distributed-drone-fleet-mission-management-platform
- Repository: https://github.com/adarshhule/skyfleet-distributed-drone-fleet-mission-management-platform

## Overview

SkyFleet simulates drone flight and distributes telemetry through MQTT for persistence, query, and live browser updates. The principal workflow is edge simulation → MQTT broker → validated telemetry ingestion → PostgreSQL history/latest state, with a gateway exposing query and WebSocket paths. Contracts define shared message shapes and topic builders. The telemetry API’s implementation was read, but its storage relationships are not shown in the excerpts, so those links are omitted; other unsampled capabilities are not inferred.

Main entry points: [`services/gateway/src/skyfleet_gateway/live.py`](https://github.com/adarshhule/skyfleet-distributed-drone-fleet-mission-management-platform/blob/main/services/gateway/src/skyfleet_gateway/live.py) (Live Stream Hub), [`services/telemetry/src/skyfleet_telemetry/main.py`](https://github.com/adarshhule/skyfleet-distributed-drone-fleet-mission-management-platform/blob/main/services/telemetry/src/skyfleet_telemetry/main.py) (MQTT Ingest), [`services/edge/src/skyfleet_edge/drone.py`](https://github.com/adarshhule/skyfleet-distributed-drone-fleet-mission-management-platform/blob/main/services/edge/src/skyfleet_edge/drone.py) (Drone Simulator), [`services/gateway/src/skyfleet_gateway/app.py`](https://github.com/adarshhule/skyfleet-distributed-drone-fleet-mission-management-platform/blob/main/services/gateway/src/skyfleet_gateway/app.py) (HTTP Gateway)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_edge["Drone Edge"]
  node_edge_sim["Drone Simulator<br/>[drone.py]"]
  node_geo["Flight Geometry<br/>[geo.py]"]
  node_edge_runtime["MQTT Publisher<br/>[main.py]"]
end

subgraph group_contracts["Shared Contracts"]
  node_contracts_models["Telemetry Models<br/>[telemetry.py]"]
  node_envelope["Event Envelope<br/>[envelope.py]"]
  node_topics["Topic Builders<br/>[topics.py]"]
end

subgraph group_telemetry["Telemetry Service"]
  node_ingest["MQTT Ingest<br/>[main.py]"]
  node_store["Telemetry Store<br/>[store.py]"]
  node_query_api["Telemetry API<br/>[api.py]"]
end

subgraph group_gateway["Gateway"]
  node_gateway_api["HTTP Gateway<br/>[app.py]"]
  node_live_stream["Live Stream Hub<br/>[live.py]"]
end

node_operator(("Fleet Operator"))
node_broker["MQTT Broker"]
node_database[("Telemetry Database<br/>[001_init.sql]")]
node_browser(("Browser Client"))

node_edge_sim -->|"uses geometry"| node_geo
node_edge_sim -->|"creates telemetry"| node_contracts_models
node_edge_sim -->|"wraps event"| node_envelope
node_edge_runtime -->|"steps and serializes"| node_edge_sim
node_edge_runtime -->|"builds publish topics"| node_topics
node_edge_runtime -->|"publishes telemetry"| node_broker
node_ingest -->|"subscribes to telemetry"| node_broker
node_ingest -->|"validates events"| node_envelope
node_ingest -->|"validates payloads"| node_contracts_models
node_ingest -->|"saves valid events"| node_store
node_store -->|"writes history and latest"| node_database
node_gateway_api -->|"requests telemetry"| node_query_api
node_gateway_api -->|"starts listener and serves sockets"| node_live_stream
node_live_stream -->|"subscribes to telemetry"| node_broker
node_live_stream -->|"validates events"| node_envelope
node_live_stream -->|"validates payloads"| node_contracts_models
node_live_stream -->|"broadcasts updates"| node_browser
node_operator -.->|"queries fleet"| node_gateway_api
node_browser -.->|"opens WebSocket"| node_gateway_api

click node_edge_sim "https://github.com/adarshhule/skyfleet-distributed-drone-fleet-mission-management-platform/blob/main/services/edge/src/skyfleet_edge/drone.py"
click node_geo "https://github.com/adarshhule/skyfleet-distributed-drone-fleet-mission-management-platform/blob/main/services/edge/src/skyfleet_edge/geo.py"
click node_edge_runtime "https://github.com/adarshhule/skyfleet-distributed-drone-fleet-mission-management-platform/blob/main/services/edge/src/skyfleet_edge/main.py"
click node_contracts_models "https://github.com/adarshhule/skyfleet-distributed-drone-fleet-mission-management-platform/blob/main/contracts/src/skyfleet_contracts/telemetry.py"
click node_envelope "https://github.com/adarshhule/skyfleet-distributed-drone-fleet-mission-management-platform/blob/main/contracts/src/skyfleet_contracts/envelope.py"
click node_topics "https://github.com/adarshhule/skyfleet-distributed-drone-fleet-mission-management-platform/blob/main/contracts/src/skyfleet_contracts/topics.py"
click node_ingest "https://github.com/adarshhule/skyfleet-distributed-drone-fleet-mission-management-platform/blob/main/services/telemetry/src/skyfleet_telemetry/main.py"
click node_store "https://github.com/adarshhule/skyfleet-distributed-drone-fleet-mission-management-platform/blob/main/services/telemetry/src/skyfleet_telemetry/store.py"
click node_database "https://github.com/adarshhule/skyfleet-distributed-drone-fleet-mission-management-platform/blob/main/services/telemetry/sql/001_init.sql"
click node_query_api "https://github.com/adarshhule/skyfleet-distributed-drone-fleet-mission-management-platform/blob/main/services/telemetry/src/skyfleet_telemetry/api.py"
click node_gateway_api "https://github.com/adarshhule/skyfleet-distributed-drone-fleet-mission-management-platform/blob/main/services/gateway/src/skyfleet_gateway/app.py"
click node_live_stream "https://github.com/adarshhule/skyfleet-distributed-drone-fleet-mission-management-platform/blob/main/services/gateway/src/skyfleet_gateway/live.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_edge_sim,node_geo,node_edge_runtime,node_browser toneBlue
class node_contracts_models,node_envelope,node_topics,node_database toneAmber
class node_ingest,node_store,node_query_api toneMint
class node_gateway_api,node_live_stream toneRose
class node_operator,node_broker toneIndigo
```

## Components

### Drone Edge

- [Drone Simulator](https://github.com/adarshhule/skyfleet-distributed-drone-fleet-mission-management-platform/blob/main/services/edge/src/skyfleet_edge/drone.py): `services/edge/src/skyfleet_edge/drone.py`
- [Flight Geometry](https://github.com/adarshhule/skyfleet-distributed-drone-fleet-mission-management-platform/blob/main/services/edge/src/skyfleet_edge/geo.py): `services/edge/src/skyfleet_edge/geo.py`
- [MQTT Publisher](https://github.com/adarshhule/skyfleet-distributed-drone-fleet-mission-management-platform/blob/main/services/edge/src/skyfleet_edge/main.py): `services/edge/src/skyfleet_edge/main.py`

### Shared Contracts

- [Telemetry Models](https://github.com/adarshhule/skyfleet-distributed-drone-fleet-mission-management-platform/blob/main/contracts/src/skyfleet_contracts/telemetry.py): `contracts/src/skyfleet_contracts/telemetry.py`
- [Event Envelope](https://github.com/adarshhule/skyfleet-distributed-drone-fleet-mission-management-platform/blob/main/contracts/src/skyfleet_contracts/envelope.py): `contracts/src/skyfleet_contracts/envelope.py`
- [Topic Builders](https://github.com/adarshhule/skyfleet-distributed-drone-fleet-mission-management-platform/blob/main/contracts/src/skyfleet_contracts/topics.py): `contracts/src/skyfleet_contracts/topics.py`

### Telemetry Service

- [MQTT Ingest](https://github.com/adarshhule/skyfleet-distributed-drone-fleet-mission-management-platform/blob/main/services/telemetry/src/skyfleet_telemetry/main.py): `services/telemetry/src/skyfleet_telemetry/main.py`
- [Telemetry Store](https://github.com/adarshhule/skyfleet-distributed-drone-fleet-mission-management-platform/blob/main/services/telemetry/src/skyfleet_telemetry/store.py): `services/telemetry/src/skyfleet_telemetry/store.py`
- [Telemetry API](https://github.com/adarshhule/skyfleet-distributed-drone-fleet-mission-management-platform/blob/main/services/telemetry/src/skyfleet_telemetry/api.py): `services/telemetry/src/skyfleet_telemetry/api.py`

### Gateway

- [HTTP Gateway](https://github.com/adarshhule/skyfleet-distributed-drone-fleet-mission-management-platform/blob/main/services/gateway/src/skyfleet_gateway/app.py): `services/gateway/src/skyfleet_gateway/app.py`
- [Live Stream Hub](https://github.com/adarshhule/skyfleet-distributed-drone-fleet-mission-management-platform/blob/main/services/gateway/src/skyfleet_gateway/live.py): `services/gateway/src/skyfleet_gateway/live.py`

### Other components

- **Fleet Operator**
- **MQTT Broker**
- [Telemetry Database](https://github.com/adarshhule/skyfleet-distributed-drone-fleet-mission-management-platform/blob/main/services/telemetry/sql/001_init.sql): `services/telemetry/sql/001_init.sql`
- **Browser Client**

## Connections

- Drone Simulator → Flight Geometry: uses geometry (evidence: `services/edge/src/skyfleet_edge/drone.py`)
- Drone Simulator → Telemetry Models: creates telemetry (evidence: `services/edge/src/skyfleet_edge/drone.py`)
- Drone Simulator → Event Envelope: wraps event (evidence: `services/edge/src/skyfleet_edge/drone.py`)
- MQTT Publisher → Drone Simulator: steps and serializes (evidence: `services/edge/src/skyfleet_edge/main.py`)
- MQTT Publisher → Topic Builders: builds publish topics (evidence: `services/edge/src/skyfleet_edge/main.py`)
- MQTT Publisher → MQTT Broker: publishes telemetry (evidence: `services/edge/src/skyfleet_edge/main.py`)
- MQTT Ingest → MQTT Broker: subscribes to telemetry (evidence: `services/telemetry/src/skyfleet_telemetry/main.py`)
- MQTT Ingest → Event Envelope: validates events (evidence: `services/telemetry/src/skyfleet_telemetry/main.py`)
- MQTT Ingest → Telemetry Models: validates payloads (evidence: `services/telemetry/src/skyfleet_telemetry/main.py`)
- MQTT Ingest → Telemetry Store: saves valid events (evidence: `services/telemetry/src/skyfleet_telemetry/main.py`)
- Telemetry Store → Telemetry Database: writes history and latest (evidence: `services/telemetry/src/skyfleet_telemetry/store.py`)
- HTTP Gateway → Telemetry API: requests telemetry (evidence: `services/gateway/src/skyfleet_gateway/app.py`)
- HTTP Gateway → Live Stream Hub: starts listener and serves sockets (evidence: `services/gateway/src/skyfleet_gateway/app.py`)
- Live Stream Hub → MQTT Broker: subscribes to telemetry (evidence: `services/gateway/src/skyfleet_gateway/live.py`)
- Live Stream Hub → Event Envelope: validates events (evidence: `services/gateway/src/skyfleet_gateway/live.py`)
- Live Stream Hub → Telemetry Models: validates payloads (evidence: `services/gateway/src/skyfleet_gateway/live.py`)
- Live Stream Hub → Browser Client: broadcasts updates (evidence: `services/gateway/src/skyfleet_gateway/live.py`)
- Fleet Operator → HTTP Gateway: queries fleet
- Browser Client → HTTP Gateway: opens WebSocket
