README.md

# pumpingStation

Wet-well basin model and pump orchestration node for EVOLV.

The detailed documentation lives in [`wiki/`](wiki/):

- [`wiki/functional-description.md`](wiki/functional-description.md) defines the shared basin model, pipe reference semantics, safety points, net-flow selection, and child registration behaviour.
- [`wiki/modes/`](wiki/modes/) documents control-mode-specific behaviour. For v1.0 the editor exposes `levelbased` and `manual`; levelbased supports linear and log curves with separate rising/falling ramp semantics.
- [`wiki/diagrams/basin-model.drawio.svg`](wiki/diagrams/basin-model.drawio.svg) is the current source of truth for the generic basin model.
- [`examples/basic-dashboard.flow.json`](examples/basic-dashboard.flow.json) provides a simple Node-RED Dashboard 2 flow with level, volume, demand, net-flow, and safety-state trends.
Update pumping station basin documentation 2026-05-05 10:38:24 +02:00			`# pumpingStation`

			`Wet-well basin model and pump orchestration node for EVOLV.`

			The detailed documentation lives in [`wiki/`](wiki/):

			- [`wiki/functional-description.md`](wiki/functional-description.md) defines the shared basin model, pipe reference semantics, safety points, net-flow selection, and child registration behaviour.
Docs + simulations refresh; align spill-flow keys with new position - wiki/functional-description.md: rename Overfill Protection → High-volume Safety; tighten basin-ordering chain; relocate level-based mode diagrams under wiki/diagrams/modes/level-based/; document the new flow.predicted.overflow.default position (replaces the previous child='overflow' under position 'out'); add underflowVolume + predictedUnderflowVolume entries. - wiki/modes/{levelbased,powerbased}.md: paragraph cleanups. - wiki/diagrams: move level-linear basin diagram under modes/level-based/ alongside a new level-log variant. - simulations/run.js: add max_demand_gt expectation. - simulations/scenarios/*: minor fixture updates. - test/basic/nodeClass-config.test.js: new config-shape coverage. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com> 2026-05-06 17:23:20 +02:00			- [`wiki/modes/`](wiki/modes/) documents control-mode-specific behaviour. For v1.0 the editor exposes `levelbased` and `manual`; levelbased supports linear and log curves with separate rising/falling ramp semantics.
Update pumping station basin documentation 2026-05-05 10:38:24 +02:00			- [`wiki/diagrams/basin-model.drawio.svg`](wiki/diagrams/basin-model.drawio.svg) is the current source of truth for the generic basin model.
Docs + simulations refresh; align spill-flow keys with new position - wiki/functional-description.md: rename Overfill Protection → High-volume Safety; tighten basin-ordering chain; relocate level-based mode diagrams under wiki/diagrams/modes/level-based/; document the new flow.predicted.overflow.default position (replaces the previous child='overflow' under position 'out'); add underflowVolume + predictedUnderflowVolume entries. - wiki/modes/{levelbased,powerbased}.md: paragraph cleanups. - wiki/diagrams: move level-linear basin diagram under modes/level-based/ alongside a new level-log variant. - simulations/run.js: add max_demand_gt expectation. - simulations/scenarios/*: minor fixture updates. - test/basic/nodeClass-config.test.js: new config-shape coverage. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com> 2026-05-06 17:23:20 +02:00			- [`examples/basic-dashboard.flow.json`](examples/basic-dashboard.flow.json) provides a simple Node-RED Dashboard 2 flow with level, volume, demand, net-flow, and safety-state trends.