How varad-lingayat/epidemic-intervention-planner works
EpiGraph is an epidemic-intervention planning simulator for graph-theory teaching. Users configure a city network and epidemic scenario, compare intervention strategies, inspect outcomes and sensitivity, then save or share reports. The sampled simulation engine models discrete-time spread over synthetic city graphs; the repository also contains OpenStreetMap import, explanation, persistence, and visualization capabilities. The README is empty, so capability coverage comes from the source tree and excerpts; links for unsampled feature modules are omitted where invocation evidence is unavailable.
Main entry points: App.tsx Web app routes · routers.ts tRPC API routes · explanations.ts Explanation API · db.ts Scenario database
Components 23
Scenario application
- Web app routes
client/src/App.tsx - Scenario workspace
client/src/pages/Home.tsx - Network visualization
client/src/components/NetworkGraph.tsx - Outcome charts
client/src/components/ScenarioCharts.tsx - Report preview
client/src/components/ScenarioReportPreview.tsx - Shared report view
client/src/pages/SharedReport.tsx - API client
client/src/main.tsx
Epidemic modeling
- Graph and epidemic types
shared/epidemic.ts - SIR simulation engine
shared/epidemicEngine.ts - Intervention strategies
shared/interventions.ts - Sensitivity analysis
shared/sensitivityAnalysis.ts - Initial infection selection
shared/initialInfectionSelection.ts
Application services
- OpenStreetMap import
server/osmImport.ts - Decision explanations
server/decisionExplanation.ts - Explanation summaries
shared/explanationSummary.ts - tRPC API routes
server/routers.ts - Scenario and report API
server/routers/scenarios.ts - OSM API
server/routers/osm.ts - Explanation API
server/routers/explanations.ts
Scenario persistence
- Scenario database
server/db.ts - Persistent data schema
drizzle/schema.ts - Desktop local store
server/desktopLocalStore.ts
Other components
- Planner
Connections 18
- Planner → Web app routes: opens
client/src/App.tsx - Web app routes → Scenario workspace: routes to
client/src/App.tsx - Web app routes → Shared report view: routes to
client/src/App.tsx - API client → Web app routes: renders
client/src/main.tsx - Report preview → Network visualization: renders
client/src/components/ScenarioReportPreview.tsx - Report preview → Outcome charts: renders
client/src/components/ScenarioReportPreview.tsx - SIR simulation engine → Graph and epidemic types: uses types
shared/epidemicEngine.ts - Intervention strategies → Graph and epidemic types: uses
shared/interventions.ts - Intervention strategies → SIR simulation engine: uses
shared/interventions.ts - tRPC API routes → OSM API: registers
server/routers.ts - tRPC API routes → Scenario and report API: registers
server/routers.ts - tRPC API routes → Explanation API: registers
server/routers.ts - OSM API → OpenStreetMap import: calls
server/routers/osm.ts - Explanation API → Decision explanations: calls
server/routers/explanations.ts - Explanation API → Explanation summaries: uses
server/routers/explanations.ts - Scenario and report API → Scenario database: reads and writes
server/routers/scenarios.ts - Scenario database → Persistent data schema: uses schema
server/db.ts - Scenario database → Desktop local store: uses
server/db.ts