Skip to content

feat(core): Phase 4 – PR 4-A Plan, Schnittstellenprüfung und Verträge - #25

Open
PXLJAKE wants to merge 12 commits into
mainfrom
claude/zealous-mayer-j5oda9
Open

PXLJAKE wants to merge 12 commits into
mainfrom
claude/zealous-mayer-j5oda9

Conversation

@PXLJAKE

@PXLJAKE PXLJAKE commented Oct 17, 2026

Copy link
Copy Markdown
Owner

Was

Erster von neun kleinen, gestapelten PRs für Phase 4 (Prognosen, Tarife, Planer, Akku), siehe docs/plans/phase-4.md §3.

  • Plan docs/plans/phase-4.md, Revision 2, freigegeben am 2026-10-16. Das Konzept „Prognose, Puffer und Akkuplanung“ ist eingearbeitet; §0 begründet, was jeweils übernommen wurde.
  • WP1 – Schnittstellen geprüft (nur Doku, docs/research/*), gegen den Quellcode mit festgehaltenem Commit bzw. Tag:
    • HA: recorder/statistics_during_period, energy/solar_forecast, weather.get_forecasts, workday, modbus.write_register, nordpool.get_prices_for_date, tibber.get_prices, kostal_plenticore
    • HACS-Integrationen: Solcast, Open-Meteo Solar Forecast, ENTSO-E, EPEX Spot, Octopus
    • Open-Meteo-API, nur aus dem Repository geprüft
  • WP2 – Verträge (suncore/core):
    • series.py: Zeitreihen und Quantile; Resampling auf das 15-Minuten-Raster, energieerhaltend und sicher bei der Zeitumstellung; Lücken bleiben None.
    • forecast.py: Protokolle für Prognose- und Preisquellen, Gütedatensätze.
    • tariff.py: Preisformel inkl. §14a Modul 3 je Quartal, HT/NT, anteilige EEG-Vergütung.
    • battery.py: Akku-Modell, Strategien (self_consumption, prefer_full, target_by_time), Risikoregler (Standard vorsichtig), Morgenpuffer, Überbrückung des nächsten Tages, Autarkie-Gewicht 0,01 €/kWh, Netzladen über Preisgrenze plus Zeitplan (standardmäßig aus), Kalibrierladung (aus).
    • BatteryAction: wird vom Gate in jedem Modus abgelehnt, bis WP10 die Invarianten liefert.
    • Plan v2 mit erwarteten Flüssen, Preisen und Gründen je Intervall; BatteryBand.priority_until_soc_pct.
    • Konfiguration mit Migrationen: forecast v2, tariff v3, goals v2 und der neue Abschnitt battery.
    • Vorlagen-Schema v1, nur additiv: Art battery, Preise in €/MWh, Prognosereihen als Zuordnung Zeitstempel → Wert.
  • ADR-0011, Nachtrag: Jede neue Aktionsart wird vom Gate abgelehnt, bis ihre Invarianten existieren.
  • ADR-0013 „Akku als gesteuertes Asset“: liegt als Vorschlag vor und muss vor WP10 angenommen werden.
  • docs/STATUS.md, docs/roadmap.md und die UNVERIFIED-Tabelle sind aktualisiert.

Warum

Die späteren PRs (Tarife, PV-Prognose, Last und Risiko, Planer, Akku, UI) brauchen gemeinsame, typisierte Verträge. Ohne geprüfte Schnittstellen würden die Adapter auf geratenen Feldnamen aufbauen.

Wie getestet

  • ./scripts/check.sh: ruff, mypy --strict, pytest 2866 bestanden, Abdeckung 96 % (neue Kernmodule 99–100 %).
  • check_reasons, Schema-Generierung, Kompatibilitätsliste und Vorlagenprüfung sind grün.
  • Hypothesis-Tests:
    • Resampling erhält die Energie.
    • Die Quantil-Reihenfolge bleibt erhalten.
    • Eine Lücke ergibt None.
    • Die Mischvergütung liegt zwischen den Stufen.
    • Die Goals-Präzedenz erlaubt nie mehr als vorher.
    • Das Gate lehnt BatteryAction für jeden Origin, jeden Modus und Not-Aus an/aus ab.
  • Migrationen wurden aus einem Phase-3-Export, per Re-Import und per Wiederherstellen aus der Historie getestet.
  • Frontend: gen:api:check, lint, svelte-check, vitest 219/219, Playwright E2E 162 bestanden. Bundle 132 kB gzip von 250 kB.
  • Screenshots: keine. Die Oberfläche ändert sich kaum: Formulare übernehmen nur neue Datenformen, und für einen gespeicherten HT/NT-Tarif gibt es einen Hinweistext.

Risiken

  • DB-Abschnitte neu versioniert (tariff v3, forecast v2, goals v2, neuer Abschnitt battery). Eine ältere Version (0.4.x) hält diese Abschnitte für ungültig. Vor dem Update die Konfiguration exportieren; das kommt auch in die Release-Notes.
  • BatteryAction ist ein neuer Vertragstyp. Er ist abgesichert, weil das Gate ihn immer ablehnt und alle Treiber ihn verweigern; dafür gibt es Tests.
  • Das Vorlagen-Schema wurde nur additiv erweitert (Changelog 0.5.0 in templates/README.md).

Safety-Review

control-safety: freigegeben für 4-A.

  • Ablehnung im Gate: BatteryAction wird nach der Alters- und der Not-Aus-Prüfung abgelehnt und vor der Bewertung für Schatten-, Assistenz- und Automatikmodus mit safety.battery_not_supported. Es wird nichts geschrieben, kein Vorschlag erzeugt und kein Laufzeitzustand angelegt.
  • Treiber: Alle Treiber lehnen die Aktion ab, release() bleibt wirkungslos; parametrisierter Test über alle fünf Treiber.
  • Invarianten unverändert bestanden: Netzbezugsgrenze, Akku-Reserve, Mindestlauf- und Pausenzeiten, Schaltungen pro Stunde, Komfortband, Schreibrate, Schreiben nur bei Änderung, Rücklesen, Watchdog, Not-Aus, Fail-safe. Die Grenztests für den einzigen Schreiber sind grün.
  • Unbeteiligt: Der Regler liest priority_until_soc_pct noch nicht; planner_value_per_kwh wirkt auf keinen Schreibpfad.
  • Migrationen: Sie berühren operation nicht, ein Import setzt weiter auf den Schattenmodus, und Netzladen bleibt nach der Migration aus.
  • mypy --strict ist grün, Abdeckung safety 97 %.
  • Reviewer-Befunde: M1–M5 und m1–m11 sind in fix(core) 595edba und im Doku-Commit d4893c4 behoben.

Checkliste

  • Tests für neues Verhalten, Lint/Typen/Tests grün
  • Keine hardcodierten UI-Strings; neue Keys in en und de
  • Doku / Parameter-Referenz aktualisiert (Benutzerdoku folgt in 4-H)
  • docs/STATUS.md und ggf. ADRs aktualisiert
  • Nichts erfunden: Entity-IDs, Services, Register mit Quelle oder UNVERIFIED

Offene Fragen an den Maintainer

  1. ADR-0013 (docs/adr/0013-battery-as-controlled-asset.md) bitte annehmen oder ändern, bevor der Akku-PR 4-G beginnt.
  2. Netzladen auf deinem Kostal: Über REST gibt es keinen Lade-Sollwert, und die Modbus-Register aus §3.5 können nur begrenzen. Mein Vorschlag: In Phase 4 wird Netzladen bei dir nur geplant und im Schattenmodus angezeigt, aber nicht ausgeführt. Ein eigener Sollwert-Weg (§3.4) bekäme später ein eigenes ADR.
  3. Netzlade-Zeitplan: Der Akku-Abschnitt gewinnt. Der alte Nachtzeitplan aus den Zielen schränkt eine Policy, die nur eine Preisgrenze hat, zusätzlich auf die Nacht ein (das entspricht deiner früheren Wahl „nur nachts“). Soll die UI das später anzeigen?
  4. MwSt. auf negative Börsenpreise: wird mitgerechnet (UNVERIFIED, bitte an der Tibber-Rechnung prüfen).
  5. EEG-Stufen, die die Anlage nicht ganz abdecken, werden beim Speichern abgelehnt; es wird kein Preis geraten. Passt das?
  6. Eine Preisformel auf einem reinen Preissensor ohne Vorlage wird akzeptiert, weil nicht bekannt ist, ob er schon Steuern enthält. Passt das?
  7. UNVERIFIED, Details in STATUS:
    • Energy-Charts und aWATTar (werden in Phase 4 nicht ausgeliefert)
    • Open-Meteo-Azimut live und die Terms-Seite
    • Kostal-REST: Vorzeichen und Entity-IDs
    • ob der Supervisor-Proxy recorder/* und energy/* durchreicht
    • Veröffentlichungszeit der Day-Ahead-Preise

Generated by Claude Code

…ttery interfaces

Read from primary sources (GitHub raw files at pinned SHAs and tags, PyPI
wheels): recorder statistics, energy/solar_forecast, weather.get_forecasts,
workday, modbus.write_register, Nord Pool, Tibber, Kostal Plenticore entities,
Solcast, Open-Meteo Solar Forecast, ENTSO-E, EPEX Spot, Octopus Energy and the
Open-Meteo API parameters and terms. Energy-Charts and aWATTar stay
UNVERIFIED (unreachable). Adds a summary table with the consequence for each
adapter.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01VHXsfH6PkT62o9idByAd6e
…Phase 4 plan

Revision 2, approved by the maintainer on 2026-10-16.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01VHXsfH6PkT62o9idByAd6e
… battery and plan v2

Time series with energy-preserving resampling onto the 15-minute grid, forecast and
price source protocols, price formula and time-of-use windows, battery model with
strategies, risk level, grid-charge policy (price level + schedule) and calibration
charge, BatteryAction (rejected by the gate until the battery path exists), Plan v2
with expected flows, prices and reasons, config sections forecast v2, tariff v3,
goals v2 and the new battery section with migrations, template kind battery.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01VHXsfH6PkT62o9idByAd6e
Every new action kind is rejected by the gate until its invariants exist
(ADR-0011 addendum). ADR-0013 'Battery as a controlled asset' is proposed and
must be accepted before WP10. STATUS, roadmap and the plan show Phase 4 / 4-A.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01VHXsfH6PkT62o9idByAd6e
Gaps in point series become None instead of invented values; the leftover P10
semantics give way to the risk quantile (conservative_planning removed); forecast
form keeps entities per source; tariff templates accept currency/MWh and mapping
series; effective_grid_charge_policy fixes the schedule precedence; §14a fee
windows per quarter; season of a window crossing midnight follows its start day;
tz is required; a formula on an all-in source is rejected; BatteryAction rejects
grid charging above its charge cap. Safety tests: battery decisions round-trip,
every driver refuses a BatteryAction, the gate rejects it for every origin, mode
and emergency-stop state. E2E reset helper uses goals v2.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01VHXsfH6PkT62o9idByAd6e
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01VHXsfH6PkT62o9idByAd6e
…romium for ubuntu 26.04)

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01VHXsfH6PkT62o9idByAd6e
(cherry picked from commit d9f2dc6)
Hypothesis found 2026-03-28 00:00 UTC with resume time 02:00: that wall time does
not exist in Berlin on the spring-forward day and correctly resolves to 03:00.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01VHXsfH6PkT62o9idByAd6e
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants