docs: design řízení TUV (EHS set-point posun + spirály) s NZÚ TČ+FV compliance mappingem

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

docs/04-modules/tuv-control-design.md

@@ -0,0 +1,60 @@
+# Řízení TUV přes Samsung EHS + spirály (home-01) — návrh
+
+Stav 2026-06-13: telemetrie TČ živá (MIM-B19N, unit 5 na 172.16.1.17); řízení
+zatím neimplementováno. Tento doc = odsouhlasený design (majitel 2026-06-13)
++ dotační compliance mapping.
+
+## Topologie
+
+- Samsung EHS (vzduch-voda), MIM-B19N Modbus (registry: `modbus-registers-mim-b19n.md`).
+- Zásobník TUV 1000 l, teplota z MIM base+25 (1min telemetrie `tuv_tank_temp_c`).
+- Trojcestný ventil topení/TUV — přepíná **Samsung sám** při aktivním DHW.
+- DHW režim musí být povolen ve **venkovní jednotce (FSV field setting)** — jednorázově majitel.
+- El. spirály v zásobníku — ovládané z **Loxone** (VI), hardwarový termostat = bezpečnostní strop.
+- Příkon TČ se zatím odhaduje z COP (`fn_cop_estimate`); MIM příkon neměří → časem elektroměr.
+
+## Princip řízení (filozofie v2 — ceny, žádné heuristiky)
+
+**Aktuace TČ = posun set-pointu, ne on/off:** mimo ohřevová okna DHW set
+(base+24) na základní teplotě (např. 40 °C), v plánovaném okně 55–60 °C;
+base+22 (DHW on) trvale 1. Vnitřní hystereze Samsungu řeší starty/stopy —
+EMS necykluje kompresor, jen posouvá cíl. Zápisy přes `modbus_command`
+journal (§17), write-on-change.
+
+**Plánovač — zásobník jako druhá baterie s deadline (vzor EV):**
+- stav: `tuv_tank_temp_c` + naučené odběry (`tuv_usage_stats`);
+- constraints: deadline komfort („18:30 ≥ X °C"), průběžné minimum;
+- dvě nabíjecí cesty s cenou:
+  - **TČ blok**: teplo = příkon × COP(T_out, T_zásobník); min-run ≥ 30 min
+    (`min_run_duration_min`, binárka s min-uptime — vzor bazén);
+  - **spirála**: účinnost 1.0, bez min-run, jen Loxone signál.
+- MILP vybírá sám: přebytek FVE → boost set-pointu **přes TČ**; záporné ceny
+  → TČ + spirály souběžně (TČ do ~58 °C, spirály nad to); deadline →
+  nejlevnější sloty dne. Kaskáda záporného dne (baterie → EV 100 % → TUV TČ
+  → spirály) je emergentní z cen.
+
+**Spirály**: signál `TUV_HEATER_ON` přes stávající signální infrastrukturu
+(`signal_def` / `signal_route` → Loxone VI, journal + verify).
+
+## Dotační compliance (NZÚ RD, standardní výzva 9/2023)
+
+Varianta **TČ+FV** (tab. 6, 140 tis.) i bonus **FVE s efektivním využitím TČ**
+(4.3.3.2 j) vyžadují totéž (str. 22 c) odkazuje na j)):
+
+| Podmínka | Plnění EMS |
+|---|---|
+| TČ hlavní zdroj UT+TV, řízení výkonu | invertorové EHS + EMS set-pointy/režimy přes MIM (journal = důkaz) |
+| Akumulační nádrž ≥ 400 l | 1000 l |
+| Regulace monitoruje výkon FVE a spotřebu | 1min telemetrie PV + CT ulice + dům |
+| Dostatečný výkon FVE → ohřev vody TČ, popř. **zvýšení set-pointu nad základ pro dohřev TČ** | boost mechanismus výše — doslovné plnění |
+| Dohřev nad základ přes TČ (ne jen patrony) | kaskáda: spirály až nad strop TČ / extrémní ceny |
+
+Evidence pro kontrolu: telemetrie + planning_interval + modbus_command journal.
+
+## Čeká na majitele
+
+1. Povolit DHW ve FSV venkovní jednotky (jednorázově).
+2. Spirály: počet, příkon (kW), Loxone VI názvy, max. teplota.
+3. Komfort: cílová teplota v 18:30, průběžné minimum, legionella program
+   (60 °C+ 1×týdně — zvládnou spirály).
+4. Elektroměr TČ (Shelly EM / Chint) pro skutečný příkon a COP.