fix(planner): živé EV SoC z integrálu power_w — konec phantom 11 kW oken

needed_wh i headroom z live_soc (soc_at_connect + integrál power_w), ne ze
zamrzlého soc_at_connect. energy_delivered_wh se během session nikdy nezapisoval
(→ needed konstantní, plánovač slepý k pokroku), counter energy_kwh (Telto reg 39)
je rozbitý (17.4 kWh nabito → counter 0.18). Nový fn_ev_session_delivered_wh
integruje power_w (dt cap 120 s), clamp 99 %, fallback drží staré chování bez
telemetrie. Ověřeno živě: needed_wh 18750→1329, live_soc 97.9 %.

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

docs/04-modules/ev-charging.md

@@ -237,7 +237,18 @@ Uložit do `ev_session` při připojení/odpojení.
 ### Renault Zoe
 
 Žádné API. Stav připojení čteme výhradně z WB Modbus (`status != 'available'`).
-SoC Zoe neznáme přesně – použijeme energii dodanou v session (kumulativní kWh z WB).
+SoC Zoe neznáme přesně – použijeme energii dodanou v session.
+
+### Živé SoC během session (needed_wh, fix 2026-06-14)
+
+`fn_ev_session_planning_json` (R__038) počítá `energy_needed_wh` i `headroom_wh` z
+**živého SoC** = `soc_at_connect + dodaná_energie/kapacita`, clamp 99 % (finální taper
+ignorujeme) — ne ze zamrzlého `soc_at_connect`. Dodaná energie je **time-weighted integrál
+`power_w`** (`ems.fn_ev_session_delivered_wh`, dt cap 120 s), NE counter `energy_kwh`:
+ten je na TeltoCharge (Telto reg 39) **rozbitý** — neakumuluje (ověřeno: 17.4 kWh nabito,
+counter 0.18). Bez toho byl `energy_delivered_wh` trvale 0 → needed_wh konstantní →
+plánovač slepý k pokroku → phantom 11 kW okna i u plného auta. Funguje pro Teslu i Zoe
+(power-based, bez API). Pozn.: reg 39 rozbitý ⇒ i EV audit/ekonomika z něj jede naslepo.
 
 ---