How innovaitors2026/sentry-sc-digital-twin works
SENTRY-SC is a supply-chain digital twin and disruption stress-test application, not an ML training system or live SAP connector. Users inspect the seeded network, configure disruptions and recoveries, simulate scenarios, then review results or compare scenarios. The React UI calls a FastAPI API; scenario storage supplies a fresh baseline twin to the discrete-time engine, which returns metrics, events, and timelines. The README documents additional risk-prediction and recovery-optimizer ingestion; sampled source confirms the risk adapter, while recovery details are less visible. Backend excerpts are partial, so some internal simulation links are intentionally omitted.
Main entry points: routes.py API Routes · client.ts API Client · Overview.tsx Network Overview · Results.tsx Simulation Results
Components 20
Demonstration UI
- Network Overview
frontend/src/pages/Overview.tsx - Stress Test
frontend/src/pages/StressTest.tsx - Simulation Results
frontend/src/pages/Results.tsx - Scenario Compare
frontend/src/pages/Compare.tsx - Node Details
frontend/src/pages/NodeDetails.tsx - Network Graph
frontend/src/components/NetworkGraph.tsx - Metric Cards
frontend/src/components/MetricCard.tsx - API Client
frontend/src/api/client.ts
HTTP API
- API Routes
backend/app/api/routes.py - API Contracts
backend/app/api/schemas.py
Scenario Simulation
- Scenario Store
backend/app/store.py - Daily Simulator
backend/app/simulation/engine.py
Twin Model
- Seeded Demo Network
backend/app/data/demo_network.py - Twin and Event Models
backend/app/domain/models.py
Adapters
- Risk Adapter
backend/app/adapters/risk.py - Recovery Adapter
backend/app/adapters/recovery.py - SAP Stub
backend/app/adapters/sap.py
Other components
- User
- Risk Prediction Provider
- Recovery Optimizer
Connections 30
- User → Network Overview: inspect
README.md - User → Stress Test: configure
README.md - User → Simulation Results: review
README.md - User → Scenario Compare: compare
README.md - User → Node Details: inspect node
- Network Overview → API Client: fetches network
frontend/src/pages/Overview.tsx - Stress Test → API Client: manages scenarios
frontend/src/pages/StressTest.tsx - Simulation Results → API Client: loads results
frontend/src/pages/Results.tsx - Scenario Compare → API Client: compares scenarios
frontend/src/pages/Compare.tsx - Node Details → API Client: fetches node
frontend/src/pages/NodeDetails.tsx - Network Overview → Network Graph: renders network
frontend/src/pages/Overview.tsx - Simulation Results → Network Graph: renders impacts
frontend/src/pages/Results.tsx - Simulation Results → Metric Cards: displays KPIs
frontend/src/pages/Results.tsx - Network Overview → Metric Cards: displays metrics
frontend/src/pages/Overview.tsx - Scenario Compare → Metric Cards: displays KPIs
frontend/src/pages/Compare.tsx - API Client → API Routes: calls REST API
frontend/src/api/client.ts - API Routes → API Contracts: uses contracts
backend/app/api/routes.py - API Routes → Scenario Store: reads and updates
backend/app/api/routes.py - API Routes → Daily Simulator: runs simulation
backend/app/api/routes.py - API Routes → Risk Adapter: translates predictions
backend/app/api/routes.py - API Routes → Recovery Adapter: translates recoveries
backend/app/api/routes.py - Scenario Store → Seeded Demo Network: builds baseline
backend/app/store.py - Seeded Demo Network → Twin and Event Models: constructs entities
backend/app/data/demo_network.py - Scenario Store → Twin and Event Models: stores scenarios
backend/app/store.py - Daily Simulator → Twin and Event Models: uses twin types
backend/app/simulation/engine.py - Risk Adapter → Twin and Event Models: creates disruptions
backend/app/adapters/risk.py - Risk Adapter → Scenario Store: validates targets against
backend/app/adapters/risk.py - Risk Prediction Provider → Risk Adapter: provides predictions
README.md - Recovery Optimizer → Recovery Adapter: provides interventions
README.md - SAP Stub → Seeded Demo Network: documents stub context
README.md