How kulalpavan/skyguard-ai-mini-project works
SkyGuard-AI is a weather-station anomaly detection and fleet operations product. Station telemetry is ingested and assessed against station-specific baselines, physical/QC checks, and fleet evidence; the system then explains classifications, supports recovery, and exposes monitoring, incident, maintenance, and model-governance workflows. The graph includes the documented analytics stages and the sampled backend, ML, and frontend layers. Some API and operational subsystem internals were not sampled, so their links are limited to documented or indexed relationships.
Main entry points: observation_pipeline.py Observation Assessment · apiClient.js Backend API Client · training_service.py Model Training · WeatherContext.jsx Fleet State
Components 30
Station Edge
- Weather Station
- ESP32 Edge
ESP32/skyguard_edge.h
Backend Services
- Telemetry API
backend/app/api/v1/telemetry.py - Observation Assessment
backend/app/services/observation_pipeline.py - Operational Database
backend/app/storage/database.py - Authentication API
backend/app/api/v1/auth.py - Auth Security
backend/app/auth/security.py - Station API
backend/app/api/v1/stations.py - Incident API
backend/app/api/v1/incidents.py - Maintenance API
backend/app/api/v1/maintenance.py - Evidence API
backend/app/api/v1/evidence.py - Model Artifacts
backend/app/services/model_storage.py
Assessment Intelligence
- Station Climatology
ml/climatology_engine.py - Residual Features
ml/feature_engine.py - Thermodynamic Checks
ml/thermo_engine.py - Adaptive Anomaly ML
ml/station_adaptive_pipeline.py - Fleet Adjudication
ml/spatial_engine.py - Value Reconstruction
ml/imputation_engine.py - Sensor Health
ml/sensor_health.py - Root Cause Reasoning
backend/app/services/incident_reasoning.py - Model Training
backend/app/services/training_service.py
Operator Console
- Session and Station Access
src/context/AuthContext.jsx - Backend API Client
src/utils/apiClient.js - Fleet State
src/context/WeatherContext.jsx - Console View Router
src/App.jsx - Station Operations Views
src/components/views/StationHUD.jsx - Fleet and Incident Views
src/components/views/Incidents.jsx - Model Governance Views
src/components/views/ModelGovernance.jsx - Operator Audio Alerts
src/utils/audio.js
Other components
- Operator
Connections 37
- Weather Station → ESP32 Edge: sends readings
- ESP32 Edge → Telemetry API: uploads telemetry
- Telemetry API → Observation Assessment: assesses observations
- Observation Assessment → Operational Database: reads and writes
backend/app/services/observation_pipeline.py - Observation Assessment → Station Climatology: checks baseline
- Observation Assessment → Thermodynamic Checks: checks physics
backend/app/services/observation_pipeline.py - Observation Assessment → Residual Features: builds features
backend/app/services/observation_pipeline.py - Residual Features → Station Climatology: computes residuals
ml/feature_engine.py - Residual Features → Thermodynamic Checks: derives features
ml/feature_engine.py - Observation Assessment → Adaptive Anomaly ML: scores station
- Observation Assessment → Fleet Adjudication: adjudicates peers
backend/app/services/observation_pipeline.py - Observation Assessment → Sensor Health: checks sensor health
backend/app/services/observation_pipeline.py - Observation Assessment → Root Cause Reasoning: requests reasoning
backend/app/services/observation_pipeline.py - Observation Assessment → Value Reconstruction: reconstructs values
- Observation Assessment → Model Training: requests training
backend/app/services/observation_pipeline.py - Model Training → Residual Features: builds training features
backend/app/services/training_service.py - Model Training → Station Climatology: fits baseline
backend/app/services/training_service.py - Model Training → Adaptive Anomaly ML: trains station model
backend/app/services/training_service.py - Model Training → Model Artifacts: persists artifacts
backend/app/services/training_service.py - Model Artifacts → Operational Database: uses configured storage
- Authentication API → Auth Security: verifies credentials
backend/app/api/v1/auth.py - Authentication API → Operational Database: reads accounts
backend/app/api/v1/auth.py - Operator → Console View Router: uses console
- Console View Router → Session and Station Access: checks session
src/App.jsx - Console View Router → Fleet State: selects views
src/App.jsx - Session and Station Access → Backend API Client: authenticates and loads stations
src/context/AuthContext.jsx - Fleet State → Backend API Client: fetches fleet data
src/context/WeatherContext.jsx - Fleet State → Fleet Adjudication: runs fleet analysis
src/context/WeatherContext.jsx - Fleet State → Operator Audio Alerts: plays alerts
src/context/WeatherContext.jsx - Station Operations Views → Backend API Client: requests station data
src/components/views/StationHUD.jsx - Fleet and Incident Views → Fleet State: shows incidents
- Model Governance Views → Backend API Client: manages model state
- Backend API Client → Telemetry API: posts telemetry
src/utils/apiClient.js - Backend API Client → Station API: requests station data
src/utils/apiClient.js - Backend API Client → Incident API: requests incidents
src/utils/apiClient.js - Backend API Client → Evidence API: requests evidence
- Backend API Client → Maintenance API: requests maintenance