Build a Solar Farm Water Pipeline Leak and Wash Outage Coordinator — implementation

## Build
Correlate hydraulic pressure telemetry across utility-scale solar demineralized water distribution mains. Formulate isolation valving plans to contain pipe leaks without disrupting automated cleaning robot water stations.

## User
Solar plant balance-of-plant technicians and water distribution maintenance engineers

## Workflow
1. Ingest ultrasonic flowmeter and pressure sensor telemetry across the solar field cleaning water pipeline.
2. Isolate pipe bursts and locate low-pressure wash nodes using WNTR hydraulic simulation routines.
3. Reroute water flows across secondary loops to maintain pressure at automated robot refill docks.
4. Compile a valve isolation work ticket and wash reschedule plan for operations team verification.

## Interface
Solar field pipeline network map displaying pressure heatmaps, burst locations, and cleaning robot refill status.

## Data
WNTR synthetic rural distribution network files configured to match a 500MW solar plant demineralized water grid.
Starter examples below are synthetic. They are not downloaded records.

## Source
[Water Network Tool for Resilience](https://raw.githubusercontent.com/USEPA/WNTR/main/README.md)
Uses WNTR network models to simulate pipe bursts, leak discharges, and pressure-dependent delivery across wash lines.

## Tools
semantic-kernel, pydantic-ai, wntr, pandas.
semantic-kernel orchestrates complex enterprise telemetry analysis plugins and generates structured action plans.
Hosted LLM API capable of executing semantic kernel functions and generating clear operational steps.

## Deliverables
Submit runnable source, pinned dependencies, setup commands, a working interface, example outputs, and a recorded end-to-end demo. Include tests and an action log.

## Acceptance
- Detects and localizes pipeline bursts using nodal pressure drops simulated in WNTR.
- Identifies boundary isolation valves required to seal off the damaged pipeline segment.
- Calculates residual pressure at solar panel washing robot docking stations to confirm refill viability.
- Requires maintenance superintendent confirmation before issuing physical field isolation tickets.

## Starter Examples
```json
[
  {
    "input": {
      "pipe_id": "W-MAIN-14",
      "measured_flow_lps": 85,
      "expected_flow_lps": 40,
      "measured_pressure_bar": 1.2,
      "downstream_refill_docks": [
        "DOCK-01",
        "DOCK-02"
      ]
    },
    "expected_output": {
      "burst_detected": true,
      "leak_discharge_est_lps": 45,
      "valves_to_close": [
        "VALVE-28",
        "VALVE-29"
      ],
      "docks_operational_via_loop": [
        "DOCK-01"
      ],
      "docks_starved": [
        "DOCK-02"
      ],
      "action_order": "Isolate W-MAIN-14; reroute DOCK-02 cleaning robot to DOCK-01."
    }
  },
  {
    "input": {
      "pipe_id": "W-MAIN-08",
      "measured_flow_lps": 38,
      "expected_flow_lps": 37.5,
      "measured_pressure_bar": 3.8,
      "downstream_refill_docks": [
        "DOCK-03"
      ]
    },
    "expected_output": {
      "burst_detected": false,
      "leak_discharge_est_lps": 0.5,
      "valves_to_close": [],
      "docks_operational_via_loop": [
        "DOCK-03"
      ],
      "docks_starved": [],
      "action_order": "Normal operation; flow and pressure within tolerance."
    }
  }
]
```

## Safety
Simulation of hydraulic isolation only; physical valve operations require lockout-tagout protocol verification on site.
Use mock external writes. Require human review before any real deployment.