How mondalsrinjoy14-coder/aerotrace works
AeroTrace is a research prototype for investigating possible GNSS interference from aircraft ADS-B data; its alerts are candidate evidence, not confirmation. The main workflow is analyst dashboard or CSV input → API ingestion and validation → stored observations → physics-based detection, multi-aircraft clustering, and event interpretation → persisted evidence and alerts → dashboard review. Live provider ingestion, alert integrations, and optional ML are additional capabilities. The graph follows documented behavior and indexed references; some unsampled subsystem internals and wiring are necessarily summarized or omitted.
Main entry points: service.py Detection orchestration · routes.py HTTP API · Dashboard.tsx Dashboard · api.ts Typed API client
Components 22
Analyst interface
- Dashboard
Aerotrace-main/src/components/Dashboard.tsx - Airspace view
Aerotrace-main/src/components/AirspaceView.tsx - CSV replay
Aerotrace-main/src/components/CsvTracking.tsx - Track explorer
Aerotrace-main/src/lib/explorer.ts - Typed API client
Aerotrace-main/src/lib/api.ts
Observation ingestion
- HTTP API
Aerotrace-main/backend/app/api/routes.py - ADS-B providers
Aerotrace-main/backend/app/ingestion/opensky.py - CSV import
Aerotrace-main/backend/app/ingestion/csv_import.py - Observation normalization
Aerotrace-main/backend/app/ingestion/observations.py - Ingest pipeline
Aerotrace-main/backend/app/ingestion/pipeline.py
Detection and investigation
- Detection orchestration
Aerotrace-main/backend/app/detectors/service.py - Physics checks
Aerotrace-main/backend/app/detectors/detectors.py - Track features
Aerotrace-main/backend/app/detectors/features.py - Spatial clustering
Aerotrace-main/backend/app/detectors/clustering.py - Investigation events
Aerotrace-main/backend/app/detectors/clustering.py
Persistence and alerts
- SQLite store
Aerotrace-main/backend/app/store.py - Alert evaluation
Aerotrace-main/backend/app/alerts.py - Notifications
Aerotrace-main/backend/app/notifications.py
Optional modeling
- Model inference
Aerotrace-main/backend/app/ml/service.py - ML features
Aerotrace-main/backend/app/ml/features.py - LSTM training
Aerotrace-main/backend/app/ml/lstm_pipeline.py
Other components
- Analyst
Connections 26
- Analyst → Dashboard: reviews
- Dashboard → Typed API client: requests data
Aerotrace-main/src/components/Dashboard.tsx - Dashboard → Airspace view: renders
Aerotrace-main/src/components/Dashboard.tsx - Dashboard → CSV replay: renders
Aerotrace-main/src/components/Dashboard.tsx - Airspace view → Typed API client: fetches observations
Aerotrace-main/src/components/AirspaceView.tsx - Airspace view → Track explorer: builds tracks
Aerotrace-main/src/components/AirspaceView.tsx - CSV replay → Typed API client: submits CSV
Aerotrace-main/src/components/CsvTracking.tsx - Typed API client → HTTP API: calls endpoints
Aerotrace-main/src/lib/api.ts - HTTP API → ADS-B providers: dispatches fetch
Aerotrace-main/backend/app/api/routes.py - HTTP API → CSV import: parses uploads
Aerotrace-main/backend/app/api/routes.py - HTTP API → Ingest pipeline: submits records
Aerotrace-main/backend/app/api/routes.py - Ingest pipeline → Observation normalization: normalizes rows
Aerotrace-main/backend/app/ingestion/pipeline.py - Ingest pipeline → SQLite store: writes observations
Aerotrace-main/backend/app/ingestion/pipeline.py - HTTP API → Detection orchestration: starts detection
Aerotrace-main/backend/app/api/routes.py - Detection orchestration → SQLite store: reads tracks
Aerotrace-main/backend/app/detectors/service.py - Detection orchestration → Physics checks: runs checks
Aerotrace-main/backend/app/detectors/service.py - Physics checks → Track features: uses features
Aerotrace-main/backend/app/detectors/detectors.py - Detection orchestration → Spatial clustering: clusters detections
Aerotrace-main/backend/app/detectors/service.py - Detection orchestration → Investigation events: interprets clusters
Aerotrace-main/backend/app/detectors/service.py - Detection orchestration → SQLite store: persists results
Aerotrace-main/backend/app/detectors/service.py - Detection orchestration → Alert evaluation: evaluates alerts
Aerotrace-main/backend/app/detectors/service.py - Alert evaluation → SQLite store: reads and writes rules
Aerotrace-main/backend/app/alerts.py - Alert evaluation → Notifications: dispatches notices
Aerotrace-main/backend/app/alerts.py - HTTP API → Model inference: requests model status
Aerotrace-main/backend/app/api/routes.py - Model inference → ML features: extracts vectors
Aerotrace-main/backend/app/ml/service.py - Model inference → LSTM training: uses sequence contract
Aerotrace-main/backend/app/ml/service.py