How adarshhule/skyfleet-distributed-drone-fleet-mission-management-platform works
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: live.py Live Stream Hub · main.py MQTT Ingest · drone.py Drone Simulator · app.py HTTP Gateway
Components 15
Drone Edge
- Drone Simulator
services/edge/src/skyfleet_edge/drone.py - Flight Geometry
services/edge/src/skyfleet_edge/geo.py - MQTT Publisher
services/edge/src/skyfleet_edge/main.py
Shared Contracts
- Telemetry Models
contracts/src/skyfleet_contracts/telemetry.py - Event Envelope
contracts/src/skyfleet_contracts/envelope.py - Topic Builders
contracts/src/skyfleet_contracts/topics.py
Telemetry Service
- MQTT Ingest
services/telemetry/src/skyfleet_telemetry/main.py - Telemetry Store
services/telemetry/src/skyfleet_telemetry/store.py - Telemetry API
services/telemetry/src/skyfleet_telemetry/api.py
Gateway
- HTTP Gateway
services/gateway/src/skyfleet_gateway/app.py - Live Stream Hub
services/gateway/src/skyfleet_gateway/live.py
Other components
- Fleet Operator
- MQTT Broker
- Telemetry Database
services/telemetry/sql/001_init.sql - Browser Client
Connections 19
- Drone Simulator → Flight Geometry: uses geometry
services/edge/src/skyfleet_edge/drone.py - Drone Simulator → Telemetry Models: creates telemetry
services/edge/src/skyfleet_edge/drone.py - Drone Simulator → Event Envelope: wraps event
services/edge/src/skyfleet_edge/drone.py - MQTT Publisher → Drone Simulator: steps and serializes
services/edge/src/skyfleet_edge/main.py - MQTT Publisher → Topic Builders: builds publish topics
services/edge/src/skyfleet_edge/main.py - MQTT Publisher → MQTT Broker: publishes telemetry
services/edge/src/skyfleet_edge/main.py - MQTT Ingest → MQTT Broker: subscribes to telemetry
services/telemetry/src/skyfleet_telemetry/main.py - MQTT Ingest → Event Envelope: validates events
services/telemetry/src/skyfleet_telemetry/main.py - MQTT Ingest → Telemetry Models: validates payloads
services/telemetry/src/skyfleet_telemetry/main.py - MQTT Ingest → Telemetry Store: saves valid events
services/telemetry/src/skyfleet_telemetry/main.py - Telemetry Store → Telemetry Database: writes history and latest
services/telemetry/src/skyfleet_telemetry/store.py - HTTP Gateway → Telemetry API: requests telemetry
services/gateway/src/skyfleet_gateway/app.py - HTTP Gateway → Live Stream Hub: starts listener and serves sockets
services/gateway/src/skyfleet_gateway/app.py - Live Stream Hub → MQTT Broker: subscribes to telemetry
services/gateway/src/skyfleet_gateway/live.py - Live Stream Hub → Event Envelope: validates events
services/gateway/src/skyfleet_gateway/live.py - Live Stream Hub → Telemetry Models: validates payloads
services/gateway/src/skyfleet_gateway/live.py - Live Stream Hub → Browser Client: broadcasts updates
services/gateway/src/skyfleet_gateway/live.py - Fleet Operator → HTTP Gateway: queries fleet
- Browser Client → HTTP Gateway: opens WebSocket