implementace dynamickeho bodu T (kde se rodpojuje PV A)
Some checks failed
CI and deploy / migration-check (push) Failing after 15s
CI and deploy / deploy (push) Has been skipped

This commit is contained in:
Dusan Vojacek
2026-05-26 13:28:31 +02:00
parent a53bcd0b81
commit 58b0a2f882
6 changed files with 310 additions and 73 deletions

View File

@@ -71,7 +71,9 @@ NEG_BUY_CHARGE_SHORTFALL_PENALTY_CZK_KWH = 100.0
PRE_NEG_CHARGE_PENALTY_CZK_KWH = 400.0
PRE_NEG_BATT_EXPORT_SHORTFALL_PENALTY_CZK_KWH = 80.0
PRE_NEG_BATT_EXPORT_MIN_SELL_CZK_KWH = 1.0
PLANNER_BUILD_TAG = "2026-05-28-load-first-hard-v34"
PLANNER_BUILD_TAG = "2026-05-28-neg-sell-b-ramp-v35"
# Po t_detach v prep: necpát PV do bat (měkké; tvrdý hold přes soc_target z rampy).
NEG_SELL_POST_DETACH_BCPV_DISCOURAGE_CZK_KWH = 250.0
# Před prvním sell<0: export FVE jen pokud predikce v sell<0 okně pokryje dobítí na prep cíl.
PRE_NEG_PV_EXPORT_FORECAST_MARGIN = 1.15
PRE_NEG_PV_EXPORT_MIN_NEEDED_WH = 2500.0
@@ -821,34 +823,112 @@ def _neg_sell_phases_enabled(battery: Any) -> bool:
return prep_pct < 100.0 - 1e-6 and tail_slots > 0
def _neg_sell_pv_b_charge_wh(slot: PlanningSlot, battery: Any) -> float:
"""Odhad Wh nabitelné jen z PV B v jednom sell<0 slotu (surplus nad load, cap výkonu)."""
pv_surplus_b = max(0.0, float(slot.pv_b_forecast_w) - float(slot.load_baseline_w))
if pv_surplus_b <= 500.0:
return 0.0
cap_w = min(pv_surplus_b, float(battery.max_charge_power_w))
return cap_w * INTERVAL_H * float(battery.charge_efficiency)
def _neg_sell_day_pv_b_usable_wh(
slots: list[PlanningSlot],
first_neg_sell_idx: int | None,
battery: Any,
) -> float:
"""Součet B-nabíjení ve všech sell<0 slotech téhož pražského dne."""
if first_neg_sell_idx is None:
return 0.0
neg_day = _prague_calendar_date(slots[first_neg_sell_idx])
total = 0.0
for s in slots:
if _prague_calendar_date(s) != neg_day:
continue
if float(s.sell_price) >= 0.0:
continue
total += _neg_sell_pv_b_charge_wh(s, battery)
return total
def _neg_sell_e_surplus_after_t_wh(
slots: list[PlanningSlot],
t_detach: int,
last_neg: int,
battery: Any,
) -> float:
"""Integrál přebytku FVE nad load+bat cap od t_detach do last_neg (Wh)."""
total = 0.0
for t in range(t_detach, last_neg + 1):
if t < 0 or t >= len(slots):
continue
st = slots[t]
if float(st.sell_price) >= 0.0:
continue
pv_surplus = max(
0.0,
float(st.pv_a_forecast_w)
+ float(st.pv_b_forecast_w)
- float(st.load_baseline_w),
)
if pv_surplus <= 500.0:
continue
cap_charge_wh = (
min(pv_surplus, float(battery.max_charge_power_w))
* INTERVAL_H
* float(battery.charge_efficiency)
)
total += max(0.0, pv_surplus * INTERVAL_H - cap_charge_wh)
return total
def _neg_sell_day_phases(
slots: list[PlanningSlot],
battery: Any,
) -> tuple[list[str], list[Optional[float]], list[float]]:
) -> tuple[list[str], list[Optional[float]], list[float], dict[str, Any]]:
"""
Per slot: phase (none|prep|tail), soc_target_wh (None mimo sell<0 fáze), prep shortfall váha.
Fáze po kalendářním dni v Europe/Prague.
Per slot: phase (none|prep|tail), soc_target_wh (rampa z PV B, ne fixní %), shortfall váha.
V35: zpětná projekce soc_need z B od tail; t_detach = první prep kde soc_need ≤ soc_need[tail_start].
"""
t_len = len(slots)
phases: list[str] = ["none"] * t_len
soc_targets: list[Optional[float]] = [None] * t_len
shortfall_weights: list[float] = [0.0] * t_len
prep_pct = float(getattr(battery, "planner_neg_sell_prep_soc_percent", 100.0))
tail_n = int(getattr(battery, "planner_neg_sell_full_soc_tail_slots", 0))
prep_wh = prep_pct / 100.0 * float(battery.soc_max_wh)
soc_max = float(battery.soc_max_wh)
min_soc = float(battery.min_soc_wh)
post_detach_prep_ts: set[int] = set()
day_meta: list[dict[str, Any]] = []
by_day: dict[object, list[int]] = {}
for t, st in enumerate(slots):
if float(st.sell_price) < 0.0:
by_day.setdefault(_prague_calendar_date(st), []).append(t)
for _day, indices in by_day.items():
for day, indices in by_day.items():
if not indices:
continue
indices.sort()
last_t = indices[-1]
tail_start = max(indices[0], last_t - tail_n + 1)
tail_start = max(indices[0], last_t - tail_n + 1) if tail_n > 0 else last_t + 1
charge_b = {t: _neg_sell_pv_b_charge_wh(slots[t], battery) for t in indices}
soc_need: dict[int, float] = {last_t: soc_max}
for i in range(len(indices) - 1, 0, -1):
t_cur = indices[i]
t_prev = indices[i - 1]
soc_need[t_prev] = max(min_soc, soc_need[t_cur] - charge_b[t_cur])
soc_detach_wh = float(soc_need.get(tail_start, soc_max))
t_detach = tail_start
for t in indices:
if t >= tail_start:
continue
if soc_need[t] <= soc_detach_wh + 1e-3:
t_detach = t
break
e_surplus = _neg_sell_e_surplus_after_t_wh(slots, t_detach, last_t, battery)
for t in indices:
if t >= tail_start:
phases[t] = "tail"
@@ -857,12 +937,45 @@ def _neg_sell_day_phases(
else:
pos = t - tail_start
frac = pos / float(max(1, tail_n - 1))
soc_targets[t] = prep_wh + frac * (soc_max - prep_wh)
lo = float(soc_need.get(tail_start, soc_max))
soc_targets[t] = lo + frac * (soc_max - lo)
else:
phases[t] = "prep"
soc_targets[t] = prep_wh
soc_targets[t] = float(soc_need[t])
if t >= t_detach:
post_detach_prep_ts.add(t)
shortfall_weights[t] = float(last_t - t + 1) / float(len(indices))
return phases, soc_targets, shortfall_weights
day_meta.append(
{
"prague_date": str(day),
"first_neg_idx": indices[0],
"last_neg_idx": last_t,
"tail_start_idx": tail_start,
"t_detach_idx": t_detach,
"soc_detach_wh": soc_detach_wh,
"e_surplus_after_t_wh": e_surplus,
"soc_ramp_wh": [
{
"slot": slots[t].interval_start.isoformat(),
"soc_need_wh": float(soc_need[t]),
"phase": phases[t],
"soc_target_wh": float(soc_targets[t] or 0.0),
}
for t in indices
],
}
)
meta: dict[str, Any] = {
"neg_sell_b_ramp_v35": True,
"days": day_meta,
"post_detach_prep_ts": sorted(post_detach_prep_ts),
}
if day_meta:
meta["t_detach_idx"] = day_meta[0]["t_detach_idx"]
meta["e_surplus_after_t_wh"] = day_meta[0]["e_surplus_after_t_wh"]
return phases, soc_targets, shortfall_weights, meta
def _neg_sell_day_pv_usable_wh(
@@ -906,25 +1019,27 @@ def _pre_neg_pv_export_forecast_cushion_ok(
neg_sell_phases_en: bool,
) -> bool:
"""
Export FVE před sell<0 jen pokud forecast v záporném okně pokryje dobítí na cíl (typ. 80 %).
Export FVE před sell<0 jen pokud forecast B v sell<0 okně pokryje dobítí na soc_need z rampy.
Jinak raději nabíjet teď — riziko deště / podhodnocené FVE v sell<0.
"""
if first_neg_sell_idx is None or first_neg_sell_idx <= 0:
return False
prep_pct = float(getattr(battery, "planner_neg_sell_prep_soc_percent", 100.0))
if neg_sell_phases_en and prep_pct < 100.0 - 1e-6:
target_wh = prep_pct / 100.0 * float(battery.soc_max_wh)
if neg_sell_phases_en:
_ph, targets, _w, _meta = _neg_sell_day_phases(slots, battery)
tgt = targets[first_neg_sell_idx]
target_wh = float(tgt) if tgt is not None else float(battery.soc_max_wh)
usable_wh = _neg_sell_day_pv_b_usable_wh(slots, first_neg_sell_idx, battery)
else:
target_wh = float(battery.soc_max_wh)
usable_wh = _neg_sell_day_pv_usable_wh(
slots,
first_neg_sell_idx,
max_charge_power_w=float(battery.max_charge_power_w),
charge_efficiency=float(battery.charge_efficiency),
)
needed_wh = max(0.0, target_wh - float(current_soc_wh))
if needed_wh < PRE_NEG_PV_EXPORT_MIN_NEEDED_WH:
return True
usable_wh = _neg_sell_day_pv_usable_wh(
slots,
first_neg_sell_idx,
max_charge_power_w=float(battery.max_charge_power_w),
charge_efficiency=float(battery.charge_efficiency),
)
return usable_wh >= needed_wh * PRE_NEG_PV_EXPORT_FORECAST_MARGIN
@@ -1725,12 +1840,18 @@ def solve_dispatch(
neg_sell_phase_by_t: list[str] = ["none"] * T
neg_sell_soc_target_by_t: list[Optional[float]] = [None] * T
neg_sell_shortfall_weight_by_t: list[float] = [0.0] * T
neg_sell_day_meta: dict[str, Any] = {}
neg_sell_post_detach_prep_ts: set[int] = set()
if neg_sell_phases_en:
(
neg_sell_phase_by_t,
neg_sell_soc_target_by_t,
neg_sell_shortfall_weight_by_t,
neg_sell_day_meta,
) = _neg_sell_day_phases(slots, battery)
neg_sell_post_detach_prep_ts = set(
neg_sell_day_meta.get("post_detach_prep_ts") or []
)
prep_soc_shortfall: list[tuple[int, pulp.LpVariable, float]] = []
prep_hold_bcpv_shortfall: list[tuple[int, pulp.LpVariable, float]] = []
prep_hold_curtail_shortfall: list[tuple[int, pulp.LpVariable, float]] = []
@@ -2265,6 +2386,13 @@ def solve_dispatch(
/ 1000.0
for t in pre_neg_pv_export_ts
)
+ pulp.lpSum(
bc_pv[t]
* NEG_SELL_POST_DETACH_BCPV_DISCOURAGE_CZK_KWH
* INTERVAL_H
/ 1000.0
for t in neg_sell_post_detach_prep_ts
)
+ pulp.lpSum(
sf * NEG_SELL_BAT_DUMP_SHORTFALL_PENALTY_CZK_KWH * INTERVAL_H / 1000.0
for _t, sf, _cap in neg_sell_bat_dump_shortfall
@@ -2329,18 +2457,13 @@ def solve_dispatch(
prob += us >= float(tgt_prep) - soc[t_us]
for t_us, us, tgt_wh in neg_sell_soc_underfill:
prob += us >= float(tgt_wh) - soc[t_us]
prep_wh_phases = (
float(getattr(battery, "planner_neg_sell_prep_soc_percent", 80.0))
/ 100.0
* float(battery.soc_max_wh)
if neg_sell_phases_en
else 0.0
)
m_hold_soc = float(battery.soc_max_wh)
for t_h, sf_h, cap_h in prep_hold_bcpv_shortfall:
w_h = prep_hold_met_binary[t_h]
soc_prev_h = current_soc_wh if t_h == 0 else soc[t_h - 1]
prob += soc_prev_h >= prep_wh_phases - m_hold_soc * (1 - w_h)
tgt_hold = neg_sell_soc_target_by_t[t_h]
hold_thr = float(tgt_hold) if tgt_hold is not None else float(battery.soc_max_wh)
prob += soc_prev_h >= hold_thr - m_hold_soc * (1 - w_h)
prob += sf_h >= bc_pv[t_h] - cap_h * w_h
for t_c, sf_c, cap_c in prep_hold_curtail_shortfall:
w_c = prep_hold_met_binary[t_c]
@@ -3189,6 +3312,9 @@ def solve_dispatch(
if neg_sell_soc_target_by_t[t] is not None
else None
),
"neg_sell_post_detach_prep": (
t in neg_sell_post_detach_prep_ts if neg_sell_phases_en else None
),
}
)
tgt_s = st.safety_soc_target_wh if daytime_en else None
@@ -3285,6 +3411,21 @@ def solve_dispatch(
),
},
"neg_sell_phases_enabled": bool(neg_sell_phases_en),
"neg_sell_b_ramp_v35": bool(neg_sell_phases_en),
"neg_sell_day_meta": neg_sell_day_meta if neg_sell_phases_en else None,
"t_detach_idx": (
neg_sell_day_meta.get("t_detach_idx") if neg_sell_phases_en else None
),
"e_surplus_after_t_wh": (
neg_sell_day_meta.get("e_surplus_after_t_wh")
if neg_sell_phases_en
else None
),
"neg_sell_day_pv_b_usable_wh": (
_neg_sell_day_pv_b_usable_wh(slots, first_neg_sell_idx, battery)
if first_neg_sell_idx is not None and neg_sell_phases_en
else None
),
"pre_neg_pv_export_forecast_ok": bool(pre_neg_pv_export_forecast_ok),
"pre_neg_pv_export_slots": [
slots[i].interval_start.isoformat() for i in sorted(pre_neg_pv_export_ts)

View File

@@ -3703,7 +3703,7 @@ class PlannerArbitrageImprovementsTests(unittest.TestCase):
class NegSellSocPhaseTests(unittest.TestCase):
"""Fázované SoC v okně sell<0 (v32): prep 80 %, tail rampa, vent B s prahem."""
"""Fázované SoC v okně sell<0 (v35): rampa z PV B, tail, vent B s prahem."""
@staticmethod
def _phase_battery(**kw: float) -> SimpleNamespace:
@@ -3750,11 +3750,26 @@ class NegSellSocPhaseTests(unittest.TestCase):
def test_day_phases_tail_last_four(self) -> None:
slots = self._neg_sell_slots(10)
bat = self._phase_battery(tail_slots=4)
phases, targets, _w = _neg_sell_day_phases(slots, bat)
phases, targets, _w, meta = _neg_sell_day_phases(slots, bat)
self.assertEqual(phases[5], "prep")
self.assertEqual(phases[9], "tail")
self.assertEqual(phases.count("tail"), 4)
self.assertAlmostEqual(float(targets[9] or 0), bat.soc_max_wh, delta=50.0)
self.assertTrue(meta.get("neg_sell_b_ramp_v35"))
prep_targets = [float(targets[t] or 0) for t in range(6) if phases[t] == "prep"]
self.assertGreater(len(prep_targets), 1)
for a, b in zip(prep_targets, prep_targets[1:]):
self.assertGreaterEqual(b, a - 1.0)
def test_b_ramp_t_detach_and_surplus_meta(self) -> None:
slots = self._neg_sell_slots(12, pv_b=6000)
bat = self._phase_battery(tail_slots=4)
_ph, _tg, _w, meta = _neg_sell_day_phases(slots, bat)
self.assertIsNotNone(meta.get("t_detach_idx"))
self.assertGreaterEqual(int(meta["t_detach_idx"]), 0)
self.assertLess(int(meta["t_detach_idx"]), 8)
self.assertGreater(float(meta.get("e_surplus_after_t_wh") or 0), 0.0)
self.assertIn("post_detach_prep_ts", meta)
def test_prep_reaches_soc_by_mid_window(self) -> None:
slots = self._neg_sell_slots(12)
@@ -3782,6 +3797,8 @@ class NegSellSocPhaseTests(unittest.TestCase):
)
self.assertEqual(snap.get("planner_build_tag"), PLANNER_BUILD_TAG)
self.assertTrue(snap.get("inputs", {}).get("neg_sell_phases_enabled"))
self.assertTrue(snap.get("inputs", {}).get("neg_sell_b_ramp_v35"))
self.assertIsNotNone(snap.get("inputs", {}).get("t_detach_idx"))
# Nabíjení z FVE v sell<0: SoC roste, tail má vyšší cíl než začátek okna.
self.assertGreater(results[-1].battery_soc_target, results[0].battery_soc_target)
self.assertGreaterEqual(results[-1].battery_soc_target, 75.0)
@@ -3875,7 +3892,7 @@ class NegSellSocPhaseTests(unittest.TestCase):
class PreNegPvExportForecastTests(unittest.TestCase):
"""v33: export FVE před sell<0 jen pokud forecast v sell<0 okně pokryje prep SoC."""
"""v33/v35: export FVE před sell<0 jen pokud forecast B v sell<0 okně pokryje soc_need z rampy."""
@staticmethod
def _slots_morning_then_neg(n: int = 22, *, neg_pv_scale: float = 1.0) -> list[PlanningSlot]:
@@ -3885,7 +3902,8 @@ class PreNegPvExportForecastTests(unittest.TestCase):
sell = -0.25 if i >= 6 else (2.8 if i < 4 else 1.2)
if i >= 6:
pv_a = (8000 + (i - 6) * 500) * neg_pv_scale
pv_b = 6000.0 * neg_pv_scale
# v35 cushion: usable jen z B — dostatečný B pro rampu v test_cushion_ok
pv_b = 9500.0 * neg_pv_scale
else:
pv_a = 1500 + i * 400
pv_b = 1500.0

View File

@@ -2,7 +2,7 @@
Navazuje na [`planning.md`](planning.md), [`planning-arbitrage-accounting.md`](planning-arbitrage-accounting.md), [`planning-changelog.md`](../planning-changelog.md), [`heat-pump.md`](heat-pump.md), [`ev-charging.md`](ev-charging.md).
**Stav:** část je **implementovaná** (v32v34), část je **návrh** (v35+ termika, bazén, spirála). V textu je označeno `✅ hotovo` vs `📋 návrh`.
**Stav:** část je **implementovaná** (v32v35), část je **návrh** (v36+ termika, bazén, spirála). V textu je označeno `✅ hotovo` vs `📋 návrh`.
---
@@ -31,6 +31,7 @@ Navazuje na [`planning.md`](planning.md), [`planning-arbitrage-accounting.md`](p
| **`E_surplus_after_t`** 📋 | Integrál plánovaného přebytku FVE (typ. od **T** do `last_sell<0`), který by jinak šel do sítě / curtail — budget pro TČ předehřát, bazén, spirálu. |
| **Pre-neg export (v33)** | Kladné `sell` **před** prvním `sell < 0`: export FVE jen pokud forecast v celém `sell < 0` okně pokryje dobítí na prep cíl (× margin **1,15**). |
| **Load-first (v34)** | Dům z `pv_ld`; při dostatečné FVE žádný fiktivní `grid_import = load` v plánu. |
| **Rampa B + bod T (v35)** | `soc_need` zpět od tail jen z PV B; **t_detach**; `E_surplus_after_t`; uvolnění A po T (měkké). |
| **Reg 340** | Deye *max solar power*`pv_a_forecast_solver_w pv_a_curtailed_w`. |
---
@@ -56,13 +57,13 @@ Navazuje na [`planning.md`](planning.md), [`planning-arbitrage-accounting.md`](p
### 3.2 Fáze B — okno `sell < 0`
**Energie (dnes v32, návrh v35):**
**Energie (v32v35):**
| Období v B | Dnes (v32) | Návrh (v35) |
|------------|------------|-------------|
| Začátek okna | ASAP nabít na **80 %** z A+B | Nabít podle **rampy SoC** odvozené zpět z B od tail |
| Střed okna | Měkký **curtail A** při SoC ≥ 80 % na začátku slotu | Od **T**: A necpát do bat; B + přebytek |
| Tail (posledních N slotů) | Rampa 80 % → 100 % | Rampa z **T** / B → 100 % |
| Období v B | Chování (v35) |
|------------|----------------|
| Začátek okna | Nabít podle **rampy SoC** (`soc_need`) zpět z PV B od tail |
| Střed okna | Od **t_detach**: měkké omezení `bc_pv`; hold/curtail při `soc_prev ≥ soc_target[t]` |
| Tail (posledních N slotů) | Rampa z `soc_need[tail_start]` → 100 % |
**Termika (📋):**
@@ -83,7 +84,7 @@ Navazuje na [`planning.md`](planning.md), [`planning-arbitrage-accounting.md`](p
---
## 4. Implementované vrstvy (v32v34)
## 4. Implementované vrstvy (v32v35)
### 4.1 v32 — fázované SoC a curtail A ✅
@@ -91,7 +92,7 @@ Navazuje na [`planning.md`](planning.md), [`planning-arbitrage-accounting.md`](p
| Sloupec | Default | Význam |
|---------|---------|--------|
| `planner_neg_sell_prep_soc_percent` | 80 | Plochý cíl SoC v prep fázi (% `soc_max`). **100** = legacy (tlak na max až v tail). |
| `planner_neg_sell_prep_soc_percent` | 80 | **v32 legacy** — od v35 se v LP neřídí (rampa z B). **100** = vypnutí fází (`_neg_sell_phases_enabled`). |
| `planner_neg_sell_full_soc_tail_slots` | 4 | Počet 15min slotů tail před koncem denního `sell < 0`. **0** = bez tail. |
| `planner_neg_sell_vent_min_sell_czk_kwh` | 1 (home-01) | V tail: ventil pole B (`ge_pv`) pokud `sell ≥` práh. **NULL** = jen při plné baterii. |
@@ -127,11 +128,32 @@ Navazuje na [`planning.md`](planning.md), [`planning-arbitrage-accounting.md`](p
**Ověření:** `LoadFirstDispatchTests::test_neg_sell_prep_no_fictitious_grid_import_for_load`.
### 4.4 v35 — rampa SoC z PV B, bod T, přebytek ✅
**Tag:** `2026-05-28-neg-sell-b-ramp-v35`
**Kód:** `_neg_sell_pv_b_charge_wh`, `_neg_sell_day_phases` (rampa), `_neg_sell_e_surplus_after_t_wh`, `_neg_sell_day_pv_b_usable_wh` (cushion v33).
- Zpětná projekce `soc_need` jen z PV B; prep `soc_target[t] = soc_need[t]` (ne fixních 80 %).
- **t_detach** = první prep slot kde `soc_need[t] ≤ soc_need[tail_start]`; **E_surplus_after_t** od T do konce okna.
- Prep hold: `soc_prev ≥ soc_target[t]`; po T: `NEG_SELL_POST_DETACH_BCPV_DISCOURAGE` na `bc_pv`.
- `solver_params.inputs`: `neg_sell_b_ramp_v35`, `t_detach_idx`, `e_surplus_after_t_wh`, `neg_sell_day_meta`.
**Ověření:** `NegSellSocPhaseTests::test_b_ramp_t_detach_and_surplus_meta`, MCP `solver_params`.
---
## 5. Návrh v35 — energie: rampa z PV B, bod T, přebytek
## 5. Specifikace rampy (v35 — reference)
📋 **Není v produkci** — specifikace pro implementaci.
### 5.0 Rozhodnutí produktu (home-01, 2026-05)
| Téma | Rozhodnutí |
|------|------------|
| Rampa / **T** | Odvozené z PV B; **bez** řízení fixním `planner_neg_sell_prep_soc_percent` v LP pro home-01. |
| TČ v pre-neg | **Zákaz** plánovaného topení. |
| Bazén | Min. 4 h filtrace/den, dynamicky navýšit; Shelly; přitop ručně / později. |
| Spirála | Loxone; v38. |
| UI flex | Workshop **před** v37 — viz § 9.1. |
### 5.1 Kotva vzadu (tail — beze změny konceptu)
@@ -270,25 +292,28 @@ Navrhované klíče v `planning_run.solver_params.inputs`:
Spirála vyžaduje **novou zátěž** v DB + LP (`flex_load_spiral[t]` nebo signál Loxone).
### 6.4 Konfigurovatelné teploty (📋 — rozhodnutí)
### 6.4 Parametry termiky (rozhodnutí + otevřeno)
| Parametr | Navrh | Poznámka |
|----------|-------|----------|
| `tuv_comfort_temp_c` | např. 5052 | Denní komfort |
| `tuv_preheat_temp_c` | např. 5558 | V bodu **T**, podmíněně |
| `tuv_evening_topup_before_min` | např. 90 | Doklep před sprchou |
| `hp_no_run_pre_neg_export` | true | Blok TČ ve fázích A (v33 sloty) |
| Parametr | Stav | Hodnota / poznámka |
|----------|------|---------------------|
| `hp_no_run_pre_neg_export` | **Rozhodnuto** | `true` — v `pre_neg_pv_export_ts` **netopit** (raději export FVE). |
| `tuv_comfort_temp_c` | Otevřeno | Např. 5052 °C — doplnit do konfigurace site. |
| `tuv_preheat_temp_c` | Otevřeno | Např. 5558 °C — jen v bodu **T**, pokud `E_surplus_after_t` stačí. |
| `tuv_evening_topup_hour` | **Rozhodnuto** | **19:00** Europe/Prague — večerní doklep TUV (implementace v36). |
| Spirála | **Rozhodnuto** | Ovládání **Loxone**; model v EMS až v38. |
---
## 7. Bazén — filtrace a přitop (📋)
### 7.1 Provozní záměr
### 7.1 Provozní záměr (rozhodnutí home-01)
- **Filtrace ~1 kW** — regulovatelný **denní rozpočet hodin** (např. 46 h).
- **Kdy:** jen ve **slunečných** hodinách (např. 09:0017:00 Prague, nebo příznak `is_daytime_pv_surplus_slot` z `fn_load_planning_slots_full`).
- **Proč ve dni:** cirkulace promíchá prohřátou hladinu (uživatelský požadavek).
- **Priorita:** po naplnění bat rampy / od **T**, před exportem B za `sell < 0`.
- **Filtrace ~1 kW** — min. **4 h/den**; **více hodin**, pokud `E_surplus_after_t` a přebytek dovolí (marginalní náklad ≈ 0).
- **Kdy:** přes den ve **slunečných** slotech (`is_daytime_pv_surplus_slot` nebo obdobné); **dynamicky** dle cen / přebytku, ne pevné okno 0917.
- **Proč ve dni:** cirkulace promíchá prohřátou hladinu.
- **Priorita:** po rampě bat / od bodu **T**, před exportem B za `sell < 0`.
- **Přitop vody:** **mimo** první verzi plánovače; začátek sezóny **ručně**; automatika později.
- **Exekuce:** **Shelly** — ovládání z EMS po implementaci assetu (v37).
### 7.2 Napojení na `E_surplus_after_t`
@@ -342,6 +367,27 @@ Příklad: forecast A = 4654 W, curtail = 1117 W → povoleno **3537 W*
**Bat. / síť / SoC:** `battery_setpoint_w` / `grid_setpoint_w` / `battery_soc_target_pct` — po v34 u vysoké FVE **grid ≈ 0**, ne fiktivní import = load.
### 9.1 Vizualizace flexibilních zátěží — probrat před implementací (📋)
**Stav:** produktové rozhodnutí **není****neimplementovat** bazén / rozšířené TČ v UI ani v LP sinku, dokud není schválený návrh. Workshop mezi **v35** a **v37**.
**Proč:** flexibilní zátěže (TČ, bazén, spirála, EV) sdílí stejnou časovou osu jako energie (**T**, `E_surplus_after_t`, fáze sell&lt;0). Bez přehledného UI bude provoz těžko kontrolovatelný.
**Návrhy k diskusi** (nic z toho není závazná implementace):
| Nápad | Co ukázat |
|-------|-----------|
| **Pásma dne** | V grafu plánu: pre-neg export \| sell&lt;0 prep \| od **T** \| tail \| večerní export bat. |
| **Bod T** | Svislá značka + tooltip: `t_detach`, `e_surplus_after_t_wh`, odhad hodin bazénu. |
| **Rozpočet bazénu** | „Dnes 2/4 h filtrace naplánováno“ + zbývající Wh přebytku. |
| **Slot detail** | Kromě bat/síť/FVE: **TČ** (`heat_pump_setpoint_w`), **EV**, (budoucí) **bazén ON**, badge **flex sink**. |
| **Srovnání běhů** | Před/po v35: rampa SoC, méně fiktivního grid importu, curtail A. |
| **Živě vs plán** | Volitelně: telemetrie TUV / Shelly pool vs plánovaný stav (až bude data). |
**Výstup workshopu:** krátký mock / seznam widgetů v `Planning.tsx` + které sloupce ukládat do `planning_interval` / `solver_params`.
**Otevřené otázky UI:** viz [`docs/06-open-questions.md`](../06-open-questions.md).
---
## 10. Priorita flexibilních spotřebičů (📋)
@@ -363,14 +409,15 @@ Při `sell < 0` a plné / dostatečné baterii:
## 11. Roadmap implementace
| Fáze | Tag / doc | Obsah | Závislost |
|------|-----------|--------|-----------|
| **v35** | `neg-sell-b-ramp-v35` | Rampa `soc_need` z B, **T**, `E_surplus_after_t`, uvolnění A | V083 sloupce; náhrada plochých 80 % v LP |
| **v36** | termika-v36 | Blok TČ v pre-neg; TUV doklep; komfort v `sell<0` po **T** | v35 |
| **v37** | pool-v37 | Asset bazén, denní hodiny, LP sink | v35 |
| **v38** | spiral-v38 | Spirála + volba TČ vs spirála | Loxone/Modbus, v37 |
| Pořadí | Fáze | Tag / doc | Obsah | Blokátor |
|--------|------|-----------|--------|----------|
| 1 | **v35** | `neg-sell-b-ramp-v35` | Rampa `soc_need` z B, **T**, `E_surplus_after_t`, uvolnění A | |
| 2 | **UI workshop** | — | Vizualizace flex. zátěží — § 9.1; schválený návrh widgetů | **Před v37** |
| 3 | **v36** | `termika-v36` | Blok TČ pre-neg; TUV v `sell<0` po **T**; večerní doklep **19:00** Prague | v35 |
| 4 | **v37** | `pool-v37` | Bazén: Shelly, min 4 h/den, LP sink | UI workshop |
| 5 | **v38** | `spiral-v38` | Spirála (Loxone) + volba TČ vs spirála | v37 |
Každá fáze: migrace (pokud DB), `planning_engine.py`, testy MILP, zápis do `planning-changelog.md`, ověření na home-01 přes MCP.
Každá implementační fáze: migrace (pokud DB), `planning_engine.py`, testy MILP, `planning-changelog.md`, ověření MCP na home-01.
---
@@ -426,4 +473,6 @@ cd backend && python3 -m pytest tests/test_planning_dispatch_milp.py -k "NegSell
## 14. Otevřená rozhodnutí
Přesunuta do [`docs/06-open-questions.md`](../06-open-questions.md) sekce **Plánování — neg sell, termika, bazén** — nutné doplnit před v36+.
Živý seznam: [`docs/06-open-questions.md`](../06-open-questions.md) sekce **Plánování — neg sell, termika, flexibilní zátěže**.
Zbývá hlavně: **čas večerního doklepu TUV** (~19h?), **návrh UI flex zátěží** (workshop před v37).

View File

@@ -50,7 +50,7 @@
**Planner tag v26:** v25 + upřesnění večerního exportu — viz sekce **Večerní export z baterie** níže a changelog v26.
**Planner tag v23:** v22b + **výboj baterie do sítě** před `buy<0` (`_pre_neg_buy_discharge_indices`, sell≥1 Kč/kWh, push `ge_bat` z DB limitů). Viz changelog v23.
V `solve_dispatch` (AUTO): **`charge_slots`** = `allow_charge` z DB + **`buy < 0`** + všechny sloty **`sell < 0`** s PV přebytkem > 500 W (i bez `block_export_on_negative_sell`, BA81). **`pv_charge_shortfall`** / **`NEG_SELL_CURTAIL_PENALTY`** platí v těchto slotech. Při **`sell < 0`** (legacy): safety deficit cílí **`soc_max_wh`**; po posledním **`sell < 0`**: **`post_neg_pv_topup`**. **Planner tag v32:** fázované SoC — viz níže.
- **Záporný výkup — strategie home-01 (v32v34 hotovo, v35+ návrh):** Kompletní specifikace (rampa SoC z PV B, bod **T**, termika, bazén, UI curtail): **[`planning-neg-sell-strategy.md`](planning-neg-sell-strategy.md)**. Stručně — **v32:** `planner_neg_sell_prep_soc_percent` (80 %), `planner_neg_sell_full_soc_tail_slots` (4), `planner_neg_sell_vent_min_sell_czk_kwh`; fáze prep/tail, měkký curtail A. **v33:** export FVE před `sell<0` s forecast pojistkou. **v34:** tvrdý load-first. **v35 (návrh):** nahradit fixních 80 % rampou z B a bodem **T**.
- **Záporný výkup — strategie home-01 (v32v35 hotovo, v36+ návrh):** Kompletní specifikace (rampa SoC z PV B, bod **T**, termika, bazén, UI curtail): **[`planning-neg-sell-strategy.md`](planning-neg-sell-strategy.md)**. Stručně — **v32:** fáze prep/tail, curtail A. **v33:** export FVE před `sell<0` s forecast pojistkou (B usable). **v34:** tvrdý load-first. **v35:** rampa `soc_need` z PV B, **t_detach**, `E_surplus_after_t` (tag `2026-05-28-neg-sell-b-ramp-v35`).
- **Před sell&lt;0 — export FVE s forecast pojistkou (v33):** `_pre_neg_pv_export_forecast_cushion_ok` — export FVE v kladných slotech před prvním `sell<0` jen pokud součet predikovaného PV přebytku v sell&lt;0 okně (týž pražský den) pokryje dobítí na prep SoC (× **1,15**). Jinak LP raději nabíjí z FVE (riziko deště). Při splněné pojistce: `bc_pv=0` v `pre_neg_pv_export_ts`, shortfall na `ge_pv`, penalizace `bc_pv`. `solver_params.inputs.pre_neg_pv_export_forecast_ok`, `pre_neg_pv_export_slots`. Testy `PreNegPvExportForecastTests`. U **fixního tarifu** s polem B: **`ge_pv ≤ pv_b`** (ne pv_store **`ge_pv = 0`**). Při **`deye_gen_microinverter_cutoff_enabled`**: **`ge == 0` jen** pokud **`block_export_on_negative_sell`** (KV1), ne kvůli samotnému `z_gen_cutoff` (BA81 musí moci exportovat B při plné baterii). Vstupní **`soc_wh`** z telemetrie se před MILP omezí přes **`_planner_soc_for_solver`** (rezerva ~650 Wh pod `soc_max`, jinak Infeasible při 100 % SoC a dlouhém záporném výkupu). **`planner_build_tag`** v `solver_params`. Changelog: [`docs/planning-changelog.md`](../planning-changelog.md).
- **Záporná nákupní cena:**
- horní mez `grid_import` zahrnuje `load_baseline_w` + nabíjení/EV/TČ (bez nekonečného importu).

View File

@@ -18,15 +18,34 @@ Tento soubor slouží jako živý seznam věcí které je potřeba rozhodnout p
## Důležité (neblokují, ale řeší se brzy)
### Plánování — neg sell, termika, bazén
### Plánování — neg sell, termika, flexibilní zátěže
Kompletní návrh: [`docs/04-modules/planning-neg-sell-strategy.md`](04-modules/planning-neg-sell-strategy.md). Implementace v35+ čeká na doplnění:
Kompletní návrh: [`docs/04-modules/planning-neg-sell-strategy.md`](04-modules/planning-neg-sell-strategy.md).
- [ ] **v35 — bod T a rampa SoC z PV B** — potvrdit, zda `soc_detach_wh` = odvozené z rampy, nebo ponechat konfigurovatelné % jako strop (náhrada 80 %).
- [ ] **TUV teploty**`tuv_comfort_temp_c`, `tuv_preheat_temp_c` pro předehřát v bodu T; čas večerního doklepu před sprchou (fixní hodina vs. uživatelský profil).
- [ ] **Bazén**`filter_hours_per_day` (kolik hodin filtrace), okno slunce (Prague 0917?), jen filtrace 1 kW nebo i přitop TČ vody.
- [ ] **Spirála** — je ovladatelná z EMS/Loxone? Samostatný asset vs. signál; priorita oproti TČ v dnech bez `sell < 0`.
- [ ] **TČ v pre-neg exportu** — potvrdit zákaz plánovaného topení ve slotech `pre_neg_pv_export_ts` (v36).
#### Rozhodnuto (home-01, 2026-05)
| Téma | Rozhodnutí |
|------|------------|
| **v35 — bod T, rampa SoC** | `soc_detach` a rampa **jen odvozené** z forecastu PV B zpět od tail (100 %). Fixní **80 %** v LP pro home-01 **zrušit** (sloupce V083 mohou zůstat pro legacy/KV1, ale solver home-01 je neřídí). |
| **TČ před `sell < 0`** | V ranních slotech **pre-neg export** (v33) **netopit** — energii raději **prodat** do site. |
| **Spirála** | Ovládání přes **Loxone** (signál / virtuální vstup). Samostatný model v EMS až ve fázi v38. |
| **Bazén — filtrace** | Min. **4 h/den**, za dne **více**, pokud je přebytek (`E_surplus_after_t`) a „nic to nestojí“. Rozložení **dynamicky** dle cen / přebytku / slunce, ne pevné 0917. |
| **Bazén — přitop** | **Mimo** automatiku plánovače na začátku; sezónní nahřátí **ručně**. Automatický přitop až později, pokud vůbec. |
| **Bazén — exekuce** | **Shelly** (zapínání filtrace) — napojit až po v37 (asset + LP), ovládání z EMS. |
#### Otevřeno před implementací
- [x] **TUV — večerní doklep****19:00** Europe/Prague (rozhodnuto 2026-05); implementace v **v36**; doplnit `tuv_comfort_temp_c` / `tuv_preheat_temp_c` do konfigurace site.
- [ ] **Vizualizace flexibilních zátěží v UI****probrat a navrhnout před v37+** (neimplementovat bazén/TČ sink do FE naslepo). Viz [`planning-neg-sell-strategy.md` § 9.1](04-modules/planning-neg-sell-strategy.md). Návrhy k diskusi: pásma dne (pre-neg / sell&lt;0 / bod **T**), rozpočet hodin bazénu vs. `E_surplus_after_t`, slotový rozpad `hp` / EV / (budoucí pool), srovnání běhů plánu.
- [x] **v35 implementace** — rampa B, **t_detach**, `E_surplus_after_t` (`2026-05-28-neg-sell-b-ramp-v35`).
#### Roadmap (pořadí)
1. ~~**v35**~~ — hotovo
2. **Workshop UI** — flexibilní zátěže (viz výše)
3. **v36** — termika (blok TČ pre-neg, TUV v `sell < 0`, doklep **19:00**)
4. **v37** — bazén (Shelly + LP), až po UI dohodě
5. **v38** — spirála (Loxone)
- [x] **Arbitráž baterie — 1. vlna (před solve):** `charge_acquisition_buy_czk_kwh` + cutoff před 1. `allow_discharge_export`; LP `+ge_bat×acquisition` v exportních slotech. Zbývá iterace po solve a více charge slotů — [`planning-arbitrage-accounting.md`](04-modules/planning-arbitrage-accounting.md) §6, [`docs/05-todo.md`](05-todo.md).

View File

@@ -7,7 +7,17 @@ Formát: **datum (ISO)** · stručný důvod · soubory · chování / ověřen
## 2026-05-28 — Dokumentace strategie sell&lt;0 + termika + bazén
**Soubor:** [`docs/04-modules/planning-neg-sell-strategy.md`](04-modules/planning-neg-sell-strategy.md) — cíle, slovník, časová osa dne, v32v34 vs návrh v35+, TČ/TUV podle typu dne, bazén, UI curtail/reg 340, roadmap, SQL ověření. Otevřená rozhodnutí: [`docs/06-open-questions.md`](06-open-questions.md).
**Soubor:** [`docs/04-modules/planning-neg-sell-strategy.md`](04-modules/planning-neg-sell-strategy.md) — cíle, slovník, časová osa dne, v32v35, návrh v36+, TČ/TUV podle typu dne, bazén, UI curtail/reg 340, roadmap, SQL ověření.
**Rozhodnutí home-01** (souhrn v [`docs/06-open-questions.md`](06-open-questions.md)): rampa/**T** odvozené z PV B (bez fixních 80 % v LP); TČ ne v pre-neg exportu; bazén min 4 h/den + Shelly; spirála Loxone; **workshop UI flex zátěží před v37** (§ 9.1 strategie).
## 2026-05-28 — Rampa SoC z PV B, bod T (v35)
**Kód:** `backend/services/planning_engine.py` — tag `2026-05-28-neg-sell-b-ramp-v35`.
**Změna:** `_neg_sell_day_phases` počítá `soc_need[t]` zpětnou projekcí jen z PV B; prep cíle = rampa (ne fixních 80 %). **t_detach**, **E_surplus_after_t** v `solver_params.inputs`. Prep hold na `soc_target[t]` z rampy; po T měkké `NEG_SELL_POST_DETACH_BCPV_DISCOURAGE`. Cushion v33: cíl z rampy, usable jen z B.
**Ověření:** `pytest tests/test_planning_dispatch_milp.py -k "NegSell or PreNeg or LoadFirst"`; MCP `solver_params.inputs.neg_sell_day_meta`.
## 2026-05-28 — Tvrdý load-first v LP (v34)