How dakshverma-dev/sih-2026-121 works
ThermoLift Twin is a local digital-twin prototype for synthetic heavy-oil wells, not a field-control system. Its user workflow is Monitor → Diagnose → Simulate and decide → Validate: the replay combines synthetic plant observations, state estimates and pump diagnosis; the API exposes forecasts and pump/CSS recommendations; operators review and apply decisions only to the simulation; benchmark screens compare outcomes. The map retains the documented health and benchmark capabilities. Relationships among backend modules are based on the SOURCE INDEX and README; unsampled implementation details are not inferred.
Main entry points: Console.tsx Operations console · api.ts API client · api.py REST and jobs API · sim.py Simulation replay
Components 24
Operator interface
- Landing page
apps/web/src/pages/Landing.tsx - Operations console
apps/web/src/Console.tsx - Well overview
apps/web/src/pages/Overview.tsx - Pump evidence
apps/web/src/pages/PumpEvidence.tsx - Pump what-if
apps/web/src/pages/WhatIf.tsx - CSS planner
apps/web/src/pages/CssPlanner.tsx - Evidence and benchmarks
apps/web/src/pages/Benchmarks.tsx - Data and model health
apps/web/src/pages/Health.tsx - Charts
apps/web/src/components/Chart.tsx - Wellbore view
apps/web/src/components/Wellbore.tsx - Shared UI
apps/web/src/components/ui.tsx - API client
apps/web/src/api.ts
Replay and API
- REST and jobs API
thermolift/api.py - Simulation replay
thermolift/sim.py - Recommendation audit store
thermolift/store.py
Well models
- Synthetic plant and sensors
thermolift/plant.py - Thermal and lift physics
thermolift/physics.py - State observer and forecasts
thermolift/twin.py - Assets and constraints
thermolift/config.py
Advice and validation
- Stroke diagnosis
thermolift/diagnostics.py - Pump policy search
thermolift/optimise.py - CSS plan search
thermolift/optimise.py - Matched-run evaluation
thermolift/benchmark.py
Other components
- Operator
Connections 38
- Operator → Landing page: opens
- Operator → Operations console: operates
README.md - Landing page → Operations console: routes to
apps/web/src/App.tsx - Operations console → Well overview: renders
apps/web/src/Console.tsx - Operations console → Pump evidence: renders
apps/web/src/Console.tsx - Operations console → Pump what-if: renders
apps/web/src/Console.tsx - Operations console → CSS planner: renders
apps/web/src/Console.tsx - Operations console → Evidence and benchmarks: renders
apps/web/src/Console.tsx - Operations console → Data and model health: renders
apps/web/src/Console.tsx - Operations console → API client: fetches state
apps/web/src/Console.tsx - Well overview → API client: requests data
apps/web/src/pages/Overview.tsx - Pump evidence → API client: requests data
apps/web/src/pages/PumpEvidence.tsx - Pump what-if → API client: submits candidates
apps/web/src/pages/WhatIf.tsx - CSS planner → API client: submits plans
apps/web/src/pages/CssPlanner.tsx - Evidence and benchmarks → API client: requests results
apps/web/src/pages/Benchmarks.tsx - Data and model health → API client: requests status
apps/web/src/pages/Health.tsx - Well overview → Charts: renders trends
apps/web/src/pages/Overview.tsx - Well overview → Wellbore view: renders detail
apps/web/src/pages/Overview.tsx - Well overview → Shared UI: uses controls
apps/web/src/pages/Overview.tsx - API client → REST and jobs API: calls REST API
README.md - REST and jobs API → Simulation replay: reads replay
thermolift/api.py - REST and jobs API → Recommendation audit store: records decisions
thermolift/api.py - REST and jobs API → Pump policy search: requests advice
thermolift/api.py - REST and jobs API → CSS plan search: requests plans
thermolift/api.py - REST and jobs API → Matched-run evaluation: runs evaluation
thermolift/api.py - Simulation replay → Synthetic plant and sensors: advances plant
thermolift/sim.py - Simulation replay → State observer and forecasts: updates observer
thermolift/sim.py - Simulation replay → Stroke diagnosis: evaluates strokes
thermolift/sim.py - Simulation replay → Pump policy search: generates advice
thermolift/sim.py - Synthetic plant and sensors → Thermal and lift physics: steps physics
thermolift/plant.py - Synthetic plant and sensors → Assets and constraints: loads parameters
thermolift/plant.py - State observer and forecasts → Thermal and lift physics: uses models
thermolift/twin.py - State observer and forecasts → Assets and constraints: loads parameters
thermolift/twin.py - Pump policy search → Thermal and lift physics: evaluates candidates
thermolift/optimise.py - Pump policy search → Assets and constraints: uses constraints
thermolift/optimise.py - CSS plan search → Thermal and lift physics: evaluates injection
thermolift/optimise.py - CSS plan search → Assets and constraints: uses constraints
thermolift/optimise.py - Matched-run evaluation → Simulation replay: compares runs