# V4: native Betriebsdaten, ausschliesslich Schattenbetrieb

Stand 2026-10-01: Der optionale Sender und die Diagnose sind implementiert.
Kein V4-Plan wird damit uebernommen, kein Aktor geschrieben, kein V1-Sollwert
geaendert. Der Sender ist nach Installation standardmaessig AUS.

## Konfiguration im Manager

- NetzfahrplanV4SchattenAktiv: bool, Standard false. Eigener 60-s-Timer,
  unabhaengig vom bestehenden Prognose-Timer. Fehler betreffen nur den Sendestatus.
- NetzfahrplanV4NetzladenErlaubt: bool, Standard false. Betrifft ausschliesslich
  die im Schattenplan angenommene Berechtigung, keine reale Netzladefreigabe.
- NetzfahrplanV4BatterieOptionen: JSON-Objekt je Topologie-ID. Optional
  SOCKapazitaet_kWh und MaxSOC_Prozent (sonst 100). Bei unterschiedlicher Nenn-
  und Nutzkapazitaet ist SOCKapazitaet_kWh zwingend explizit anzugeben.
- NetzfahrplanV4BezugszaehlerQuellen: JSON-Liste, Standard []. Eigene, explizite
  Wirkenergie-Bezugsquellen fuer V4; KEIN Rueckfall auf den Altzaehler.
  Details und Lihrenmoos-Kandidat: Netzfahrplan-V4-Bezugszaehler.md.
- NetzfahrplanV4MessnachweisVariableID: JSON-Stringvariable, Standard 0.
  Ein vollstaendiger historischer/registerbasierter Messnachweis-Produzent
  ist NOCH NICHT integriert. Fehlende Nachweise bleiben fehlend.

Die Quelle muss der gemeinsame Netzanschluss sein. Topologiebatterien werden
nur einer eindeutigen aktiven Batterieinstanz mit derselben SOC- UND
Leistungsmessquelle zugeordnet. Externe SDL-Batterien werden nicht automatisch
hinzugefuegt. SDL-/Grundlastbereinigung bleibt eine separate, noch offene Aufgabe.
BMS-Grenzen werden mit Topologieleistungen begrenzt. Normale Betriebsreserve
und technisches Minimum werden nicht verwechselt: die hoehere Grenze gilt.

Bei aktueller Entladehysterese wird die Entladeleistung konservativ auf 0
begrenzt. Eine spaetere Freigabe innerhalb der 48h wird noch nicht modelliert.
Das ist sichtbar diagnostiziert und kann den Schattenplan wirtschaftlich
beschraenken; eine zeitabhaengige Hysterese-Modellierung bleibt offen.
SOC unterhalb der Reserve wird nicht kuenstlich angehoben: Diagnosefehler,
kein angeblich gueltiger Plan. Recovery-/Nachladungsmodell bleibt offen.

## Diagnose ohne Netzwerk oder Stellbefehl

Im Symcon-Skript nach Installation des neuen Modulstands:

```php
<?php
print_r(json_decode(ENELIX_GetNetzfahrplanV4Diagnose(17004), true));
echo ENELIX_GetNetzfahrplanV4Sendestatus(17004);
```

Die Diagnose enthaelt KEINE Tokens oder sonstigen Zugangsdaten. Sie ist auch
bei ausgeschaltetem Sender verfuegbar. Die Instanz-ID ist fuer Lihrenmoos aus
der bestehenden Konfiguration bekannt, nicht fuer andere Anlagen zu kopieren.
Nicht ungeprueft deployen: Host-CLI- und Zielsystemtests getrennt nachweisen.

## Messnachweis-Vertrag (Beispiel, KEINE realen Messwerte)

```json
{
  "version": 1,
  "meterId": "symcon-active-import:<SHA256-der-konfigurierten-Quellen>",
  "measuredAt": "2026-10-01T12:05:00Z",
  "measuredPeaks": {
    "2026-10": {"kw": 18.4, "source": "meter_month_register"}
  },
  "quarterPast": {
    "start": "2026-10-01T12:00:00Z",
    "measuredSeconds": 300,
    "importKwh": 0.5
  }
}
```

Zulaessige Herkunft: meter_month_register, verified_month_history oder
verified_new_month. Der Nachweis-Produzent muss deren Wahrheit garantieren.
Managergrenzen sind NIE ein gemessener Monatspeak. Der Monatswert muss den
vollstaendigen bisherigen Abrechnungsmonat abdecken. Fuer quarterPast muessen
Zaehlerzeitpunkt, abgedeckte Sekunden und Entscheidungszeitpunkt exakt passen;
veraltete Energie wird nicht hochgerechnet oder als aktuelle Messung ausgegeben.
Die kumulative kWh-Variable allein erfuellt diesen Vertrag noch nicht.

Die V4-API meldet bei fehlendem Monatspeak/quarterPast weiterhin awaiting_inputs.
Ein HTTP stored bestaetigt nur den Eingang der Telemetrie, nicht einen gueltigen
Fahrplan und schon gar nicht dessen Ausfuehrung. Backend und Portal-Bruecke
muessen separat aktiviert werden. Keine neue Modellwahl oder Aktorfreigabe hier.

## Tests

24 offline Konvertierungsszenarien und 20 Quellen-/Summen-Szenarien sowie PHPUnit-Strukturpruefungen. Werte sind
synthetisch; keine reale HTTP-Anbindung oder Symcon-Laufzeit damit behauptet.