How yanwela/vatscore-radar works
VatScore is a Streamlit dashboard for live VATSIM operations and historical analytics. The main user workflow starts at the live radar, where current network data is filtered and presented as flight telemetry; users can follow a flight into maps or replay, or open dedicated CID, airport, network-statistics, and event views. The repository also documents persistent event and anomaly history, administrative controls, and account/security features. The tree and sampled excerpts establish the page structure and several data paths; some feature wiring is documented in the README but its implementation was not sampled, so those links are limited to supported high-level relationships.
Main entry points: app.py Live radar · vatsim_data.py Feed & reference data · 3_Airport.py Airport operations · 4_Events.py Events calendar
Components 23
Live Operations
- Live radar
app.py - Flight map
flight_map.js - Anomaly detection
anomaly_engine.py - Anomaly rules
anomaly_rules.py - Airport operations
pages/3_Airport.py - Airport live map
airport_live_map.js
Analytics
- CID intelligence
pages/1_CID_Stats.py - Network statistics
pages/2_Network_Stats.py - Network metrics
network_stats.py - Events calendar
pages/4_Events.py - Event processing
events_data.py
Replay & Maps
- Flight replay
flight_replay_view.py - ATC replay
atc_replay_view.py
Platform Services
- Feed & reference data
vatsim_data.py - Admin controls
admin_audit.py - Security & redaction
security_utils.py
Persistent Data
- Anomaly archive
anomaly_archive_store.py - Event history
events_history_store.py - GitHub file storage
github_file_store.py
Other components
- Dashboard user
- VATSIM feeds
- statsim.net
- Private GitHub store
Connections 27
- Dashboard user → Live radar: opens radar
- Dashboard user → CID intelligence: opens profile
- Dashboard user → Network statistics: opens analytics
- Dashboard user → Airport operations: selects airport
- Dashboard user → Events calendar: browses events
- VATSIM feeds → Feed & reference data: serves network data
- Live radar → Feed & reference data: loads live data
- Feed & reference data → Live radar: returns feed
- Live radar → Flight map: renders map data
- Live radar → Anomaly detection: updates snapshots
- Anomaly detection → Anomaly rules: detects anomalies
- Anomaly detection → Anomaly archive: archives closed events
- Dashboard user → Flight replay: selects flight
- Dashboard user → ATC replay: selects session
- statsim.net → CID intelligence: provides history
- Network statistics → Feed & reference data: loads live data
- Network statistics → Network metrics: builds statistics
- Airport operations → Feed & reference data: loads feed & airports
- Airport operations → Network metrics: computes airport detail
- Airport operations → Airport live map: renders map
- Events calendar → Event processing: filters & groups
- Events calendar → Event history: records events
- Events calendar → Feed & reference data: loads live context
- Admin controls → GitHub file storage: persists admin data
- GitHub file storage → Private GitHub store: reads & writes
- Security & redaction → Live radar: protects requests
- Security & redaction → CID intelligence: redacts member data