Update pumping station basin documentation

Editor: pin outlet, add zone labels + volume to the diagram
Three user-facing fixes: 1. Outlet was getting pushed below the tank floor by the top-down nudge because its ideal y is already near the bottom. Now outflowLevel is PINNED at its proportional y (like basinHeight is pinned at the rim) and a second bottom-up pass pushes non-pinned items upward from the outlet anchor. Result: outlet stays near the tank floor, dryRunLevel sits right above it, the rest of the stack stays readable. Two anchors, two passes. 2. Zone labels mirrored from the wiki basin-model drawio: - "Spare volume before spilling" (overflowLevel ↔ maxLevel) - "Sewage + tank buffer" (maxLevel ↔ startLevel) - "Tank buffer" (startLevel ↔ minLevel) - "Tank buffer" (minLevel ↔ dryRunLevel) - "Dead volume" (outflowLevel ↔ floor) Each sits at the midpoint of its pair of nudged thresholds and hides when the gap between them is too small to read (< 14 px). 3. basinVolume moved into the SVG as a pinned input above the tank rim (alongside basinHeight), replacing the separate form row. One editor, one diagram — the total volume belongs with the geometry. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-05 10:38:24 +02:00 · 2026-04-23 13:19:58 +02:00 · 2026-04-23 12:10:23 +02:00 · 2026-04-23 11:41:03 +02:00 · 2026-04-23 10:41:16 +02:00 · 2026-04-23 10:28:18 +02:00
12 changed files with 364 additions and 474 deletions
--- a/README.md
+++ b/README.md
@@ -1 +1,9 @@
-# rotating machine
+# 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 such as the level-linear `startLevel` demand ramp.
+- [`wiki/diagrams/basin-model.drawio.svg`](wiki/diagrams/basin-model.drawio.svg) is the current source of truth for the generic basin model.
--- a/pumpingStation.html
+++ b/pumpingStation.html
@@ -173,31 +173,175 @@
      setNumberField('node-input-flowSetpoint', this.flowSetpoint);
      setNumberField('node-input-flowDeadband', this.flowDeadband);

-      // Live-compute derived safety levels so the operator can see
-      // what the % will actually trip at. Mirrors the code formula
-      // in specificClass._validateThresholdOrdering.
-      const fNum = (id) => parseFloat(document.getElementById(`node-input-${id}`)?.value);
-      const updateDerivedLevels = () => {
-        const basedOn = document.getElementById('node-input-minHeightBasedOn')?.value || 'outlet';
-        const refLow = basedOn === 'inlet' ? fNum('inflowLevel') : fNum('outflowLevel');
-        const dryRunPct = fNum('dryRunThresholdPercent');
-        const overfillPct = fNum('overfillThresholdPercent');
-        const overflow = fNum('overflowLevel');
-        const dryRunLvl = Number.isFinite(refLow) && Number.isFinite(dryRunPct)
-          ? refLow * (1 + dryRunPct / 100) : null;
-        const overfillLvl = Number.isFinite(overflow) && Number.isFinite(overfillPct)
-          ? overflow * (overfillPct / 100) : null;
-        const dryEl = document.getElementById('derived-dryRunLevel');
-        const ovfEl = document.getElementById('derived-overfillLevel');
-        if (dryEl) dryEl.textContent = dryRunLvl != null ? `→ dryRunLevel ≈ ${dryRunLvl.toFixed(2)} m` : '→ dryRunLevel ≈ — m';
-        if (ovfEl) ovfEl.textContent = overfillLvl != null ? `→ overfillLevel ≈ ${overfillLvl.toFixed(2)} m` : '→ overfillLevel ≈ — m';
+      // Interactive diagram: place every threshold line/input at its
+      // proportional y on the tank, plus compute derived safety levels
+      // (dryRunLevel, overfillLevel) that are shown both in the diagram
+      // and next to the safety-% fields. Same formulas as
+      // specificClass._validateThresholdOrdering.
+      const DIAG = { topY: 40, botY: 380 };
+      const fNum = (id) => {
+        const v = parseFloat(document.getElementById(`node-input-${id}`)?.value);
+        return Number.isFinite(v) ? v : null;
      };
-      ['inflowLevel','outflowLevel','overflowLevel','minHeightBasedOn','dryRunThresholdPercent','overfillThresholdPercent']
-        .forEach((id) => {
-          const el = document.getElementById(`node-input-${id}`);
-          if (el) { el.addEventListener('input', updateDerivedLevels); el.addEventListener('change', updateDerivedLevels); }
-        });
-      setTimeout(updateDerivedLevels, 50);
+      const yForLevel = (val, basinH) => {
+        if (val == null || !basinH) return null;
+        const y = DIAG.botY - (val / basinH) * (DIAG.botY - DIAG.topY);
+        return Math.max(DIAG.topY - 8, Math.min(DIAG.botY + 8, y));
+      };
+      // Place a row — line, label, input, unit all share the same y.
+      // The diagram is a schematic ordered list (value order is
+      // preserved, but the y-positions are distributed with a
+      // guaranteed minimum gap for readability), not a strictly
+      // proportional rendering.
+      const placeItem = (id, y) => {
+        const line  = document.getElementById(`ps-line-${id}`);
+        const label = document.getElementById(`ps-label-${id}`);
+        const unit  = document.getElementById(`ps-unit-${id}`);
+        const fo    = document.getElementById(`ps-fo-${id}`);
+        const sub   = document.getElementById(`ps-sub-${id}`);
+        const lead  = document.getElementById(`ps-leader-${id}`);
+        if (line)  { line.setAttribute('y1', y); line.setAttribute('y2', y); }
+        if (label) label.setAttribute('y', y + 4);
+        if (unit)  unit.setAttribute('y', y + 4);
+        if (fo)    fo.setAttribute('y', y - 11);
+        if (sub)   sub.setAttribute('y', y + 15);
+        if (lead)  lead.setAttribute('visibility', 'hidden');
+      };
+
+      const redraw = () => {
+        const basinH = fNum('basinHeight') || 5;
+
+        // Derived safety levels (participate in the right-column stack)
+        const basedOn = document.getElementById('node-input-minHeightBasedOn')?.value || 'outlet';
+        const refLow  = basedOn === 'inlet' ? fNum('inflowLevel') : fNum('outflowLevel');
+        const dryPct  = fNum('dryRunThresholdPercent');
+        const ovfPct  = fNum('overfillThresholdPercent');
+        const ovf     = fNum('overflowLevel');
+        const dryLvl  = (refLow != null && dryPct != null) ? refLow * (1 + dryPct / 100) : null;
+        const ovfLvl  = (ovf    != null && ovfPct != null) ? ovf    * (ovfPct / 100)     : null;
+
+        // Right-column stack. TWO anchors: basinHeight pinned at the
+        // tank rim (top) and outflowLevel pinned at its proportional y
+        // (bottom). Everything between is nudged to maintain a minimum
+        // vertical gap via two passes — top-down from the rim, then
+        // bottom-up from the outlet — so the dashed lines keep their
+        // value-order and outlet stays near the floor where it belongs.
+        const items = [
+          { id: 'basinHeight',   yIdeal: DIAG.topY,                                pinned: true },
+          { id: 'overflowLevel', yIdeal: yForLevel(fNum('overflowLevel'), basinH) },
+          { id: 'maxLevel',      yIdeal: yForLevel(fNum('maxLevel'),      basinH) },
+          { id: 'startLevel',    yIdeal: yForLevel(fNum('startLevel'),    basinH) },
+          { id: 'minLevel',      yIdeal: yForLevel(fNum('minLevel'),      basinH) },
+          { id: 'dryRunLevel',   yIdeal: yForLevel(dryLvl,                basinH) },
+          { id: 'outflowLevel',  yIdeal: yForLevel(fNum('outflowLevel'),  basinH), pinned: true },
+        ].filter(it => it.yIdeal != null);
+
+        const GAP = 36;
+        items.sort((a, b) => a.yIdeal - b.yIdeal);
+        for (const it of items) it.y = it.yIdeal;
+        // Pass 1: top-down — push DOWN to maintain GAP; pinned items don't move
+        for (let i = 1; i < items.length; i++) {
+          if (items[i].pinned) continue;
+          items[i].y = Math.max(items[i].y, items[i - 1].y + GAP);
+        }
+        // Pass 2: bottom-up — push UP so outflow's pin propagates up the stack
+        for (let i = items.length - 2; i >= 0; i--) {
+          if (items[i].pinned) continue;
+          items[i].y = Math.min(items[i].y, items[i + 1].y - GAP);
+        }
+        for (const it of items) placeItem(it.id, it.y);
+
+        // Zone labels between adjacent thresholds (italic, centered).
+        // Hidden if either bracketing threshold is missing, or the gap
+        // is too small to read (< 14 px).
+        const placeZone = (zoneId, topId, botId) => {
+          const el = document.getElementById(`ps-zone-${zoneId}`);
+          if (!el) return;
+          const top = items.find(it => it.id === topId);
+          const bot = items.find(it => it.id === botId);
+          if (!top || !bot || (bot.y - top.y) < 14) {
+            el.setAttribute('visibility', 'hidden'); return;
+          }
+          el.setAttribute('y', (top.y + bot.y) / 2 + 3);
+          el.setAttribute('visibility', 'visible');
+        };
+        placeZone('spare',   'overflowLevel', 'maxLevel');
+        placeZone('sewage',  'maxLevel',      'startLevel');
+        placeZone('buffer1', 'startLevel',    'minLevel');
+        placeZone('buffer2', 'minLevel',      'dryRunLevel');
+        // "Dead volume" sits inside the blue band between outflowLevel and the floor
+        const outflowPinned = items.find(it => it.id === 'outflowLevel');
+        const deadLbl = document.getElementById('ps-zone-dead');
+        if (deadLbl && outflowPinned && (DIAG.botY - outflowPinned.y) > 14) {
+          deadLbl.setAttribute('y', (outflowPinned.y + DIAG.botY) / 2 + 3);
+          deadLbl.setAttribute('visibility', 'visible');
+        } else if (deadLbl) {
+          deadLbl.setAttribute('visibility', 'hidden');
+        }
+
+        // Inlet arrow — sole item on the left, no stacking concerns
+        const inflowY = yForLevel(fNum('inflowLevel'), basinH);
+        if (inflowY != null) {
+          const line = document.getElementById('ps-line-inflowLevel');
+          const lbl  = document.getElementById('ps-label-inflowLevel');
+          const sub  = document.getElementById('ps-sub-inflowLevel');
+          const fo   = document.getElementById('ps-fo-inflowLevel');
+          const unit = document.getElementById('ps-unit-inflowLevel');
+          if (line) { line.setAttribute('y1', inflowY); line.setAttribute('y2', inflowY); }
+          if (lbl)  lbl.setAttribute('y', inflowY - 4);
+          if (sub)  sub.setAttribute('y', inflowY + 8);
+          if (fo)   fo.setAttribute('y', inflowY - 11);
+          if (unit) unit.setAttribute('y', inflowY + 4);
+        }
+
+        // Dead-volume band: from the (possibly-nudged) outflow line
+        // down to the floor. Use the nudged y so the band meets the
+        // outflow line exactly.
+        const outflowItem = items.find(it => it.id === 'outflowLevel');
+        const deadvol    = document.getElementById('ps-deadvol');
+        if (deadvol && outflowItem) {
+          deadvol.setAttribute('y', outflowItem.y);
+          deadvol.setAttribute('height', Math.max(0, DIAG.botY - outflowItem.y));
+        }
+
+        // dryRunLevel label text (derived, read-only)
+        const dryLbl = document.getElementById('ps-label-dryRunLevel');
+        if (dryLbl) dryLbl.textContent = dryLvl != null
+          ? `dryRunLevel ≈ ${dryLvl.toFixed(2)} m (safety — from %)`
+          : 'dryRunLevel ≈ — m (safety — from %)';
+
+        // Safety-section readouts (second view, beneath the diagram)
+        const d1 = document.getElementById('derived-dryRunLevel');
+        if (d1) d1.textContent = dryLvl != null ? `→ dryRunLevel ≈ ${dryLvl.toFixed(2)} m` : '→ dryRunLevel ≈ — m';
+        const d2 = document.getElementById('derived-overfillLevel');
+        if (d2) d2.textContent = ovfLvl != null ? `→ overfillLevel ≈ ${ovfLvl.toFixed(2)} m` : '→ overfillLevel ≈ — m';
+
+        // Ordering warning ribbon
+        const warn = document.getElementById('ps-warning');
+        const issues = [];
+        const pairs = [
+          ['outflowLevel', 'inflowLevel',   '<'],
+          ['inflowLevel',  'overflowLevel', '<'],
+          ['minLevel',     'startLevel',    '<='],
+          ['startLevel',   'maxLevel',      '<'],
+          ['maxLevel',     'overflowLevel', '<='],
+        ];
+        for (const [a, b, op] of pairs) {
+          const av = fNum(a), bv = fNum(b);
+          if (av == null || bv == null) continue;
+          if (op === '<' ? !(av < bv) : !(av <= bv)) issues.push(`${a} ${op} ${b}`);
+        }
+        if (warn) {
+          if (issues.length) { warn.setAttribute('visibility', 'visible'); warn.textContent = `⚠ Check ordering: ${issues.join(', ')}`; }
+          else { warn.setAttribute('visibility', 'hidden'); }
+        }
+      };
+      ['basinHeight','overflowLevel','maxLevel','startLevel','minLevel','inflowLevel','outflowLevel',
+       'dryRunThresholdPercent','overfillThresholdPercent','minHeightBasedOn'].forEach((id) => {
+        const el = document.getElementById(`node-input-${id}`);
+        if (el) { el.addEventListener('input', redraw); el.addEventListener('change', redraw); }
+      });
+      setTimeout(redraw, 60);

        //------------------- END OF CUSTOM config UI ELEMENTS ------------------- //
    },
@@ -250,30 +394,124 @@

  <hr>
  
-  <h4>Basin Geometry</h4>
-  <p style="font-size:12px;color:#777;margin:0 0 8px 0;">All heights measured from the basin floor (0 m).</p>
-  <div class="form-row">
-    <label for="node-input-basinVolume"><i class="fa fa-cube"></i> Basin Volume (m³)</label>
-    <input type="number" id="node-input-basinVolume" min="0" step="0.1" />
-  </div>
-  <div class="form-row">
-    <label for="node-input-basinHeight"><i class="fa fa-arrows-v"></i> Basin Height (m)</label>
-    <input type="number" id="node-input-basinHeight" min="0" step="0.1" />
-  </div>
+  <h4>Basin parameters</h4>
+  <p style="font-size:12px;color:#777;margin:0 0 8px 0;">Heights are measured from the basin floor (0 m). Enter values next to each line — the diagram scales to whatever you enter.</p>

-  <!-- Inlet/Outlet elevations -->
-  <div class="form-row">
-    <label for="node-input-inflowLevel"><i class="fa fa-long-arrow-up"></i> Inlet (bottom of pipe, m)</label>
-    <input type="number" id="node-input-inflowLevel" min="0" step="0.01" />
-  </div>
-  <div class="form-row">
-    <label for="node-input-outflowLevel"><i class="fa fa-long-arrow-down"></i> Outlet (top of pipe, m)</label>
-    <input type="number" id="node-input-outflowLevel" min="0" step="0.01" />
-  </div>
-  <div class="form-row">
-    <label for="node-input-overflowLevel"><i class="fa fa-tint"></i> Overflow (weir crest, m)</label>
-    <input type="number" id="node-input-overflowLevel" min="0" step="0.01" />
-  </div>
+  <style>
+    #ps-basin-diagram input[type=number] {
+      width: 100%; height: 20px; box-sizing: border-box;
+      font-size: 11px; padding: 1px 4px; margin: 0;
+      border: 1px solid #ccc; border-radius: 3px; background: #fff;
+    }
+    #ps-basin-diagram input[type=number]:focus { outline: 1px solid #0c99d9; border-color: #0c99d9; }
+  </style>
+
+  <svg id="ps-basin-diagram" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 520 430"
+       style="display:block;width:100%;max-width:540px;margin:0 0 12px 0;background:#fff;border:1px solid #e5e5e5;border-radius:4px;"
+       font-family="Arial,sans-serif" font-size="11">
+    <defs>
+      <marker id="ps-arrow" viewBox="0 0 10 10" refX="9" refY="5" markerWidth="7" markerHeight="7" orient="auto-start-reverse">
+        <path d="M 0 0 L 10 5 L 0 10 z" fill="#1F4E79" />
+      </marker>
+    </defs>
+
+    <!-- Tank body -->
+    <rect x="200" y="40" width="120" height="340" fill="#F0F8FF" stroke="#333" stroke-width="1.5" />
+    <!-- Dead-volume band (y + height updated dynamically below outflowLevel) -->
+    <rect id="ps-deadvol" x="201" width="118" fill="#AACCE0" />
+    <!-- basinVolume — pinned above the rim -->
+    <text id="ps-label-basinVolume" x="330" y="19" fill="#333" font-weight="600">basin volume</text>
+    <foreignObject id="ps-fo-basinVolume" x="425" y="4" width="70" height="22">
+      <input xmlns="http://www.w3.org/1999/xhtml" type="number" id="node-input-basinVolume" min="0" step="0.1" />
+    </foreignObject>
+    <text id="ps-unit-basinVolume" x="500" y="19" fill="#555">m³</text>
+
+    <!-- Zone labels (mid-tank italic, positioned dynamically at midpoint between adjacent thresholds) -->
+    <text id="ps-zone-spare"   x="260" text-anchor="middle" fill="#B78200" font-size="10" font-style="italic" visibility="hidden">Spare volume before spilling</text>
+    <text id="ps-zone-sewage"  x="260" text-anchor="middle" fill="#1F4E79" font-size="10" font-style="italic" visibility="hidden">Sewage + tank buffer</text>
+    <text id="ps-zone-buffer1" x="260" text-anchor="middle" fill="#1F4E79" font-size="10" font-style="italic" visibility="hidden">Tank buffer</text>
+    <text id="ps-zone-buffer2" x="260" text-anchor="middle" fill="#1F4E79" font-size="10" font-style="italic" visibility="hidden">Tank buffer</text>
+    <text id="ps-zone-dead"    x="260" text-anchor="middle" fill="#444" font-size="10" font-style="italic" visibility="hidden">Dead volume</text>
+
+
+    <!-- basinHeight — always at tank rim (y=40 in viewBox coords) -->
+    <line id="ps-line-basinHeight" x1="195" y1="40" x2="325" y2="40" stroke="#333" stroke-width="1.5" />
+    <text id="ps-label-basinHeight" x="330" y="44" fill="#333">basinHeight</text>
+    <foreignObject id="ps-fo-basinHeight" x="425" y="29" width="70" height="22">
+      <input xmlns="http://www.w3.org/1999/xhtml" type="number" id="node-input-basinHeight" min="0" step="0.1" />
+    </foreignObject>
+    <text id="ps-unit-basinHeight" x="500" y="44" fill="#555">m</text>
+
+    <!-- overflowLevel -->
+    <line id="ps-line-overflowLevel" x1="195" x2="325" stroke="#C0392B" stroke-dasharray="4 2" stroke-width="1.5" />
+    <text id="ps-label-overflowLevel" x="330" fill="#C0392B">overflowLevel</text>
+    <foreignObject id="ps-fo-overflowLevel" x="425" width="70" height="22">
+      <input xmlns="http://www.w3.org/1999/xhtml" type="number" id="node-input-overflowLevel" min="0" step="0.01" />
+    </foreignObject>
+    <text id="ps-unit-overflowLevel" x="500" fill="#555">m</text>
+
+    <!-- maxLevel -->
+    <line id="ps-line-maxLevel" x1="195" x2="325" stroke="#D68910" stroke-dasharray="4 2" stroke-width="1.5" />
+    <text id="ps-label-maxLevel" x="330" fill="#D68910">maxLevel</text>
+    <foreignObject id="ps-fo-maxLevel" x="425" width="70" height="22">
+      <input xmlns="http://www.w3.org/1999/xhtml" type="number" id="node-input-maxLevel" min="0" step="0.01" />
+    </foreignObject>
+    <text id="ps-unit-maxLevel" x="500" fill="#555">m</text>
+
+    <!-- startLevel -->
+    <line id="ps-line-startLevel" x1="195" x2="325" stroke="#1E8449" stroke-dasharray="4 2" stroke-width="1.5" />
+    <text id="ps-label-startLevel" x="330" fill="#1E8449">startLevel</text>
+    <foreignObject id="ps-fo-startLevel" x="425" width="70" height="22">
+      <input xmlns="http://www.w3.org/1999/xhtml" type="number" id="node-input-startLevel" min="0" step="0.01" />
+    </foreignObject>
+    <text id="ps-unit-startLevel" x="500" fill="#555">m</text>
+
+    <!-- Inlet — arrow + input on the left -->
+    <line id="ps-line-inflowLevel" x1="140" x2="200" stroke="#1F4E79" stroke-width="2" marker-end="url(#ps-arrow)" />
+    <text id="ps-label-inflowLevel" x="135" text-anchor="end" fill="#1F4E79" font-weight="bold">Inlet</text>
+    <text id="ps-sub-inflowLevel" x="135" text-anchor="end" fill="#777" font-size="9">bottom of pipe</text>
+    <foreignObject id="ps-fo-inflowLevel" x="5" width="70" height="22">
+      <input xmlns="http://www.w3.org/1999/xhtml" type="number" id="node-input-inflowLevel" min="0" step="0.01" />
+    </foreignObject>
+    <text id="ps-unit-inflowLevel" x="80" fill="#555">m</text>
+
+    <!-- minLevel -->
+    <line id="ps-line-minLevel" x1="195" x2="325" stroke="#6C3483" stroke-dasharray="4 2" stroke-width="1.5" />
+    <text id="ps-label-minLevel" x="330" fill="#6C3483">minLevel</text>
+    <foreignObject id="ps-fo-minLevel" x="425" width="70" height="22">
+      <input xmlns="http://www.w3.org/1999/xhtml" type="number" id="node-input-minLevel" min="0" step="0.01" />
+    </foreignObject>
+    <text id="ps-unit-minLevel" x="500" fill="#555">m</text>
+
+    <!-- dryRunLevel (derived, read-only) -->
+    <line id="ps-line-dryRunLevel" x1="195" x2="325" stroke="#C0392B" stroke-dasharray="1 2" stroke-width="1" opacity="0.6" />
+    <text id="ps-label-dryRunLevel" x="330" fill="#C0392B" font-size="10" font-style="italic">dryRunLevel ≈ — m (safety — from %)</text>
+
+    <!-- Outlet — arrow on right, input below the threshold column -->
+    <line id="ps-line-outflowLevel" x1="320" x2="360" stroke="#1F4E79" stroke-width="2" marker-end="url(#ps-arrow)" />
+    <text id="ps-label-outflowLevel" x="365" fill="#1F4E79" font-weight="bold">Outlet</text>
+    <text id="ps-sub-outflowLevel" x="365" fill="#777" font-size="9">top of pipe</text>
+    <foreignObject id="ps-fo-outflowLevel" x="425" width="70" height="22">
+      <input xmlns="http://www.w3.org/1999/xhtml" type="number" id="node-input-outflowLevel" min="0" step="0.01" />
+    </foreignObject>
+    <text id="ps-unit-outflowLevel" x="500" fill="#555">m</text>
+
+    <!-- Floor / datum -->
+    <line x1="195" y1="380" x2="325" y2="380" stroke="#000" stroke-width="2" />
+    <text x="330" y="384" fill="#000">0 m (datum)</text>
+
+    <!-- Leader lines: shown when the input row had to be nudged off its threshold's ideal y -->
+    <line id="ps-leader-basinHeight"   x1="0" y1="0" x2="0" y2="0" stroke="#bbb" stroke-width="0.6" stroke-dasharray="2 2" visibility="hidden" />
+    <line id="ps-leader-overflowLevel" x1="0" y1="0" x2="0" y2="0" stroke="#bbb" stroke-width="0.6" stroke-dasharray="2 2" visibility="hidden" />
+    <line id="ps-leader-maxLevel"      x1="0" y1="0" x2="0" y2="0" stroke="#bbb" stroke-width="0.6" stroke-dasharray="2 2" visibility="hidden" />
+    <line id="ps-leader-startLevel"    x1="0" y1="0" x2="0" y2="0" stroke="#bbb" stroke-width="0.6" stroke-dasharray="2 2" visibility="hidden" />
+    <line id="ps-leader-minLevel"      x1="0" y1="0" x2="0" y2="0" stroke="#bbb" stroke-width="0.6" stroke-dasharray="2 2" visibility="hidden" />
+    <line id="ps-leader-dryRunLevel"   x1="0" y1="0" x2="0" y2="0" stroke="#bbb" stroke-width="0.6" stroke-dasharray="2 2" visibility="hidden" />
+    <line id="ps-leader-outflowLevel"  x1="0" y1="0" x2="0" y2="0" stroke="#bbb" stroke-width="0.6" stroke-dasharray="2 2" visibility="hidden" />
+
+    <!-- Ordering-warning ribbon -->
+    <text id="ps-warning" x="260" y="410" text-anchor="middle" fill="#C0392B" font-size="10" font-style="italic" visibility="hidden"></text>
+  </svg>

  <hr>

@@ -288,18 +526,7 @@
  </div>

  <div id="ps-mode-levelbased" class="ps-mode-section">
-    <div class="form-row">
-      <label for="node-input-minLevel">minLevel (m)</label>
-      <input type="number" id="node-input-minLevel" placeholder="m" />
-    </div>
-    <div class="form-row">
-      <label for="node-input-startLevel">startLevel (m)</label>
-      <input type="number" id="node-input-startLevel" placeholder="m" />
-    </div>
-    <div class="form-row">
-      <label for="node-input-maxLevel">maxLevel (m)</label>
-      <input type="number" id="node-input-maxLevel" placeholder="m" />
-    </div>
+    <p style="font-size:12px;color:#777;margin:0;">Level-based uses <code>minLevel</code> / <code>startLevel</code> / <code>maxLevel</code> from the diagram above.</p>
  </div>

  <div id="ps-mode-flowbased" class="ps-mode-section" style="display:none">
--- a/wiki/README.md
+++ b/wiki/README.md
@@ -9,9 +9,9 @@ All docs and diagrams for this node live in this folder so they version-lock wit

 ## Diagrams

-Editable draw.io sources live in [`diagrams/`](diagrams/). See [`diagrams/README.md`](diagrams/README.md) for the editing workflow — open `.drawio` files in [draw.io](https://app.diagrams.net/), export to `.drawio.svg`, commit both.
+Editable draw.io SVGs live in [`diagrams/`](diagrams/). See [`diagrams/README.md`](diagrams/README.md) for the editing workflow — open the `.drawio.svg` in [draw.io](https://app.diagrams.net/), edit it, then export back to SVG with the source embedded.

-The basin model is the shared canvas ([`diagrams/basin-model.drawio.svg`](diagrams/basin-model.drawio.svg)); per-mode transfer-function diagrams live under [`diagrams/modes/`](diagrams/modes/).
+The basin model is the shared physical canvas ([`diagrams/basin-model.drawio.svg`](diagrams/basin-model.drawio.svg)); per-mode transfer-function diagrams live under [`diagrams/modes/`](diagrams/modes/). Mode-specific thresholds such as `startLevel` belong in those mode diagrams, not in the generic basin model.

 ## Part of

--- a/wiki/diagrams/README.md
+++ b/wiki/diagrams/README.md
@@ -1,15 +1,15 @@
 # Diagrams

-Editable source diagrams for the pumpingStation wiki. Each diagram is a **`.drawio` + `.drawio.svg` pair**, so anyone can edit the source in [draw.io](https://app.diagrams.net/) without touching any Markdown.
+Editable source diagrams for the pumpingStation wiki. The current diagrams are **`.drawio.svg` files with the draw.io source embedded**, so anyone can edit the SVG directly in [draw.io](https://app.diagrams.net/) without touching any Markdown.

-## Why two files?
+## File roles

 | File | Role |
 |---|---|
-| `<name>.drawio` | Native draw.io XML. The canonical source. |
+| `<name>.drawio` | Optional native draw.io XML source, if a diagram also keeps a standalone source file. |
 | `<name>.drawio.svg` | SVG export of the same diagram (with source embedded). What the wiki actually renders, and what round-trips back into draw.io. |

-Checking both in means the wiki renders for everyone, and the next editor picks up from exactly where the last one left off.
+An optional standalone `.drawio` file can be committed beside the SVG, but the embedded-source SVG is enough for the wiki to render and for the next editor to pick up from exactly where the last one left off.

 ## Editing workflow

@@ -18,7 +18,7 @@ Checking both in means the wiki renders for everyone, and the next editor picks
   git clone https://gitea.wbd-rd.nl/RnD/pumpingStation.git
   cd pumpingStation/wiki/diagrams
   ```
-2. **Open** the `.drawio` file in draw.io:
+2. **Open** the `.drawio.svg` file in draw.io:
   - Web: [app.diagrams.net](https://app.diagrams.net/) → *Open Existing Diagram*, or drag-and-drop.
   - Desktop: [drawio-desktop](https://github.com/jgraph/drawio-desktop/releases).
 3. **Edit** — move shapes, change labels, adjust layout.
@@ -26,9 +26,9 @@ Checking both in means the wiki renders for everyone, and the next editor picks
   - `File → Export as → SVG…`
   - Check **Include a copy of my diagram** ← this is what lets future edits round-trip through the SVG.
   - Save next to the source as `<name>.drawio.svg` (overwrite).
-5. **Commit & push** both files:
+5. **Commit & push** the edited SVG, plus the `.drawio` file if one exists:
   ```bash
-   git add wiki/diagrams/<name>.drawio wiki/diagrams/<name>.drawio.svg
+   git add wiki/diagrams/<name>.drawio.svg
   git commit -m "Update <name>: <what changed>"
   git push
   ```
@@ -50,22 +50,22 @@ Use a descriptive `alt` text; it's the fallback if the SVG fails and it shows up

 | Diagram | Shows |
 |---|---|
-| `basin-model` | Physical basin cross-section — walls, pipes at their real heights, control thresholds cutting across, zone labels |
-| `control-zones` | Vertical level axis ("thermometer") for `levelbased` mode — STOP / DEAD ZONE / RUN with demand ramp |
+| `basin-model` | Shared physical basin cross-section — walls, pipe reference heights, derived safety zones, storage/dead volumes |
+| `modes/basin-mode-level-linear` | Level-linear control mode — `startLevel`, demand ramp, threshold-shift behaviour |
+| `control-zones` | Legacy vertical level axis ("thermometer") for `levelbased` mode — STOP / DEAD ZONE / RUN with demand ramp |
 | `safety-rules` | Dry-run vs overfill rule asymmetry — which children stop, which keep running |

 ## Making a brand-new diagram

 1. Open draw.io, start blank.
 2. Draw it.
-3. `File → Save As…` → `wiki/diagrams/<name>.drawio`.
-4. `File → Export as → SVG…` with **Include a copy of my diagram** checked → save as `wiki/diagrams/<name>.drawio.svg`.
-5. Reference from the wiki page with `![alt](diagrams/<name>.drawio.svg)`.
-6. Add an entry to the table above.
-7. Commit all three files together (`.drawio`, `.drawio.svg`, updated `.md`).
+3. `File → Export as → SVG…` with **Include a copy of my diagram** checked → save as `wiki/diagrams/<name>.drawio.svg`.
+4. Reference from the wiki page with `![alt](diagrams/<name>.drawio.svg)`.
+5. Add an entry to the table above.
+6. Commit the new `.drawio.svg` and updated `.md` together.

 ## These starters are rough

-The `.drawio` files and their matching `.drawio.svg` exports committed here are **placeholders** — layout is approximate, colors and fonts are defaults, no fine alignment. They're meant to be a starting point; open them in draw.io and refine.
+Some diagrams are still rough — layout is approximate, colors and fonts may be defaults, and alignment may need refinement. They're meant to be improved in draw.io as the model settles.

-Both formats are round-trippable: open either the `.drawio` or the `.drawio.svg` in draw.io and it will load the editable model. (The SVG has the drawio XML embedded in a `content="…"` attribute on the root `<svg>` element — that's what lets draw.io re-open its own SVG exports.)
+Open the `.drawio.svg` in draw.io and it will load the editable model. The SVG has the draw.io XML embedded in a `content="…"` attribute on the root `<svg>` element — that's what lets draw.io re-open its own SVG exports.
--- a/wiki/diagrams/basin-model.drawio
+++ b/wiki/diagrams/basin-model.drawio
@@ -1,109 +0,0 @@
-<mxfile host="app.diagrams.net" modified="2026-04-22T12:00:00.000Z" agent="Claude Code placeholder" etag="initial" version="22.0.0" type="device">
-  <diagram name="basin-model" id="basinModel">
-    <mxGraphModel dx="1200" dy="900" grid="1" gridSize="10" guides="1" tooltips="1" connect="1" arrows="1" fold="1" page="1" pageScale="1" pageWidth="850" pageHeight="900" math="0" shadow="0">
-      <root>
-        <mxCell id="0" />
-        <mxCell id="1" parent="0" />
-        <mxCell id="title" value="Basin model — physical layout + control thresholds" style="text;html=1;fontSize=16;fontStyle=1;align=center;" vertex="1" parent="1">
-          <mxGeometry x="200" y="20" width="500" height="30" as="geometry" />
-        </mxCell>
-        <mxCell id="tank" value="" style="rounded=0;whiteSpace=wrap;html=1;fillColor=#E6F2FF;strokeColor=#000000;strokeWidth=2;" vertex="1" parent="1">
-          <mxGeometry x="300" y="80" width="260" height="520" as="geometry" />
-        </mxCell>
-        <mxCell id="deadvol" value="" style="rounded=0;whiteSpace=wrap;html=1;fillColor=#9FC5E8;strokeColor=none;" vertex="1" parent="1">
-          <mxGeometry x="302" y="550" width="256" height="48" as="geometry" />
-        </mxCell>
-        <mxCell id="freeboard_label" value="freeboard" style="text;html=1;fontSize=11;fontStyle=2;align=center;" vertex="1" parent="1">
-          <mxGeometry x="310" y="90" width="240" height="20" as="geometry" />
-        </mxCell>
-        <mxCell id="overflow_line" value="" style="endArrow=none;html=1;strokeColor=#B22222;dashed=1;strokeWidth=2;" edge="1" parent="1">
-          <mxGeometry relative="1" as="geometry">
-            <mxPoint x="250" y="145" as="sourcePoint" />
-            <mxPoint x="620" y="145" as="targetPoint" />
-          </mxGeometry>
-        </mxCell>
-        <mxCell id="overflow_label_l" value="heightOverflow" style="text;html=1;fontSize=12;align=right;fontColor=#B22222;" vertex="1" parent="1">
-          <mxGeometry x="140" y="130" width="100" height="20" as="geometry" />
-        </mxCell>
-        <mxCell id="overflow_label_r" value="spill → measure" style="text;html=1;fontSize=12;align=left;fontColor=#B22222;" vertex="1" parent="1">
-          <mxGeometry x="630" y="130" width="140" height="20" as="geometry" />
-        </mxCell>
-        <mxCell id="maxflow_line" value="" style="endArrow=none;html=1;strokeColor=#D68910;dashed=1;strokeWidth=2;" edge="1" parent="1">
-          <mxGeometry relative="1" as="geometry">
-            <mxPoint x="250" y="200" as="sourcePoint" />
-            <mxPoint x="620" y="200" as="targetPoint" />
-          </mxGeometry>
-        </mxCell>
-        <mxCell id="maxflow_label_l" value="maxFlowLevel" style="text;html=1;fontSize=12;align=right;fontColor=#D68910;" vertex="1" parent="1">
-          <mxGeometry x="140" y="185" width="100" height="20" as="geometry" />
-        </mxCell>
-        <mxCell id="scaling_label" value="SCALING RANGE&#10;(levelbased: demand ramps 0→100%)" style="text;html=1;fontSize=11;fontStyle=2;align=center;" vertex="1" parent="1">
-          <mxGeometry x="310" y="255" width="240" height="40" as="geometry" />
-        </mxCell>
-        <mxCell id="startlevel_line" value="" style="endArrow=none;html=1;strokeColor=#1E8449;dashed=1;strokeWidth=2;" edge="1" parent="1">
-          <mxGeometry relative="1" as="geometry">
-            <mxPoint x="250" y="345" as="sourcePoint" />
-            <mxPoint x="620" y="345" as="targetPoint" />
-          </mxGeometry>
-        </mxCell>
-        <mxCell id="startlevel_label_l" value="startLevel" style="text;html=1;fontSize=12;align=right;fontColor=#1E8449;" vertex="1" parent="1">
-          <mxGeometry x="140" y="330" width="100" height="20" as="geometry" />
-        </mxCell>
-        <mxCell id="deadzone_label" value="DEAD ZONE&#10;(hysteresis — keep last cmd)" style="text;html=1;fontSize=11;fontStyle=2;align=center;" vertex="1" parent="1">
-          <mxGeometry x="310" y="360" width="240" height="40" as="geometry" />
-        </mxCell>
-        <mxCell id="inflow_arrow" value="" style="endArrow=classic;html=1;strokeColor=#1F4E79;strokeWidth=3;" edge="1" parent="1">
-          <mxGeometry relative="1" as="geometry">
-            <mxPoint x="150" y="410" as="sourcePoint" />
-            <mxPoint x="300" y="410" as="targetPoint" />
-          </mxGeometry>
-        </mxCell>
-        <mxCell id="inflow_label" value="INFLOW" style="text;html=1;fontSize=13;fontStyle=1;align=left;fontColor=#1F4E79;" vertex="1" parent="1">
-          <mxGeometry x="90" y="395" width="70" height="20" as="geometry" />
-        </mxCell>
-        <mxCell id="inlet_label" value="heightInlet" style="text;html=1;fontSize=12;align=left;fontColor=#1F4E79;" vertex="1" parent="1">
-          <mxGeometry x="570" y="400" width="90" height="20" as="geometry" />
-        </mxCell>
-        <mxCell id="stoplevel_line" value="" style="endArrow=none;html=1;strokeColor=#6C3483;dashed=1;strokeWidth=2;" edge="1" parent="1">
-          <mxGeometry relative="1" as="geometry">
-            <mxPoint x="250" y="465" as="sourcePoint" />
-            <mxPoint x="620" y="465" as="targetPoint" />
-          </mxGeometry>
-        </mxCell>
-        <mxCell id="stoplevel_label_l" value="stopLevel" style="text;html=1;fontSize=12;align=right;fontColor=#6C3483;" vertex="1" parent="1">
-          <mxGeometry x="140" y="450" width="100" height="20" as="geometry" />
-        </mxCell>
-        <mxCell id="stoplevel_label_r" value="unconditional STOP" style="text;html=1;fontSize=12;align=left;fontColor=#6C3483;" vertex="1" parent="1">
-          <mxGeometry x="630" y="450" width="160" height="20" as="geometry" />
-        </mxCell>
-        <mxCell id="buffer_label" value="BUFFER" style="text;html=1;fontSize=11;fontStyle=2;align=center;" vertex="1" parent="1">
-          <mxGeometry x="310" y="490" width="240" height="20" as="geometry" />
-        </mxCell>
-        <mxCell id="outflow_arrow" value="" style="endArrow=classic;html=1;strokeColor=#1F4E79;strokeWidth=3;" edge="1" parent="1">
-          <mxGeometry relative="1" as="geometry">
-            <mxPoint x="560" y="540" as="sourcePoint" />
-            <mxPoint x="720" y="540" as="targetPoint" />
-          </mxGeometry>
-        </mxCell>
-        <mxCell id="outflow_label" value="OUTFLOW" style="text;html=1;fontSize=13;fontStyle=1;align=left;fontColor=#1F4E79;" vertex="1" parent="1">
-          <mxGeometry x="730" y="525" width="80" height="20" as="geometry" />
-        </mxCell>
-        <mxCell id="outlet_label_l" value="heightOutlet" style="text;html=1;fontSize=12;align=right;fontColor=#B22222;" vertex="1" parent="1">
-          <mxGeometry x="140" y="525" width="100" height="20" as="geometry" />
-        </mxCell>
-        <mxCell id="outlet_label_r" value="dry-run trip" style="text;html=1;fontSize=12;align=left;fontColor=#B22222;" vertex="1" parent="1">
-          <mxGeometry x="730" y="550" width="120" height="20" as="geometry" />
-        </mxCell>
-        <mxCell id="deadvol_label" value="dead volume" style="text;html=1;fontSize=11;fontStyle=2;align=center;" vertex="1" parent="1">
-          <mxGeometry x="310" y="560" width="240" height="20" as="geometry" />
-        </mxCell>
-        <mxCell id="floor_label" value="floor (0)" style="text;html=1;fontSize=11;align=right;" vertex="1" parent="1">
-          <mxGeometry x="190" y="590" width="50" height="20" as="geometry" />
-        </mxCell>
-        <mxCell id="basin_label" value="heightBasin" style="text;html=1;fontSize=11;align=right;" vertex="1" parent="1">
-          <mxGeometry x="180" y="70" width="60" height="20" as="geometry" />
-        </mxCell>
-      </root>
-    </mxGraphModel>
-  </diagram>
-</mxfile>
--- a/wiki/diagrams/basin-model.drawio.svg
+++ b/wiki/diagrams/basin-model.drawio.svg
--- a/wiki/diagrams/control-zones.drawio
+++ b/wiki/diagrams/control-zones.drawio
@@ -1,102 +0,0 @@
-<mxfile host="app.diagrams.net" modified="2026-04-22T12:00:00.000Z" agent="Claude Code placeholder" etag="initial" version="22.0.0" type="device">
-  <diagram name="control-zones" id="controlZones">
-    <mxGraphModel dx="1000" dy="800" grid="1" gridSize="10" guides="1" tooltips="1" connect="1" arrows="1" fold="1" page="1" pageScale="1" pageWidth="700" pageHeight="800" math="0" shadow="0">
-      <root>
-        <mxCell id="0" />
-        <mxCell id="1" parent="0" />
-        <mxCell id="title" value="levelbased mode — three zones" style="text;html=1;fontSize=16;fontStyle=1;align=center;" vertex="1" parent="1">
-          <mxGeometry x="100" y="20" width="500" height="30" as="geometry" />
-        </mxCell>
-        <mxCell id="axis" value="" style="endArrow=classic;html=1;strokeColor=#000;strokeWidth=2;" edge="1" parent="1">
-          <mxGeometry relative="1" as="geometry">
-            <mxPoint x="280" y="600" as="sourcePoint" />
-            <mxPoint x="280" y="80" as="targetPoint" />
-          </mxGeometry>
-        </mxCell>
-        <mxCell id="axis_label" value="level" style="text;html=1;fontSize=13;fontStyle=1;align=left;" vertex="1" parent="1">
-          <mxGeometry x="240" y="60" width="50" height="20" as="geometry" />
-        </mxCell>
-
-        <mxCell id="overflow" value="heightOverflow — weir crest (spill → measure)" style="text;html=1;fontSize=12;align=left;fontColor=#B22222;" vertex="1" parent="1">
-          <mxGeometry x="300" y="130" width="380" height="20" as="geometry" />
-        </mxCell>
-        <mxCell id="overflow_tick" value="" style="endArrow=none;html=1;strokeColor=#B22222;" edge="1" parent="1">
-          <mxGeometry relative="1" as="geometry">
-            <mxPoint x="270" y="140" as="sourcePoint" />
-            <mxPoint x="290" y="140" as="targetPoint" />
-          </mxGeometry>
-        </mxCell>
-
-        <mxCell id="run_band" value="RUN  — linear 0 → 100 %" style="rounded=0;whiteSpace=wrap;html=1;fillColor=#E8F5E9;strokeColor=#1E8449;fontSize=12;" vertex="1" parent="1">
-          <mxGeometry x="300" y="160" width="220" height="110" as="geometry" />
-        </mxCell>
-
-        <mxCell id="maxflow" value="maxFlowLevel — 100 % demand" style="text;html=1;fontSize=12;align=left;fontColor=#D68910;fontStyle=1;" vertex="1" parent="1">
-          <mxGeometry x="300" y="265" width="300" height="20" as="geometry" />
-        </mxCell>
-        <mxCell id="maxflow_tick" value="" style="endArrow=none;html=1;strokeColor=#D68910;strokeWidth=2;" edge="1" parent="1">
-          <mxGeometry relative="1" as="geometry">
-            <mxPoint x="265" y="275" as="sourcePoint" />
-            <mxPoint x="295" y="275" as="targetPoint" />
-          </mxGeometry>
-        </mxCell>
-
-        <mxCell id="ramp_label" value="(ramp — demand scales linearly with level)" style="text;html=1;fontSize=11;align=left;fontStyle=2;" vertex="1" parent="1">
-          <mxGeometry x="300" y="300" width="320" height="20" as="geometry" />
-        </mxCell>
-
-        <mxCell id="startlevel" value="startLevel — 0 % demand (ramp starts)" style="text;html=1;fontSize=12;align=left;fontColor=#1E8449;fontStyle=1;" vertex="1" parent="1">
-          <mxGeometry x="300" y="335" width="340" height="20" as="geometry" />
-        </mxCell>
-        <mxCell id="start_tick" value="" style="endArrow=none;html=1;strokeColor=#1E8449;strokeWidth=2;" edge="1" parent="1">
-          <mxGeometry relative="1" as="geometry">
-            <mxPoint x="265" y="345" as="sourcePoint" />
-            <mxPoint x="295" y="345" as="targetPoint" />
-          </mxGeometry>
-        </mxCell>
-
-        <mxCell id="dead_band" value="DEAD ZONE — hysteresis, keep last cmd" style="rounded=0;whiteSpace=wrap;html=1;fillColor=#FFF8E1;strokeColor=#F57C00;fontSize=12;" vertex="1" parent="1">
-          <mxGeometry x="300" y="360" width="220" height="80" as="geometry" />
-        </mxCell>
-
-        <mxCell id="inlet" value="heightInlet — inflow pipe" style="text;html=1;fontSize=12;align=left;fontColor=#1F4E79;" vertex="1" parent="1">
-          <mxGeometry x="300" y="395" width="300" height="20" as="geometry" />
-        </mxCell>
-        <mxCell id="inlet_tick" value="" style="endArrow=none;html=1;strokeColor=#1F4E79;" edge="1" parent="1">
-          <mxGeometry relative="1" as="geometry">
-            <mxPoint x="270" y="405" as="sourcePoint" />
-            <mxPoint x="290" y="405" as="targetPoint" />
-          </mxGeometry>
-        </mxCell>
-
-        <mxCell id="stoplevel" value="stopLevel — unconditional STOP" style="text;html=1;fontSize=12;align=left;fontColor=#6C3483;fontStyle=1;" vertex="1" parent="1">
-          <mxGeometry x="300" y="440" width="300" height="20" as="geometry" />
-        </mxCell>
-        <mxCell id="stop_tick" value="" style="endArrow=none;html=1;strokeColor=#6C3483;strokeWidth=2;" edge="1" parent="1">
-          <mxGeometry relative="1" as="geometry">
-            <mxPoint x="265" y="450" as="sourcePoint" />
-            <mxPoint x="295" y="450" as="targetPoint" />
-          </mxGeometry>
-        </mxCell>
-
-        <mxCell id="stop_band" value="pumps OFF (MGC shutdown)" style="rounded=0;whiteSpace=wrap;html=1;fillColor=#F4ECF7;strokeColor=#6C3483;fontSize=12;" vertex="1" parent="1">
-          <mxGeometry x="300" y="465" width="220" height="80" as="geometry" />
-        </mxCell>
-
-        <mxCell id="outlet" value="heightOutlet — outflow pipe (dry-run trip here)" style="text;html=1;fontSize=12;align=left;fontColor=#B22222;" vertex="1" parent="1">
-          <mxGeometry x="300" y="510" width="360" height="20" as="geometry" />
-        </mxCell>
-        <mxCell id="outlet_tick" value="" style="endArrow=none;html=1;strokeColor=#B22222;" edge="1" parent="1">
-          <mxGeometry relative="1" as="geometry">
-            <mxPoint x="270" y="520" as="sourcePoint" />
-            <mxPoint x="290" y="520" as="targetPoint" />
-          </mxGeometry>
-        </mxCell>
-
-        <mxCell id="floor" value="0 (floor)" style="text;html=1;fontSize=11;align=left;" vertex="1" parent="1">
-          <mxGeometry x="300" y="580" width="60" height="20" as="geometry" />
-        </mxCell>
-      </root>
-    </mxGraphModel>
-  </diagram>
-</mxfile>
--- a/wiki/diagrams/modes/basin-mode-level-linear.drawio.svg
+++ b/wiki/diagrams/modes/basin-mode-level-linear.drawio.svg
--- a/wiki/diagrams/modes/levelbased.drawio.svg
+++ b/wiki/diagrams/modes/levelbased.drawio.svg
--- a/wiki/diagrams/safety-rules.drawio
+++ b/wiki/diagrams/safety-rules.drawio
@@ -1,58 +0,0 @@
-<mxfile host="app.diagrams.net" modified="2026-04-22T12:00:00.000Z" agent="Claude Code placeholder" etag="initial" version="22.0.0" type="device">
-  <diagram name="safety-rules" id="safetyRules">
-    <mxGraphModel dx="1200" dy="700" grid="1" gridSize="10" guides="1" tooltips="1" connect="1" arrows="1" fold="1" page="1" pageScale="1" pageWidth="900" pageHeight="700" math="0" shadow="0">
-      <root>
-        <mxCell id="0" />
-        <mxCell id="1" parent="0" />
-        <mxCell id="title" value="Safety rules — asymmetric by direction" style="text;html=1;fontSize=16;fontStyle=1;align=center;" vertex="1" parent="1">
-          <mxGeometry x="150" y="20" width="600" height="30" as="geometry" />
-        </mxCell>
-
-        <mxCell id="dryrun_box" value="DRY-RUN&#10;(direction = draining)" style="rounded=0;whiteSpace=wrap;html=1;fillColor=#FFF3E0;strokeColor=#E65100;strokeWidth=2;fontSize=14;fontStyle=1;verticalAlign=top;" vertex="1" parent="1">
-          <mxGeometry x="80" y="80" width="340" height="340" as="geometry" />
-        </mxCell>
-        <mxCell id="dr_upstream" value="upstream children  —  KEEP" style="text;html=1;fontSize=13;align=left;" vertex="1" parent="1">
-          <mxGeometry x="100" y="140" width="300" height="24" as="geometry" />
-        </mxCell>
-        <mxCell id="dr_downstream" value="downstream children  —  STOP" style="text;html=1;fontSize=13;align=left;fontStyle=1;fontColor=#E65100;" vertex="1" parent="1">
-          <mxGeometry x="100" y="170" width="300" height="24" as="geometry" />
-        </mxCell>
-        <mxCell id="dr_machinegroups" value="machineGroups  —  STOP" style="text;html=1;fontSize=13;align=left;fontStyle=1;fontColor=#E65100;" vertex="1" parent="1">
-          <mxGeometry x="100" y="200" width="300" height="24" as="geometry" />
-        </mxCell>
-        <mxCell id="dr_control" value="control loop  —  BLOCKED" style="text;html=1;fontSize=13;align=left;fontStyle=1;fontColor=#E65100;" vertex="1" parent="1">
-          <mxGeometry x="100" y="230" width="300" height="24" as="geometry" />
-        </mxCell>
-        <mxCell id="dr_note" value="safetyControllerActive = true&#10;&#10;Pumps must stop before sucking air." style="text;html=1;fontSize=12;align=left;fontStyle=2;" vertex="1" parent="1">
-          <mxGeometry x="100" y="290" width="300" height="80" as="geometry" />
-        </mxCell>
-
-        <mxCell id="overfill_box" value="OVERFILL&#10;(direction = filling)" style="rounded=0;whiteSpace=wrap;html=1;fillColor=#FFEBEE;strokeColor=#C62828;strokeWidth=2;fontSize=14;fontStyle=1;verticalAlign=top;" vertex="1" parent="1">
-          <mxGeometry x="480" y="80" width="340" height="340" as="geometry" />
-        </mxCell>
-        <mxCell id="of_upstream" value="upstream children  —  STOP  ⚠" style="text;html=1;fontSize=13;align=left;fontStyle=1;fontColor=#C62828;" vertex="1" parent="1">
-          <mxGeometry x="500" y="140" width="300" height="24" as="geometry" />
-        </mxCell>
-        <mxCell id="of_downstream" value="downstream children  —  KEEP" style="text;html=1;fontSize=13;align=left;" vertex="1" parent="1">
-          <mxGeometry x="500" y="170" width="300" height="24" as="geometry" />
-        </mxCell>
-        <mxCell id="of_machinegroups" value="machineGroups  —  KEEP" style="text;html=1;fontSize=13;align=left;" vertex="1" parent="1">
-          <mxGeometry x="500" y="200" width="300" height="24" as="geometry" />
-        </mxCell>
-        <mxCell id="of_control" value="control loop  —  ACTIVE" style="text;html=1;fontSize=13;align=left;" vertex="1" parent="1">
-          <mxGeometry x="500" y="230" width="300" height="24" as="geometry" />
-        </mxCell>
-        <mxCell id="of_note" value="Level control keeps commanding downstream MGC.&#10;&#10;⚠ &quot;upstream STOP&quot; is only correct in a cascaded layout. In a gravity-sewer station the inflow can&apos;t be stopped — log the spill instead." style="text;html=1;fontSize=12;align=left;fontStyle=2;" vertex="1" parent="1">
-          <mxGeometry x="500" y="290" width="300" height="120" as="geometry" />
-        </mxCell>
-
-        <mxCell id="trigger_title" value="Triggers (either condition fires the rule):" style="text;html=1;fontSize=13;fontStyle=1;align=left;" vertex="1" parent="1">
-          <mxGeometry x="80" y="450" width="740" height="20" as="geometry" />
-        </mxCell>
-        <mxCell id="trigger_list" value="• vol &lt; triggerLowVol     (triggerLowVol  = minVol × (1 + pct/100))&#10;• vol &gt; triggerHighVol    (triggerHighVol = maxVolOverflow × pct/100)&#10;• remainingTime &lt; timeleftToFullOrEmptyThresholdSeconds (if enabled)" style="text;html=1;fontSize=12;align=left;" vertex="1" parent="1">
-          <mxGeometry x="80" y="480" width="740" height="80" as="geometry" />
-        </mxCell>
-      </root>
-    </mxGraphModel>
-  </diagram>
-</mxfile>
--- a/wiki/functional-description.md
+++ b/wiki/functional-description.md
@@ -41,14 +41,18 @@ Every field on the pumpingStation editor maps directly to the config schema in `

 | Field | Default | Meaning |
 |---|---|---|
-| **Basin Volume (m³)** | `1` | Total geometric volume of the empty basin (floor to rim). |
+| **Basin Volume (m³)** | `1` | Total geometric storage volume from basin floor to rim. |
 | **Basin Height (m)** | `1` | Physical wall height from floor to rim. |
-| **Inlet Elevation (m)** | `2` | Centre of the inlet pipe, measured from the floor. |
-| **Outlet Elevation (m)** | `0.2` | Centre of the pump-suction pipe, measured from the floor. |
-| **Overflow Level (m)** | `2.5` | Overflow-weir crest, measured from the floor. Above this → overfill safety. |
+| **Inlet Elevation (m)** | `2` | Bottom/invert of the incoming sewer pipe, measured from the basin floor. This is the level where backing up into the inlet starts to matter hydraulically. |
+| **Outlet Elevation (m)** | `0.2` | Top of the pump-suction/outlet pipe, measured from the basin floor. This is the practical lower hydraulic reference for pump protection. |
+| **Inlet Pipe Diameter (m)** | `0.4` | Nominal incoming sewer pipe diameter. Used with `inflowLevel` to distinguish pipe bottom, centre, and crown in future hydraulic upgrades. |
+| **Outlet Pipe Diameter (m)** | `0.4` | Nominal pump-suction/outlet pipe diameter. Used with `outflowLevel` to distinguish pipe top, centre, and invert in future hydraulic upgrades. |
+| **Overflow Level (m)** | `2.5` | Physical overflow-weir crest, measured from the floor. At or above this level the basin is actually spilling. |

 Constant cross-section is assumed: `surfaceArea = volume / height`. All derived volumes (`minVolAtOutflow`, `minVolAtInflow`, `maxVolAtOverflow`, `maxVol`) are computed once in `initBasinProperties()` and kept on `station.basin`.

+The current runtime still uses the level fields directly for its volume math. Pipe diameters are part of the basin model contract so later hydraulic logic can reason about pipe invert/crown and not silently treat every pipe elevation as a centreline.
+
 ### Hydraulics (section `hydraulics`)

 | Field | Default | Meaning |
@@ -63,8 +67,8 @@ Constant cross-section is assumed: `surfaceArea = volume / height`. All derived
 |---|---|---|
 | **Control mode** | `levelbased` | Active control strategy. Schema enumerates seven modes; today `levelbased` is fully implemented, `manual` forwards demand via `Qd`, others are placeholders. |
 | **minLevel (m)** | `1` | Below this level → unconditional MGC shutdown. |
-| **startLevel (m)** | `1` | Bottom of the linear scaling range (0 % demand — ramp starts here). |
-| **maxLevel (m)** | `4` | Top of the linear scaling range (100 % demand). Typically ≈ `overflowLevel`. |
+| **startLevel (m)** | `1` | Mode-specific threshold. In `levelbased`, this is the bottom of the linear scaling range (0 % demand). It is not part of the generic basin model because other modes can define a different start policy. |
+| **maxLevel (m)** | `4` | Upper normal operating/storage level used by the active mode. In `levelbased`, this is where demand reaches 100 %. |
 | **Flow setpoint** | `0` | Flow-based target (m³/h). Placeholder until `flowbased` is wired. |
 | **Deadband** | `0` | Flow-based deadband (m³/h). Placeholder. |

@@ -74,9 +78,9 @@ Constant cross-section is assumed: `surfaceArea = volume / height`. All derived
 |---|---|---|
 | **Time To Empty/Full (s)** | `0` | If > 0, triggers safety when predicted time-to-overflow or time-to-empty falls below this value. `0` disables time-based protection. |
 | **Enable Dry-Run Protection** | `true` | If on, pumps are shut down once volume drops below the dry-run threshold while draining. |
-| **Low Volume Threshold (%)** | `2` | Dry-run trigger: `triggerLowVol = minVol × (1 + pct/100)`. |
-| **Enable Overfill Protection** | `true` | If on, upstream inflows are shut down once volume climbs above the overfill threshold while filling. |
-| **High Volume Threshold (%)** | `98` | Overfill trigger: `triggerHighVol = maxVolAtOverflow × pct/100`. |
+| **Low Volume Threshold (%)** | `2` | Safety margin above the configured minimum volume: `dryRunSafetyVol = minVol × (1 + pct/100)`. This creates `dryRunLevel`; it is derived, not a separately entered basin height. |
+| **Enable Overfill Protection** | `true` | If on, upstream inflows are shut down once volume climbs above the high-volume safety point while filling. |
+| **High Volume Threshold (%)** | `98` | Safety margin below physical overflow: `highVolumeSafetyVol = maxVolAtOverflow × pct/100`. Actual overflowing is still the boolean condition `level >= overflowLevel`. |

 ### Output formats

@@ -168,15 +172,29 @@ Line-protocol payload for the `telemetry` bucket. Tags stay low-cardinality (sta

 ## Basin model

-The basin is modelled as a rectangular prism with constant cross-section. Everything derives from `volume = level × surfaceArea`.
+The basin is modelled as a rectangular prism with constant cross-section. Everything derives from `volume = level × surfaceArea`, with every level measured upward from the basin floor.

 ![Basin model — physical layout with control thresholds](diagrams/basin-model.drawio.svg)

-*Editable source: [`diagrams/basin-model.drawio`](diagrams/basin-model.drawio). See [`diagrams/README.md`](diagrams/README.md) for the edit-and-export workflow.*
+*Editable source: [`diagrams/basin-model.drawio.svg`](diagrams/basin-model.drawio.svg) (drag into draw.io; the SVG embeds the editable source). See [`diagrams/README.md`](diagrams/README.md) for the edit-and-export workflow.*

-**Typical ordering** (bottom → top): `outflowLevel ≤ minLevel < inflowLevel < startLevel < maxLevel ≤ overflowLevel`.
+**Generic basin ordering** (bottom → top): `outflowLevel ≤ dryRunLevel ≤ minLevel < inflowLevel < maxLevel ≤ highVolumeSafetyLevel < overflowLevel ≤ basinHeight`.

-> ⚠️ The comment block in `specificClass.js` currently says `startLevel ≤ inflowLevel` (inlet above startLevel). The physical convention is the opposite: pumps start *before* the water reaches the gravity inlet, so `inflowLevel < startLevel`. Worth fixing in the code comment next time that file is touched.
+`startLevel` is deliberately not part of this generic basin diagram. It belongs to a control mode. For the current level-linear mode, see [`diagrams/modes/basin-mode-level-linear.drawio.svg`](diagrams/modes/basin-mode-level-linear.drawio.svg).
+
+The pipe labels are intentional:
+
+- `inflowLevel` is the bottom/invert of the incoming sewer pipe.
+- `outflowLevel` is the top of the pump-suction/outlet pipe.
+
+This avoids hiding hydraulic consequences behind ambiguous pipe-centre elevations. Pipe diameters are part of the model contract so later versions can derive pipe centre/crown/invert where needed.
+
+`dryRunLevel` and `highVolumeSafetyLevel` are derived safety points. They provide margin before the two hard physical conditions:
+
+- Actual dry-run risk is at or below the pumpable lower hydraulic reference.
+- Actual overflowing is the boolean condition `level >= overflowLevel`.
+
+The high-volume safety point exists so the station can still react before the basin is physically spilling. Once `overflowLevel` is reached, the model should report overflowing rather than treating that point as a controllable threshold.

 **minHeightBasedOn** — which pipe defines `minVol`, the operational floor used for the initial seed, the dry-run trigger, and the 0 % point of the fill percentage:

@@ -195,6 +213,8 @@ The basin is modelled as a rectangular prism with constant cross-section. Everyt
                                      starts at the inlet.
 ```

+The rectangular approximation is acceptable for this node's first basin model because operational level is always in metres from the basin floor, while calculated m³ can tolerate small shape errors. A later upgrade can replace `volume = level × surfaceArea` with a level-volume curve for benching, sumps, sediment/dead zones, and irregular wet-well geometry.
+
 ## Net-flow selection

 Every tick, `_selectBestNetFlow()` walks a priority ladder and returns the first net flow that clears the dead-band (`|flow| ≥ flowThreshold`):
@@ -223,7 +243,9 @@ flowPositions = { inflow: ['in', 'upstream'], outflow: ['out', 'downstream'] }

 ## Control logic

-The `pumpingStation` supports multiple control modes. Each mode is a **policy that sets the three control thresholds (`minLevel`, `startLevel`, `maxLevel`) and produces a demand (0 – 100 %)** — the two safety thresholds (`dryRunLevel`, `overflowLevel`) are mode-independent and handled by the safety layer below.
+The `pumpingStation` supports multiple control modes. Each mode is a **policy that maps basin state to demand (0-100 %)**. `levelbased` uses `minLevel`, `startLevel`, and `maxLevel`; other modes may use different thresholds or compute them dynamically.
+
+The basin model owns the shared physical and safety references: pipe elevations, `dryRunLevel`, `highVolumeSafetyLevel`, and `overflowLevel`. `startLevel` is mode-specific and is documented with the mode diagrams, not the generic basin drawing.

 Every mode gets its own page under [`modes/`](modes/README.md) with a consistent layout (inputs, threshold policy, demand formula, edge cases) so they can be compared side-by-side. Currently:

@@ -237,13 +259,13 @@ See [`modes/README.md`](modes/README.md) for the index and page template.

 ## Safety controller

-`_safetyController` runs **before** `_controlLogic` every tick. Two rules, deliberately asymmetric — *dry-run protects the pumps from running themselves into air*, *overfill protects the basin from spilling*.
+`_safetyController` runs **before** `_controlLogic` every tick. Two rules, deliberately asymmetric — *dry-run protects the pumps from running themselves into air*, *high-volume protection tries to preserve distance to actual overflow*.

 ![Safety rules — dry-run vs overfill](diagrams/safety-rules.drawio.svg)

-During overfill, level-based control naturally commands ≥100 % on the downstream MGC because the level is above `maxLevel`.
+During high-volume or overflow conditions, level-based control naturally commands >=100 % on the downstream MGC because the level is above `maxLevel`.

-> ⚠️ **Known limitation — gravity-sewer context.** The "upstream STOP" action only makes sense in a **cascaded** station layout where the upstream equipment is an EVOLV-controllable pump or station. In a conventional wastewater wet-well the inflow is gravity-fed from the municipal sewer and **cannot be stopped** — attempting to would back up toilets. For that case the correct response to an overfill event is to **measure and log the spill over the weir** (for compliance reporting) and raise an alarm, while keeping downstream pumps at maximum demand. The current code fires `execSequence: shutdown` on upstream children regardless of what they are; that should be gated on "is the upstream actually controllable?" and supplemented with overflow-rate tracking. Tracked as follow-up work.
+> ⚠️ **Known limitation — gravity-sewer context.** The "upstream STOP" action only makes sense in a **cascaded** station layout where the upstream equipment is an EVOLV-controllable pump or station. In a conventional wastewater wet-well the inflow is gravity-fed from the municipal sewer and **cannot be stopped** — attempting to would back up toilets. For that case the correct response at the high-volume safety point is to alarm early and keep downstream pumps at maximum demand. If `level >= overflowLevel`, the station should report actual overflowing as a boolean and, later, estimate/log spill over the weir for compliance reporting. The current code fires `execSequence: shutdown` on upstream children regardless of what they are; that should be gated on "is the upstream actually controllable?" and supplemented with overflow-rate tracking. Tracked as follow-up work.

 A missing volume reading is treated as a hard fault: every direct machine is sent `execSequence: shutdown` and `safetyControllerActive` latches. Calibrate predicted volume (`calibratePredictedVolume`) or wire a level measurement to recover.

@@ -292,8 +314,8 @@ The canonical end-to-end demo lives in the EVOLV superproject at [`examples/pump

 | Symptom | Likely cause | Fix |
 |---|---|---|
-| `fill %` exceeds 100 % or is negative | Basin geometry inconsistent — e.g. `overflowLevel > heightBasin`, or `outflowLevel > inflowLevel`. | Cross-check `0 < outflowLevel < inflowLevel < overflowLevel ≤ heightBasin` in the editor. |
-| Pumps never start in `levelbased` | Level is stuck in the DEAD ZONE between `minLevel` and `startLevel`, or `startLevel == maxLevel` so the scaling range collapses. | Widen the control band: move `startLevel` above `minLevel` and set `maxLevel ≈ overflowLevel`. |
+| `fill %` exceeds 100 % or is negative | Basin geometry inconsistent — e.g. `overflowLevel > basinHeight`, or `outflowLevel > inflowLevel`. | Cross-check `0 < outflowLevel < inflowLevel < overflowLevel <= basinHeight` in the editor. |
+| Pumps never start in `levelbased` | Level is stuck in the DEAD ZONE between `minLevel` and `startLevel`, or `startLevel == maxLevel` so the scaling range collapses. | Widen the mode control band. In sewer-gravity cases, `startLevel` is normally below `inflowLevel` so the station starts draining before the incoming sewer pipe is hydraulically affected. |
 | "No volume data available to safe guard system; shutting down all machines." in logs | No measured level, predicted volume not calibrated, and no inflow/outflow samples yet. | Issue `calibratePredictedVolume` (or `calibratePredictedLevel`) once at startup, or wire a level sensor. |
 | `flowSource: null` and `direction: 'steady'` forever | Every flow / level signal falls inside the dead-band (default `1e-4 m³/s`). | Confirm flows are non-zero, or lower `config.general.flowThreshold` for a small-scale demo. |
 | `Qd` ignored | Station is not in `manual` mode. | Send `{ topic: 'changemode', payload: 'manual' }` first, or fall back to level-based control. |
--- a/wiki/modes/levelbased.md
+++ b/wiki/modes/levelbased.md
@@ -20,9 +20,9 @@ The simplest and most widely deployed control strategy. Demand is a direct, *sta

 ## Diagram

-![Level-based mode — demand vs level transfer function](../diagrams/modes/levelbased.drawio.svg)
+![Level-linear basin mode — demand vs level transfer function](../diagrams/modes/basin-mode-level-linear.drawio.svg)

-*Editable source: [`../diagrams/modes/levelbased.drawio.svg`](../diagrams/modes/levelbased.drawio.svg) (drag into [draw.io](https://app.diagrams.net/) — it round-trips).*
+*Editable source: [`../diagrams/modes/basin-mode-level-linear.drawio.svg`](../diagrams/modes/basin-mode-level-linear.drawio.svg) (drag into [draw.io](https://app.diagrams.net/) — it round-trips).*

 ## Inputs
Author	SHA1	Message	Date
Rene De Ren	da50403c76	Update pumping station basin documentation	2026-05-05 10:38:24 +02:00
znetsixe	ab0d4ed285	Editor: pin outlet, add zone labels + volume to the diagram Three user-facing fixes: 1. Outlet was getting pushed below the tank floor by the top-down nudge because its ideal y is already near the bottom. Now outflowLevel is PINNED at its proportional y (like basinHeight is pinned at the rim) and a second bottom-up pass pushes non-pinned items upward from the outlet anchor. Result: outlet stays near the tank floor, dryRunLevel sits right above it, the rest of the stack stays readable. Two anchors, two passes. 2. Zone labels mirrored from the wiki basin-model drawio: - "Spare volume before spilling" (overflowLevel ↔ maxLevel) - "Sewage + tank buffer" (maxLevel ↔ startLevel) - "Tank buffer" (startLevel ↔ minLevel) - "Tank buffer" (minLevel ↔ dryRunLevel) - "Dead volume" (outflowLevel ↔ floor) Each sits at the midpoint of its pair of nudged thresholds and hides when the gap between them is too small to read (< 14 px). 3. basinVolume moved into the SVG as a pinned input above the tank rim (alongside basinHeight), replacing the separate form row. One editor, one diagram — the total volume belongs with the geometry. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>	2026-04-23 13:19:58 +02:00
znetsixe	2dd419dbf4	Editor: nudge dashed lines themselves, revert tank height Reverts the tank-bigger approach from last commit. Instead of scaling the tank and keeping strict proportionality, the dashed threshold lines are now nudged apart directly so each gets a guaranteed 36-px vertical gap. Inputs and labels align with the lines (no more leader lines needed). Trade-off: the diagram is now an ordered schematic, not a strictly to-scale rendering. Values are still shown next to each line via the input boxes, and the value ordering is preserved. For an editor where the goal is entering parameters, readability wins over scale fidelity. Sizing reverted: viewBox 620 → 430 tank h 520 → 340 botY 560 → 380 Behavior: GAP 30 → 36 (more visible space between dashed lines) placeItem takes a single y now (line + input + label + unit share it); leader-line mechanism kept as hidden plumbing in case we switch back to proportional later Dead-volume band now anchors to the (possibly-nudged) outflow line instead of the proportional y so it still visually meets the line cleanly. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>	2026-04-23 12:10:23 +02:00
znetsixe	785d036dc6	Editor: taller tank — more vertical room between threshold lines Tank height 340 → 520 px (viewBox 480 → 620). Lines that were cramped in the bottom metre now have ~50 % more room, so: - The Outlet arrow no longer visually crowds the minLevel line - Dashed threshold lines (dryRunLevel, minLevel, outflowLevel) have visible breathing room between them for typical wastewater values where they sit in the bottom 1 m - Input-stack GAP bumped 26 → 30 px to match the extra vertical real estate Pure layout change — same proportional mapping, same nudging algorithm, just more canvas. Floor/datum label and ordering- warning ribbon positions shifted accordingly. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>	2026-04-23 11:41:03 +02:00
znetsixe	65fe68b87f	Editor: nudge crowded threshold inputs off their lines with leader lines When real wastewater values cluster near the basin floor (minLevel, dryRunLevel, outflowLevel are often within a few cm of each other), the threshold inputs were stacking on top of each other. Now: - Threshold LINE stays at its proportional y on the tank (visual truth: that's where the level actually is). - Input BOX / label / unit are positioned in a nudged right-column stack with a minimum 26-px gap so they never overlap. - A dashed grey leader line connects each line to its input when they had to be pulled apart, so the association stays visible. - Items are sorted by ideal y top-down and nudged downward once; basinHeight is pinned at the rim and acts as the anchor. Also: viewBox extended 430 → 480 so the bottom-of-stack items have room below the tank when the bottom cluster is tight. Warning ribbon moved to y=460 accordingly. No schema change; purely UI layout. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>	2026-04-23 10:41:16 +02:00
znetsixe	d641d2248d	Editor: interactive basin diagram — inputs placed at each threshold line Replaces the static parameters-diagram-above-form-rows layout with a single interactive SVG where every threshold input sits directly on the tank at its proportional y-position. Typing a value repositions the corresponding line + input + label live. What moved into the diagram (via <foreignObject> holding real <input> elements with their existing node-input-* IDs so Node-RED save/restore is untouched): basinHeight — top of tank (fixed at rim by definition) overflowLevel — weir crest (red, dashed) maxLevel — 100 % demand line (orange, dashed) startLevel — ramp-start line (green, dashed) minLevel — MGC-shutdown line (purple, dashed) inflowLevel — Inlet arrow + input on left outflowLevel — Outlet arrow + input on right dryRunLevel — read-only, computed from outflow × (1+dryRunPct/100) Also in the diagram: - Dead-volume band fills the area below outflowLevel dynamically - Warning ribbon appears below the tank if ordering invariants break (mirrors specificClass._validateThresholdOrdering) - All positions scale against the user's basinHeight; if empty, a default 5 m scale is used just to keep the diagram readable What stayed as regular form rows: - Basin Volume (m³) — not a height, can't be placed on a y-axis - minLevel / startLevel / maxLevel were in the Control Strategy > Level-based section; removed from there and moved into the diagram (the level-based subsection now contains a one-line pointer) - Safety % inputs (dryRun, overfill) stay in the Safety section with their derived-level readouts, now synced with the diagram No schema changes, no field additions, no behaviour changes in the runtime. Pure editor-UX. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>	2026-04-23 10:28:18 +02:00
znetsixe	12904b4902	Editor: inline parameters diagram at top of Basin Geometry ~3 KB inline SVG showing the 5 threshold lines + inlet/outlet pipe arrows + floor datum, using the same names as the editor fields (basinHeight, overflowLevel, maxLevel, startLevel, minLevel, dryRunLevel). No new inputs — purely a visual reminder of what each field refers to, so operators don't have to alt-tab to the wiki to figure out which pipe edge to measure. Wrapped in <details open> so users can collapse it once they know the layout — no forced scroll through the diagram on every edit session. Matches the vocabulary in wiki/diagrams/basin-model.drawio.svg (inlet = bottom of pipe, outlet = top of pipe, 0 m datum at basin floor, dryRunLevel derived from %). Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>	2026-04-23 10:19:23 +02:00