From b1686183328e2bef26e5bc2213174fe838969b12 Mon Sep 17 00:00:00 2001
From: Dusan Vojacek <dusan.vojacek@direct.cz>
Date: Sat, 13 Jun 2026 00:31:24 +0200
Subject: [PATCH] =?UTF-8?q?V104=20=C3=BAklid=20stale=20pending=20+=20TUV?=
 =?UTF-8?q?=20design:=20stavov=C3=BD=20automat,=20spir=C3=A1la=20dump-load?=
 =?UTF-8?q?,=20legionella?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
---
 .../V104__journal_stale_pending_cleanup.sql     |  8 ++++++++
 docs/04-modules/tuv-control-design.md           | 17 +++++++++++++++++
 2 files changed, 25 insertions(+)
 create mode 100644 db/migration/V104__journal_stale_pending_cleanup.sql

diff --git a/db/migration/V104__journal_stale_pending_cleanup.sql b/db/migration/V104__journal_stale_pending_cleanup.sql
new file mode 100644
index 0000000..262b387
--- /dev/null
+++ b/db/migration/V104__journal_stale_pending_cleanup.sql
@@ -0,0 +1,8 @@
+-- Jednorázový úklid: pending příkazy z doby před opravou execute invariantu
+-- (b087825 — „nikdy pending") nemá kdo dokončit.
+
+update ems.modbus_command
+  set status = 'failed',
+      error_msg = 'stale pending (pre-fix b087825)'
+  where status = 'pending'
+    and created_at < timestamptz '2026-06-12T23:00:00Z';
diff --git a/docs/04-modules/tuv-control-design.md b/docs/04-modules/tuv-control-design.md
index d7a98e6..a018131 100644
--- a/docs/04-modules/tuv-control-design.md
+++ b/docs/04-modules/tuv-control-design.md
@@ -51,6 +51,23 @@ Varianta **TČ+FV** (tab. 6, 140 tis.) i bonus **FVE s efektivním využitím T
 
 Evidence pro kontrolu: telemetrie + planning_interval + modbus_command journal.
 
+## Stavový automat setpointu (doplnění z hloubkové analýzy 2026-06-13)
+
+Reg 72 (DHW on) trvale 1; řídí se výhradně setpoint reg 74. Stavy:
+NIGHT_FLOOR 44 °C (noc, hystereze 42/45) → PV_ABSORB 55 °C (měřený přebytek
+> příkon TČ) → PRE_COMFORT 52 °C (deadline minus dopočtená doba dohřevu,
+~35 min/10 K horní vrstvy) → DUMP 58–60 °C (sell < 0, tvrdý strop 60).
+Reg 73 primárně Eco; Power/Force jen ruční boost / nouzový dohřev /
+legionella. Průtokový had: cíle +5–8 K nad TUV; komfort = teplota HORNÍ
+vrstvy — jednorázový charakterizační test (výstupní TUV při plném průtoku
+vs T_top 45/50/55 °C) kalibruje minimum. Spirála = dump load řízený MĚŘENÝM
+exportem (zap: export > P+500 W ≥ 2 min nebo sell < 0; vyp: import > 200 W
+≥ 30 s), umístění v horní polovině nádrže. Legionella: u průtokového hada
+bez týdenního 60° cyklu — stačí občasný DUMP doběh z přebytku; Samsung
+anti-legionella FSV vypnout. Senzory dle priority: T_top (≈ reg 75, ověřit
+umístění), T_mid, T_TUV_out za výměníkem, flow-switch, měření spirály.
+Otevřené: zápis reg 73 na HT Quiet ověřit na živém zařízení před implementací.
+
 ## Čeká na majitele
 
 1. Povolit DHW ve FSV venkovní jednotky (jednorázově).