How ay178/digital-twin- works
This is a spacecraft digital-twin mission dashboard. Operators choose mission parameters and optional faults, request a simulated telemetry run, then inspect health, remaining useful life, anomaly evidence, physics residuals, and recommended actions while scrubbing through cycles. The backend orchestrates telemetry replay, fault injection, model predictions, thermal comparison, and explanations; the frontend presents results and supports what-if mitigation and fleet views. The README is empty, so capability evidence comes from the sampled source; frontend-to-backend HTTP wiring and the role of the legacy model utility are not verified.
Main entry points: App.jsx Mission dashboard · main.py Twin API · spacecraft_channels.py Telemetry channel catalog · model_utils_v2.py Telemetry model pipeline
Components 16
Mission Dashboard
- Mission dashboard
frontend/src/App.jsx - Simulation client
frontend/src/api.js - Fault client
frontend/src/faultApi.js - Spacecraft view
frontend/src/SpacecraftVisual3D.jsx - Mission backdrop
frontend/src/WarRoomBackground.jsx - Recommendation panel
frontend/src/components/RecommendationPanel.jsx - Offline mission agent
frontend/src/components/AgentChat.jsx - Physics chart
frontend/src/components/PhysicsChart.jsx
API Orchestration
- Twin API
backend/app/main.py
Twin Analysis
- Telemetry model pipeline
backend/app/model_utils_v2.py - Legacy model utilities
backend/app/model_utils.py - Fault injection
backend/app/faults.py - Thermal physics twin
backend/app/physics_twin.py - Diagnosis builder
backend/app/explain.py
Spacecraft Domain
- Telemetry channel catalog
backend/app/spacecraft_channels.py
Other components
- Mission operator
Connections 20
- Mission operator → Mission dashboard: sets mission
frontend/src/App.jsx - Mission dashboard → Simulation client: requests runs
frontend/src/App.jsx - Mission dashboard → Fault client: loads faults
frontend/src/App.jsx - Mission dashboard → Spacecraft view: renders status
frontend/src/App.jsx - Mission dashboard → Mission backdrop: renders backdrop
frontend/src/App.jsx - Mission dashboard → Recommendation panel: renders diagnoses
frontend/src/App.jsx - Mission dashboard → Offline mission agent: supplies twin state
frontend/src/App.jsx - Mission dashboard → Physics chart: renders analysis
frontend/src/App.jsx - Simulation client → Twin API: requests simulation
- Fault client → Twin API: requests fault list
- Twin API → Telemetry model pipeline: loads and predicts
backend/app/main.py - Twin API → Fault injection: injects selected fault
backend/app/main.py - Twin API → Thermal physics twin: computes residuals
backend/app/main.py - Twin API → Diagnosis builder: builds diagnoses
backend/app/main.py - Twin API → Telemetry channel catalog: labels telemetry
backend/app/main.py - Telemetry model pipeline → Fault injection: uses fault definitions
backend/app/model_utils_v2.py - Telemetry model pipeline → Telemetry channel catalog: uses channel order
backend/app/model_utils_v2.py - Fault injection → Telemetry channel catalog: maps fault channels
backend/app/faults.py - Diagnosis builder → Telemetry channel catalog: maps error channels
backend/app/explain.py - Thermal physics twin → Physics chart: provides residual data