How moreiramicael/aerostream works
AeroStream is a UAV-swarm ground-control and telemetry stack. Drones or the simulator POST telemetry to the .NET API, which checks battery/geofence conditions, queues accepted records, and returns pending commands; a background processor broadcasts live updates and batches persistence. Operators use the dashboard to monitor drones and submit routes, geofences, and commands. RabbitMQ carries durable command dispatch and alert events. The graph preserves the README’s simulator, observability, and operator-control capabilities; unsampled subsystem paths and edges rely only on documented behavior, while source-level call detail is limited to the excerpts and source index.
Main entry points: Program.cs Minimal API · TelemetryProcessor.cs Telemetry Processor · TelemetryDbContext.cs EF Database Context · RabbitMqPublisher.cs RabbitMQ Publisher
Components 19
Aircraft & Simulation
- UAV / Simulator
simulate.js - ESP32 Firmware
firmware/src/main.cpp - Flight Controller MSP
firmware/src/msp.cpp
Telemetry Ingestion
- Minimal API
src/AeroStream.Ingestion/Program.cs - Telemetry Channel
src/AeroStream.Ingestion/Program.cs - Telemetry Processor
src/AeroStream.Ingestion/TelemetryProcessor.cs - SignalR Hub
src/AeroStream.Ingestion/TelemetryHub.cs - Telemetry Record
src/AeroStream.Ingestion/TelemetryRecord.cs - EF Database Context
src/AeroStream.Ingestion/TelemetryDbContext.cs - PostgreSQL
- Geofence State & Checks
src/AeroStream.Ingestion/Program.cs
Command & Events
- RabbitMQ Publisher
src/AeroStream.Ingestion/RabbitMqPublisher.cs - RabbitMQ Exchange & Queues
- Dispatch Consumer
src/AeroStream.Ingestion/CommandDispatchConsumer.cs - Pending Drone Commands
src/AeroStream.Ingestion/Program.cs
Operator Dashboard
- Tactical Dashboard
src/AeroStream.Dashboard/src/App.tsx
Observability
- Prometheus Metrics
prometheus.yml - Grafana Dashboard
grafana/provisioning/dashboards/aerostream.json
Other components
- Operator
Connections 22
- UAV / Simulator → Minimal API: sends telemetry
README.md - ESP32 Firmware → Flight Controller MSP: reads flight data
firmware/src/main.cpp - ESP32 Firmware → Minimal API: POSTs telemetry
firmware/src/main.cpp - Minimal API → Telemetry Channel: enqueues records
README.md - Telemetry Channel → Telemetry Processor: feeds records
src/AeroStream.Ingestion/TelemetryProcessor.cs - Telemetry Processor → SignalR Hub: broadcasts updates
src/AeroStream.Ingestion/TelemetryProcessor.cs - SignalR Hub → Tactical Dashboard: streams telemetry
src/AeroStream.Dashboard/src/App.tsx - Telemetry Processor → EF Database Context: persists batches
src/AeroStream.Ingestion/TelemetryProcessor.cs - EF Database Context → Telemetry Record: maps records
src/AeroStream.Ingestion/TelemetryDbContext.cs - EF Database Context → PostgreSQL: reads/writes
README.md - Minimal API → Geofence State & Checks: checks boundary
src/AeroStream.Ingestion/Program.cs - Minimal API → RabbitMQ Publisher: publishes alerts
src/AeroStream.Ingestion/Program.cs - Minimal API → RabbitMQ Publisher: publishes commands
src/AeroStream.Ingestion/Program.cs - RabbitMQ Publisher → RabbitMQ Exchange & Queues: publishes events
src/AeroStream.Ingestion/RabbitMqPublisher.cs - RabbitMQ Exchange & Queues → Dispatch Consumer: dispatches messages
src/AeroStream.Ingestion/CommandDispatchConsumer.cs - Dispatch Consumer → Pending Drone Commands: stores commands
src/AeroStream.Ingestion/CommandDispatchConsumer.cs - Minimal API → Pending Drone Commands: returns pending C2
README.md - Pending Drone Commands → UAV / Simulator: delivers on ACK
README.md - Operator → Tactical Dashboard: uses controls
README.md - Tactical Dashboard → Minimal API: sends HTTP commands
src/AeroStream.Dashboard/src/App.tsx - Minimal API → Prometheus Metrics: exposes metrics
README.md - Prometheus Metrics → Grafana Dashboard: feeds dashboards
README.md