How surendraraju09/sentinel-sc works
Sentinel-SC is a supply-chain disruption control tower. Users submit a news signal or fixture through the dashboard or API; the workflow extracts and correlates it with shipment records, assesses material shortage and order exposure, and—when recovery is needed—evaluates options before a human approval decision. The deterministic impact and recovery engines form the main internal decision layer, backed by mock ERP data and typed event, impact, and recovery contracts. Evidence is limited to the supplied excerpts and SOURCE INDEX; unsampled API and workflow details are not expanded beyond supported links.
Main entry points: graph.py Workflow orchestrator · recovery_agent.py Recovery agent · signal_agent.py Signal agent · impact_math.py Impact assessment
Components 19
Product entry points
- Control tower UI
app.py - HTTP API
api.py - Workflow orchestrator
graph.py
Signal intelligence
- Signal agent
agents/signal_agent.py - News fallback client
integrations/serp_client.py
Impact and recovery
- Impact assessment
engine/impact_math.py - BOM traversal
engine/bom_traversal.py - Recovery agent
agents/recovery_agent.py - Option calculator
engine/recovery_calculator.py - Constraint evaluator
engine/constraint_engine.py
ERP and contracts
- Mock ERP database
erp/mock_erp.db - Event contract
schemas/events.py - Impact contract
schemas/impact.py - Recovery contract
schemas/recovery.py
Other components
- Operations user
- API client
- SerpAPI
- Approver
- OpenAI service
Connections 21
- Operations user → Control tower UI: submits scenario
app.py - API client → HTTP API: sends request
api.py - Control tower UI → Workflow orchestrator: invokes workflow
app.py - HTTP API → Workflow orchestrator: uses workflow
api.py - Workflow orchestrator → Signal agent: ingests signal
graph.py - Signal agent → News fallback client: fetches news
agents/signal_agent.py - News fallback client → SerpAPI: queries
integrations/serp_client.py - Signal agent → Mock ERP database: correlates shipment
agents/signal_agent.py - Signal agent → Event contract: creates event
schemas/events.py - Workflow orchestrator → Impact assessment: computes impact
graph.py - Impact assessment → Mock ERP database: reads records
engine/impact_math.py - Impact assessment → BOM traversal: finds affected work
engine/impact_math.py - Impact assessment → Impact contract: returns assessment
schemas/impact.py - Workflow orchestrator → Recovery agent: proposes recovery
graph.py - Recovery agent → Option calculator: evaluates options
agents/recovery_agent.py - Recovery agent → Mock ERP database: reads templates
agents/recovery_agent.py - Recovery agent → OpenAI service: summarizes plan
agents/recovery_agent.py - Option calculator → Constraint evaluator: evaluates rules
engine/recovery_calculator.py - Constraint evaluator → Mock ERP database: reads rulebook
engine/constraint_engine.py - Recovery agent → Recovery contract: returns plan
agents/recovery_agent.py - Workflow orchestrator → Approver: requests decision
graph.py