How sohana881/supplyshield works
SupplyShield is a supply-chain disruption recovery platform. Operators use the control-room UI to inspect incident and operational data, request recovery analysis, and review a policy-governed recovery result. The recovery service combines deterministic supply, shipment, route, supplier, and finance facts with specialist-agent analysis; security controls constrain sensitive actions and record audit events. The README describes these product capabilities, while several internal relationships are supported only by the source index, so unsampled implementation details are not expanded.
Main entry points: recovery_service.py Recovery Service · agent.py Command Agent · engine.py Policy Engine · main.py SupplyShield API
Components 24
Control Room
- Control Room UI
frontend/src/App.jsx - SupplyShield API
backend/main.py
Recovery Orchestration
- Recovery Service
services/recovery_service.py - Disruption Scenarios
simulation/scenarios.py
Specialist Agents
- Command Agent
agents/command_agent/agent.py - Inventory Agent
agents/inventory_agent/agent.py - Shipment Agent
agents/shipment_agent/agent.py - Supplier Agent
agents/supplier_agent/agent.py - Logistics Agent
agents/logistics_agent/agent.py - Finance Agent
agents/finance_agent/agent.py - Risk Agent
agents/risk_agent/agent.py - Procurement Agent
agents/procurement_agent/agent.py
Operational Facts
- Inventory Analysis
tools/inventory_tools.py - Shipment Analysis
tools/shipment_tools.py - Supplier Options
tools/supplier_tools.py - Route Analysis
tools/logistics_tools.py - Finance Checks
tools/finance_tools.py - Procurement Proposals
tools/procurement_tools.py
Security & Audit
- Policy Engine
security/engine.py - Security Guardrails
security/guardrails.py - Agent Permissions
security/permissions.py - Policy Configuration
security/policies.py - Audit Events
security/audit.py
Other components
- Operator
Connections 29
- Operator → Control Room UI: uses
- Control Room UI → SupplyShield API: requests recovery
frontend/src/App.jsx - SupplyShield API → Recovery Service: invokes
backend/main.py - Recovery Service → Command Agent: runs analysis
- Command Agent → Inventory Agent: delegates to
agents/command_agent/agent.py - Command Agent → Shipment Agent: delegates to
agents/command_agent/agent.py - Command Agent → Supplier Agent: delegates to
agents/command_agent/agent.py - Command Agent → Logistics Agent: delegates to
agents/command_agent/agent.py - Command Agent → Finance Agent: delegates to
agents/command_agent/agent.py - Command Agent → Risk Agent: delegates to
agents/command_agent/agent.py - Command Agent → Procurement Agent: delegates to
agents/command_agent/agent.py - Inventory Agent → Inventory Analysis: uses tools
agents/inventory_agent/agent.py - Shipment Agent → Shipment Analysis: uses tools
agents/shipment_agent/agent.py - Supplier Agent → Supplier Options: uses tools
agents/supplier_agent/agent.py - Logistics Agent → Route Analysis: uses tools
agents/logistics_agent/agent.py - Finance Agent → Finance Checks: uses tools
agents/finance_agent/agent.py - Procurement Agent → Procurement Proposals: uses tools
agents/procurement_agent/agent.py - Recovery Service → Inventory Analysis: verifies facts
services/recovery_service.py - Recovery Service → Shipment Analysis: verifies facts
services/recovery_service.py - Recovery Service → Supplier Options: finds options
services/recovery_service.py - Recovery Service → Route Analysis: finds routes
services/recovery_service.py - Recovery Service → Finance Checks: checks budget
services/recovery_service.py - Recovery Service → Security Guardrails: checks controls
services/recovery_service.py - Security Guardrails → Policy Engine: routes checks
security/guardrails.py - Policy Engine → Agent Permissions: checks access
security/engine.py - Policy Engine → Policy Configuration: loads policy
security/engine.py - Policy Engine → Audit Events: writes events
security/engine.py - SupplyShield API → Policy Engine: secures requests
backend/main.py - Disruption Scenarios → Operator: provides scenarios
simulation/scenarios.py