Merge branch 'worktree-agent-a53f3277d55fecfcb' into dev

docs/04-modules/ev-charging.md

@@ -376,12 +376,33 @@ stav baterie auta → cíl (+kWh), deadline, plánovaná nabíjecí okna s ø ce
 
 Tvrdý cíl (deadline) = „bez tohohle neodjedu"; měkký cíl = „klidně doplň
 do 100 %, když je energie skoro zadarmo". Implementace: dekompozice
-Σ(EV energie) == needed − unmet + opp; `opp ∈ [0, headroom]`
-(headroom = (100 − target) % kapacity, jen když `asset_vehicle.
-opportunistic_value_czk_kwh > 0`; default 1 Kč/kWh, 0 = vypnuto).
+Σ(EV energie) == needed − unmet + opp; `opp ∈ [0, headroom]`.
+**Headroom = (100 − max(target, soc_at_connect)) % kapacity** (fix paradoxu
+„nižší target → větší headroom": auto fyzicky bere jen energii nad svým
+aktuálním SoC). **Hodnota kWh:** `coalesce(ev_session.opportunistic_value_czk_kwh,
+asset_vehicle.opportunistic_value_czk_kwh)` — V099 přidal per-session override
+(NULL = zdědit z vozidla, 0 = vypnout pro session ⇒ headroom_wh = 0; patch
+klíčem `opportunistic_value_czk_kwh` ve `fn_ev_session_apply_patch`, validace ≥ 0).
+Default vozidla 1 Kč/kWh, 0 = vypnuto.
 Hodnota = ušetřené BUDOUCÍ nabíjení (auto neumí zpět — žádný noční prodej),
 proto nízká → uplatní se při záporných cenách / plné domácí baterce
 (lepší než curtail), běžné ceny ji nezaplatí. Víkendový vzor „pátek
 nemusím do plna, víkend doplní zadarmo" z toho plyne sám. Dekompozice
-zároveň stropuje celkovou energii do auta (dřív při buy<0 chyběl strop).
-Session zůstává v plánu i po dosažení targetu, dokud má headroom.
+zároveň stropuje celkovou energii do auta (dřív při buy<0 chyběl strop) —
+a **bez session je EV == 0** (stop-session nevypíná jen tvrdý cíl, ale i
+oportunismus). Session zůstává v plánu i po dosažení targetu, dokud má headroom;
+**oportunistická vrstva není omezená deadline** (auto bývá doma dál, odjezd
+řeší rolling replan — rozhodnutí 2026-06-12).
+
+### Min. výkon wallboxu a účtování via-bat (2026-06-12, dev)
+
+- **`asset_ev_charger.min_power_w`** (1380 W = 6 A IEC 61851) jde přes
+  `fn_planning_site_context` do solver_v2: binárka `ev_on[e][t]`,
+  `setpoint ∈ {0} ∪ [min_power_w, max]` — žádné nevykonatelné 400–900 W.
+- **Tvrdý cíl** sčítá jen sloty **před** deadline (slot začínající v deadline
+  už nepatří „do deadline" — oprava off-by-one).
+- **`ev_direct ≤ gi + PV`** (fyzikální split; via_bat kryje vybíjení baterie).
+- **Reporting:** kWh do EV z baterie (via_bat) neplatí slotový buy; solver_v2
+  je oceňuje oportunitní cenou v `planning_interval.battery_arbitrage_czk`
+  (min sell exportního slotu téhož pražského dne, jinak terminal value) a
+  `fn_plan_current_bundle.intervals` nese `ev1/ev2_via_bat_w` pro UI.

docs/04-modules/planning.md

@@ -819,4 +819,30 @@ Plánovač má dvě implementace, přepínané env proměnnými (`backend/app/co
   front-load v sell<0 (`planner_pv_risk_frontload_czk_kwh`, V090), denní SoC
   rampa (`safety_soc_target_wh` × `planner_safety_soc_risk_factor`, V091).
   Detail: hlavička `solver_v2.py` + changelog 2026-06-12.
+- **EV ve v2 — účtování, headroom, min. výkon (2026-06-12):**
+  - **Deadline boundary:** tvrdý cíl sčítá energii jen ve slotech `t < t_deadline`
+    (první slot s `interval_start >= deadline` už energii dodává po odjezdu —
+    dřívější off-by-one `range(t_dl + 1)` opraven).
+  - **Měkký cíl (oportunismus):** dekompozice `Σ(EV energie) == needed − unmet + opp`;
+    `opp ∈ [0, headroom_wh]`. **Headroom** = `(100 − max(target_soc_pct,
+    soc_at_connect_pct)) % kapacity` (R__039) — „nenabíjet" (nízký target) už
+    paradoxně NEzvětšuje oportunistickou vrstvu; auto fyzicky bere jen nad svým
+    SoC. Hodnota kWh = `coalesce(ev_session.opportunistic_value_czk_kwh,
+    asset_vehicle.opportunistic_value_czk_kwh)` (V099: session override; NULL =
+    zdědit, 0 = vypnout pro session → `headroom_wh = 0`); patch klíčem
+    `opportunistic_value_czk_kwh` v `fn_ev_session_apply_patch` (validace ≥ 0).
+    **Oportunistická vrstva NENÍ omezená deadline** (rozhodnutí 2026-06-12:
+    auto bývá doma dál, odjezd řeší rolling replan). **Bez session je EV == 0**
+    i při `buy < 0` (stop-session; dřív neomezené „pumpování").
+  - **Min. výkon wallboxu:** `asset_ev_charger.min_power_w` (6 A ≈ 1380 W) jde
+    přes `fn_planning_site_context` (vehicles JSON) do binárky `ev_on[e][t]` —
+    setpoint ∈ {0} ∪ [min, max]; konec nevykonatelných 400–900 W setpointů.
+  - **Fyzikální split:** `Σ_e ev_direct[e][t] ≤ gi[t] + pv_a_net + pv_b_eff`
+    (direct jen ze sítě + PV; via_bat kryje `bd`). Ekonomiku nemění, ale split
+    direct/via_bat už není arbitrární.
+  - **Reporting via_bat:** kWh do EV z baterie neplatí slotový buy — solver_v2
+    plní `battery_arbitrage_czk` oportunitní cenou (min `sell` exportního slotu
+    téhož pražského dne, jinak terminal value; clamp ≥ 0) × via_bat energie
+    (dřív konstantní 0). `fn_plan_current_bundle` nese `ev1/ev2_via_bat_w`
+    v `intervals`, aby UI necenilo EV kWh z baterie slotovým buy.
 - Regresní brána a měření: `scripts/harness/README.md` (golden replay, economics report, penalty audit, `solver_v2_eval.py`); plán refaktoru: `docs/refactor-clean-planner.md`.