Skip to content

feat(frontend),docs: Phase 4 – PR 4-H Plan-Ansicht, Akku-Karte, Assistent und Nutzer-Doku - #34

Open
PXLJAKE wants to merge 17 commits into
phase-4/g-batteryfrom
phase-4/h-ui-docs
Open

PXLJAKE wants to merge 17 commits into
phase-4/g-batteryfrom
phase-4/h-ui-docs

Conversation

@PXLJAKE

@PXLJAKE PXLJAKE commented Oct 30, 2026

Copy link
Copy Markdown
Owner

Gestapelt auf #33 (PR 4-G). Enthält außerdem den Merge des 4-A-Branches mit der Annahme von ADR-0013. Das ist der letzte PR von Phase 4; die Basis wird nach dem Merge der Vorgänger umgestellt.

Was

WP11 – Oberfläche

  • Plan-Ansicht #/plan:
    • Diagramm: ECharts 5.6.0, eigener Chunk, wird erst beim Öffnen geladen. Drei Panels:
      • Leistung: PV P10–P90 mit P50, Grundlast, geplante Geräte, Akku, Netzbezug/-einspeisung
      • SoC mit den Linien für Morgenpuffer und Abendziel
      • Bezugs- und Einspeisepreis
    • Bedienung: Umschalter 24/48 h. Tooltip/Tap zeigt das „Warum?“ des Intervalls aus dem Katalog. Badges zeigen Solver/Heuristik/kein Plan, „veraltet“ und „Regelung folgt Plan“. Dazu Planer-Status und „Jetzt neu planen“ (entprellt).
    • Textalternative: Liste der nächsten Aktionen und eine Stundentabelle.
    • Die Zeiten folgen der Zeitzone der Region.
  • Prognosegüte: MAE und Bias je Quelle und Vorlauf, Gewichte im Mix, Kalibrierstatus. Ist Open-Meteo konfiguriert, erscheint die Nennung nach CC BY 4.0.
  • „Jetzt“-Ansicht:
    • Akku-Karte: Modus-Schalter mit Bestätigung und Identitäts-Token, gehaltene Grenzen, Pausengrund, letzte Entscheidung, Hinweis auf die Begrenzung auf „assistiert“. Akku-Vorschläge erscheinen wie Gerätevorschläge.
    • Nächste geplante Aktionen mit „Warum?“. Ist der Plan veraltet oder nicht in Gebrauch, erscheint ein Hinweis statt der Liste.
    • „Jetzt“ = Browser-Uhr plus Server-Versatz, aktualisiert jede Minute.
  • Assistent:
    • Schritt 4: mehrere PV-Quellen, Forecast.Solar-Eintrag mit Namen, Werktag-Sensor und Wetter-Entität
    • Schritt 5: Akku-Adapter oder „nur beobachten“, Modell, Strategie, Risikostufe, Morgenpuffer, Brücke zum nächsten Tag; Hinweise zur Kostal-Entität Battery:MinSoc und zum Modbus-Hub
    • Schritt 6: vollständiger HT/NT-Editor (jedes Fenster braucht einen Preis); Preisformel nur für Spotpreise
    • Schritt 8: Netzladen mit Preisgrenze und Zeitplan (standardmäßig aus) sowie Autarkie-Gewicht
    • Schritt 10: Vorschau des ersten Plans
  • Behobener Datenverlust: Tarif- und Prognoseformulare haben bisher role_entities, action_params, series_key, price_includes und config_entry_id verworfen. Eine gespeicherte Preisformel geht beim schnellen Speichern nicht mehr verloren. Beides ist mit Round-trip-Tests abgesichert.
  • Kleine additive Backend-Ergänzungen:
    • solar_forecast_entries und solar_forecast_labels in /wizard/energy-prefs
    • Rollen workday und weather
    • Demo-Schalter SUNCORE_DEMO_BATTERY_CONTROL (standardmäßig aus, nur im Demo-Pfad)

WP13 – Doku, Übersetzungen, STATUS

  • Neuer Leitfaden docs/user/{en,de}/planning-and-battery.md. Er erklärt Planer, Prognosen, Tarife, Risikostufe, Puffer/Ziel, Strategien, Netzladen, Akku-Modi und Freigabe. Dazu:
    • Kostal REST: Schritt für Schritt zum Aktivieren von Battery:MinSoc
    • Kostal Modbus: sicheres Messverfahren für den Rückfall-Timer
    • Fehlersuche und bekannte Grenzen
  • Aktualisiert: Schnellstart, Überschussregelung, App-DOCS.md, README, Architektur, Roadmap, STATUS (inklusive Merge-Reihenfolge).
  • Übersetzungen: en/de mit 1311 identischen Schlüsseln, keine hartkodierten Texte.

Warum

Exit-Kriterium von Phase 4: „Fahrplan mit Akku-Strategie und ‚Warum?‘ auf dem System des Maintainers“. Ohne Oberfläche und Doku ist das nicht nutzbar.

Wie getestet

  • Checks: ./scripts/check.sh grün: 4655 Python-Tests, Abdeckung 96 %, 275 Vitest-Tests. markdownlint ohne Fehler.

  • Playwright gegen die Demo: 237 bestanden, 0 fehlgeschlagen (144 Screenshot-Specs übersprungen), auf Desktop, Phone und Tablet. Geprüft werden:

    • Plan-Ansicht mit Begründungen und Tooltip, Neuplanen, 24/48 h
    • veralteter Plan
    • Akku-Moduswechsel mit Identität; ein veralteter Token wird vom Server abgelehnt
    • Assistent: Schritte 4/5/6/8/10 im Round-trip, „sofort speichern“ behält die Formel, ein Fenster ohne Preis blockiert
    • axe hell und dunkel auf allen neuen Ansichten
  • Bundle (gzip):

    Teil Größe Budget
    First Paint 119,1 kB 125 kB
    ECharts-Chunk (nur bei #/plan) 177,3 kB 200 kB
    Gesamt ohne ECharts 182,0 kB 250 kB
  • Screenshots: alle aus dem Demo-Modus, jede PNG unter 300 kB.

Screenshots (Demo-Modus)

Ansicht Englisch Deutsch
Plan (Tablet, hell) plan plan
Plan (Phone, dunkel) plan plan
Jetzt mit Akku-Karte now now
Assistent: Akku wizard wizard

Alle 24 Varianten (hell/dunkel, Phone/Tablet, en/de) liegen in docs/assets/screenshots/.

Risiken

  • Screenshots: Weil sich die Navigation geändert hat, wurden alle neu erzeugt. Große Bilder sind verkleinert und farbreduziert; die Phone-Ansichten sind dadurch etwas weniger scharf.
  • Nicht geprüft (UNVERIFIED): HA-Menünamen für deaktivierte Entitäten und der Modbus-Hub. Die Anleitung ist nicht an einem echten HA durchgeklickt.
  • Commit-Historie: enthält einen WIP-Sicherungscommit. Squash-Merge empfohlen.

Safety-Review

control-safety: Messverfahren für den Rückfall-Timer freigegeben mit Änderungen (R1–R7, eingearbeitet in 67439b4).

Die Anleitung misst den Hardware-Rückfall (§3.5, Register 1288) grundsätzlich richtig: Watchdog aus, App bleibt gestoppt, die Wiederherstellungszeile im Log liegt nach dem Rückfall. Der Code stimmt damit überein: Timer 60 s, Heartbeat 20 s, Rückfallregister = max(Modell, eigene Grenzen), vor dem ersten Limit gelesen; Begrenzung auf „assistiert“ bis fallback_measured.

Eingearbeitet:

  • Alle Gerätekarten vor dem Test auf Schatten. Ein per SIGKILL beendetes SunCore gibt nichts zurück und überwacht keine Bezugsgrenze.
  • docker kill ohne --signal, nie Stoppen oder Neustarten. Bei SIGTERM gibt SunCore den Akku frei, das täuscht einen Rückfall vor.
  • Test abends mit Hauslast über PV und ohne große Lasten. Die einzige mögliche Grenze ist eine volle Entladesperre (0 W).
  • Die Prüfung von 1288/1284/1286 erst nach dem ersten bestätigten Schreiben.
  • Erwartet 40–60 s nach dem Beenden plus ein Sensorschritt. Unter 35 s ist der Lauf ungültig.
  • Klare Wiederherstellung von Hand. fallback_measured bleibt bei jedem Fehlschlag false.
  • fallback_measured ist eine ungeprüfte Aussage des Nutzers und gilt nur für den gemessenen Timer, diesen Wechselrichter und diese Firmware.

Die deutsche Fassung ist gleichwertig. Code-Schreibpfade ändert dieser PR nicht; die Invarianten aus BRIEF §5 sind unberührt.

Folgeaufgabe (Code, eigener PR, S1): fallback_measured an den gemessenen fallback_timeout_s binden. Heute bleibt die Begrenzung auch nach einer späteren Timer-Erhöhung aufgehoben. Das braucht einen ADR-0013-Nachtrag und einen Gate-Test. Das Formular setzt den Wert bei einer Timer-Änderung schon jetzt zurück.

Checkliste

  • Tests für neues Verhalten, Lint/Typen/Tests grün
  • Keine hardcodierten UI-Strings; neue Keys in en und de
  • Doku aktualisiert (Nutzer-Leitfaden en/de, Schnellstart, DOCS.md, README, Roadmap); Screenshots aus dem Demo-Modus
  • docs/STATUS.md aktualisiert
  • Nichts erfunden; Offenes als UNVERIFIED

Offene Fragen an den Maintainer

Ohne Antwort gilt jeweils der Standard.

  1. Folgeaufgabe: Ein Schalter in der Oberfläche für „Rückfall gemessen“ (heute: Export → Datei bearbeiten → Import) und die Bindung an den Timer (S1). Standard: eigener PR nach Phase 4.

  2. Nicht in der Oberfläche:

    • Hinweis auf eine zu neue Zeitreihen-Datenbank
    • eigene Anzeige „Freigabe ausstehend“ auf der Akku-Karte
    • Bearbeiten von action_params/series_key (z. B. Nord Pool) und der Lern-Einstellungen

    Standard: Phase 5 (Expertenmodus).

  3. Kalibrierladung: nur ein Konfigurationsfeld, der Planer nutzt sie noch nicht (Roadmap ⬜). Standard: später.

  4. Nächste Schritte für dich (STATUS):

    1. Zuerst der Phase-3-Test im Schattenmodus.
    2. Danach Assistent → Plan im Schattenmodus beobachten → Kostal-Entität Battery:MinSoc aktivieren → Akku auf „assistiert“.
    3. Merge-Reihenfolge: feat(core): Phase 4 – PR 4-A Plan, Schnittstellenprüfung und Verträge #25 → feat(storage): Phase 4 – PR 4-B Zeitreihen-Datenbank, Statistik-Neuaufbau und Plan-Snapshots #26 → feat(tariff): Phase 4 – PR 4-C Tarif-Adapter, Preisformel und Preisdienst #27/feat(forecast): Phase 4 – PR 4-D PV-Prognose mit Gütemessung, Blending, Kalibrierung und Clipping #29 → feat(forecast): Phase 4 – PR 4-E Lastprognose und Risikomodell für Puffer und Ziele #30 → feat(planner): Phase 4 – PR 4-F HiGHS-Planer, Laufzeit alle 15 min und Übergabe an den Regler #31 → feat(safety,devices): Phase 4 – PR 4-G Akku-Steuerung über das Gate mit den Invarianten aus ADR-0013 #33 → dieser PR, jeweils Squash.

Generated by Claude Code

claude added 17 commits October 19, 2026 16:34
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01VHXsfH6PkT62o9idByAd6e
Brings the ADR-0013 acceptance and the maintainer's default answers into the stack.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01VHXsfH6PkT62o9idByAd6e
Plan view with on-demand ECharts, next planned actions, battery card with mode switch,
forecast accuracy panel; demo battery control flag, energy prefs solar forecast entries,
workday and weather site roles.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01VHXsfH6PkT62o9idByAd6e
Snapshot so nothing is lost when the usage limit stops the session; not yet checked.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01VHXsfH6PkT62o9idByAd6e
…eps, STATUS and plan notes (WP11)

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01VHXsfH6PkT62o9idByAd6e
… step (WP11)

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01VHXsfH6PkT62o9idByAd6e
…t and status (WP13)

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
…every window, reset fallback, label entries (WP11 review)

- tariff: the formula is only dropped when the source is certainly an end price
- plan store: now = browser clock + server offset on a minute tick, refetch after reconnect,
  Now view says when the plan is stale or not followed
- HT/NT periods and fee windows need a price; a changed adapter, link or timer resets
  fallback_measured in the form
- chart and table show the planned devices; Forecast.Solar entries show labels from the device
  registry and a saved id stays visible; times use the Home Assistant time zone
- BatteryCard: only real capabilities, no unreachable cap_generic key

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

PXLJAKE commented Oct 30, 2026

Copy link
Copy Markdown
Owner Author

Der Check Frontend ist rot, aber nicht wegen dieses PRs. Build, Vitest und Bundle-Budgets waren grün (119,9 kB First Paint). Fehlgeschlagen ist erst npx playwright install --with-deps chromium:

Playwright does not support chromium on ubuntu26.04-x64

GitHub hat ubuntu-latest auf Ubuntu 26.04 umgestellt, und Playwright 1.56.1 hat dafür kein Chromium. Dasselbe würde jeden anderen PR treffen, dessen Frontend-Job neu läuft.

Behoben, indem der Frontend-Job auf ubuntu-24.04 festgelegt ist:

Damit wird das Problem schon mit dem ersten Merge behoben. Ein Playwright-Update kann später als eigener PR folgen.


Generated by Claude Code

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