Die offene Spezifikation des kanonischen Energiemodells.

Fünf Regeln, an denen alles hängt.

• Eine kWh-Wahrheit. Jeder Verbrauch/jede Erzeugung als kanonischer Record; Compliance, FinOps und CO₂ rechnen auf derselben Quelle.
• Pflicht-Messwert ≠ Schätzung. Jeder Record trägt provenance. Software-/Modell-Schätzung (RAPL, Kepler, DCGM-abgeleitet) ist estimated und fließt nie in Meldewerte.
• Zwei Berechnungsprofile. legal-filing (statische Anlage-3-Normausgaben) und operational (aktuelle ISO/IEC). Werte werden nie zwischen Profilen wiederverwendet.
• Versioniert. Regelwerk, Emissionsfaktoren und Systemgrenzen sind versionierte Zeitreihen (valid_from/valid_to, legal_status).
• Marktrollen-neutral & lokal. Keine Cloud-Pflicht; Daten verlassen das RZ nicht.

Entitäten & Hierarchie.

Jeder Standort ist eine eigenständige Prüf-Einheit (eigenes Gebäude) — keine Aggregation über Gebäude hinweg. Messpunkte tragen ein Kategorie-Tag.

Organisation ─< Standort/RZ   // eigenes Gebäude = eigene Prüf-Einheit
                  ├─< Zone        // Whitespace, Facility, Abwärme
                  │     └─< Messpunkt (meter)
                  │            └─ Kategorie: IT | COOLING | UPS | TOTAL | REUSE | EE | GPU
                  └─< Asset       // Rack, PDU, USV, GPU-Node, Kältemaschine
                         └─ ref → Messpunkt

Der Datensatz.

Energie (energy_wh) ist die führende Größe; power_w ist abgeleitet/optional. Monotone Counter-Quellen (z. B. DCGM Field 156) werden via Differenzbildung in Intervall-Energie überführt; Reset/Treiber-Reload erzeugt quality:"gap_filled".

{
  "schema": "enerva.energy/v0.1",
  "site_id": "rz-hh-01",
  "meter_id": "nshv.total",
  "category": "TOTAL",        // IT|COOLING|UPS|TOTAL|REUSE|EE|GPU
  "ts_start": "2026-06-29T10:00:00Z",
  "interval_s": 900,          // 900 = 15-min; 60/1 = Betriebstelemetrie
  "energy_wh": 412350.0,     // Energie im Intervall (Wh) — primär
  "power_w": 1649400.0,     // optional: mittlere/akt. Leistung
  "provenance": "measured",   // measured|substituted|estimated
  "quality": "ok",            // ok|gap_filled|implausible|calibrating
  "source": "janitza.umg604.modbus",
  "boundary_version": "bg-2026.1"
}

Pflichtfelder: schema · site_id · meter_id · category · ts_start · interval_s · energy_wh · provenance · quality

Was darf gemeldet werden?

Die Trennlinie zwischen physischem Messwert und Schätzung ist die wichtigste Guardrail des Modells.

Versionierte Kennzahlen.

Jede KPI-Berechnung schreibt ins Calculation-Ledger: Eingangs-Summanden, verwendete Norm-Ausgabe, Boundary-Version, Profil und Ergebnis — reproduzierbar und prüfbar.

Schmal — drei Methoden.

Ein Adapter normalisiert eine Quellklasse auf Canonical Energy Records. Den Rest übernimmt der kanonische Kern.

class Adapter(Protocol):
    def discover(self) -> list[AssetDescriptor]: ...
        # [{asset_id, meter_id, category,
        #   unit, source, hints:{brick_tag}}]

    def read(self, since, until) -> Iterable[EnergyRecord]: ...
        # kanonische Records im Fenster (Pull)

    def subscribe(self, on_record) -> Subscription: ...
        # optional: Push/Stream (Live-Telemetrie)

Eingänge & Ausgänge.

5.1 Eingänge (Adapter)

5.2 Ausgänge (Outputs)

legal-filing vs. operational.

Zwei strikt getrennte Profile. Werte werden nie zwischen Profilen wiederverwendet.

Drei Konformitätsstufen.

Regelwerk-Profile (YAML) tragen valid_from und legal_status ∈ {geltend, entwurf, angekündigt}. Default = geltende §11-Werte; die Novelle existiert nur als Szenario-Profil. Emissionsfaktoren sind versionierte Zeitreihen (UBA korrigiert Vorjahre).