third version before modbus cleanup

docs/04-modules/planning.md

@@ -13,14 +13,19 @@
 - **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)`).
+  - `min_soc_percent` = tvrdá spodní mez SoC v LP (typicky 10 %),
+  - `reserve_soc_percent` = ekonomická („arbitrážní“) podlaha – pod ní MILP s binární proměnnou omezuje vybíjení tak, aby export z baterie nečerpal hluboké pásmo (typicky 20 %; migrace V027 může vrátit hodnotu po V026),
+  - `degradation_cost_czk_kwh` (např. 0.15) / penalizace cyklu 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.
+- **SoC buffer:**
+  - měkký cíl na konci 24h přes `_soc_security_profile` + tvrdé dvouúrovňové pravidlo výše.
+- **Dynamická ekonomická podlaha (fáze 2):**
+  - `_dynamic_arb_floor_wh_series`: podle součtu FVE výkonu v dalších ~8 h (`ARB_LOOKAHEAD_SLOTS`) se `arb_floor_wh[t]` posouvá mezi `min_soc_wh` a rezervou z DB – silné očekávané slunce ji sníží (ráno / po obloze); vynutit konstantní chování lze `battery.disable_dynamic_arb_floor=True` jen pro testy / ladění.
+- **Záporná nákupní cena:**
+  - horní mez `grid_import` zahrnuje `load_baseline_w` + nabíjení/EV/TČ (bez nekonečného importu).
+- **Uložené vstupy plánu** (`planning_interval`): `load_baseline_w`, `pv_*_forecast_raw_w`, `pv_*_forecast_solver_w` pro UI a audit.
 
 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)
@@ -179,11 +184,11 @@ soc[0] == current_soc_wh  # počáteční podmínka z telemetrie
 
 ### SoC limity
 ```python
-soc_min_wh <= soc[t] <= soc_max_wh
+soc_min_wh <= soc[t] <= soc_max_wh   # min_soc_percent z DB (např. 10 %)
 
-# Rezerva pro výpadek sítě – nikdy nesahat
-soc_reserve_wh = battery.reserve_soc_percent / 100 * battery.usable_capacity_wh
-soc[t] >= soc_reserve_wh  # za normálních podmínek
+# Ekonomická podlaha (reserve_soc_percent, např. 20 %): binární w_arb[t] v MILP –
+# pod touto hranicí je bd omezeno na load+EV+TČ+bc (žádné „nadbytečné“ vybíjení pro export z baterie).
+# Měkký buffer na konci 24h dál přes soc_deficit_24h.
 ```
 
 ### Limity výkonu
@@ -266,7 +271,7 @@ def solve_dispatch(
     batt_charge    = [pulp.LpVariable(f"bc_{t}", 0, battery.max_charge_power_w)    for t in range(T)]
     batt_discharge = [pulp.LpVariable(f"bd_{t}", 0, battery.max_discharge_power_w) for t in range(T)]
     soc            = [pulp.LpVariable(f"soc_{t}",
-                                       battery.reserve_soc_wh,
+                                       battery.min_soc_wh,
                                        battery.soc_max_wh)                    for t in range(T)]
     curtail_a      = [pulp.LpVariable(f"ca_{t}", 0, slots[t].pv_a_forecast_w) for t in range(T)]
     ev_charge      = [pulp.LpVariable(f"ev_{t}", 0, ev_max_total_w)           for t in range(T)]