second version

docs/04-modules/planning.md

@@ -4,6 +4,24 @@
 
 **PuLP + HiGHS solver** – lineární programování (LP) s uvolněním binárních proměnných.
 
+### Implementované provozní změny (2026-03)
+
+- **Strict price fail-safe:**
+  - pokud v prvních 36h chybí OTE data (sloty jsou predikované), solver zapíná fail-safe režim,
+  - v predikovaných slotech (`is_predicted_price=true`) je zakázán export do sítě,
+  - baterie se ale dál používá standardně pro interní spotřebu (nabíjení i vybíjení do domu je povoleno).
+- **Runtime guard v exportu setpointů:**
+  - při `AUTO` + `is_predicted_price=true` se na exportní vrstvě vynutí PASSIVE/no-export chování.
+- **Ekonomika baterie:**
+  - `reserve_soc_percent` naladěn na 10 %,
+  - `degradation_cost_czk_kwh` naladěn na 0.1500,
+  - penalizace cyklu je v objective symetrická (`0.5*(charge+discharge)`).
+- **PV-aware nejistota:**
+  - objective používá `pv_scarcity_factor` (0.65..1.0), odvozený z forecastu slunce,
+  - při slabém slunci je plán ochotnější držet energii v baterii.
+- **SoC buffer bez hard pravidel:**
+  - místo explicitních pravidel se používá ekonomická penalizace deficitu vůči bezpečnostnímu SoC cíli na konci 24h horizontu.
+
 Solver optimalizuje celý horizont (typicky 36h) najednou, čímž přirozeně zvládá:
 - pohled dopředu (ráno ví že přes poledne bude záporná cena → prodává z baterie)
 - kompromisy mezi prodejem, nabíjením, TČ a EV v globálním optimu
@@ -394,12 +412,9 @@ PLANNING_HORIZON_HOURS=36
 PLANNING_SOLVER_TIME_LIMIT_SEC=10    # HiGHS timeout
 PLANNING_CURTAILMENT_PENALTY=0.001   # Kč/Wh penalizace za omezení FVE
 PLANNING_HP_RELAXATION_THRESHOLD=0.3 # pod 30% rated = OFF při post-processingu
-PV_B_GREEN_BONUS_CZK_KWH=1.20       # zelený bonus Kč/kWh (informativní, do účelové funkce přidat pokud chceš)
 ```
 
-> **Zelený bonus v účelové funkci:** Pokud chceš bonus explicitně zahrnout, přidat do objective function:
-> `- pv_b[t] * GREEN_BONUS_CZK_KWH * H / 1000` jako konstantní příjem (pole B vždy vyrábí).
-> Protože je to konstanta, neovlivní optimalizaci – ale správně zobrazí ekonomiku v auditu.
+> **Zelený bonus:** Sazba a platnost jsou v `ems.asset_pv_array` (`green_bonus_*`). Bonus **není** v objective function LP solveru – jako aditivní konstanta k nákladům by optimalizaci stejně neměnil. Příjem z bonusu se počítá v **`fn_fill_audit_interval`** přes `ems.fn_green_bonus_revenue()` a ukládá se do `audit_interval.green_bonus_czk`; v přehledech (např. `vw_audit_daily`) je samostatná položka příjmů vedle nákladů ze sítě. Viz `docs/04-modules/market-prices.md` → sekce Zelený bonus.
 
 ---
 
@@ -417,7 +432,7 @@ highspy>=1.7.0    # HiGHS Python binding (rychlejší než HiGHS_CMD)
 ## Otevřené body
 
 - [ ] Post-processing min_run_duration pro TČ – po LP výsledku zkontrolovat a upravit krátké ON/OFF sekvence
-- [ ] Zelený bonus zahrnout do auditního výpočtu nákladů (ne jen do objective)
+- [x] Zelený bonus v auditu (`fn_fill_audit_interval`, `green_bonus_czk`) – mimo solver
 - [ ] EV rozdělení výkonu mezi 2 nabíječky – zatím řešeno jako agregát
 - [ ] Curtailment pole A – ověřit Modbus registr pro Output Power Limit na Deye SUN-20K
 - [ ] Testovat solver na reálných datech – ověřit čas výpočtu pro 36h horizont (144 slotů)