COM Zaehlstand ergänzen oder BO Energiemenge nutzen

[XaMa928]

Für unsere derzeitigen Anwendungsfälle ist es relevant, dass wir Zählerstände abbilden können.

Abbildung über BO Energiemenge
In #976 wird zur Abbildung von Zählerständen das BO Energiemenge und COM Verbrauch genutzt.
Dabei ist unserer Meinung nach das Wording "Verbrauch" für diesen Kontext nicht wirklich passend.
Das COM könnte bspw. in "Messwert" (o.ä.) umbenannt werden.

Zusätzlich handelt es sich bei Zählerständen um die Betrachtung zu einem Zeitpunkt.
Das könnte derzeit abgebildet werden über

"startdatum": "2025-03-14T13:33:37+02"
"enddatum": "2025-03-14T13:33:38+02"

Zur Abbildung eines einzelnen Zeitpunkts könnte entweder ein weiteres Attribut ergänzt werden oder in der Doku ergänzt werden, dass es sich um einen Zeitpunkt handetl, wenn das start/enddatum nicht gesetzt ist.

Neues COM Zaehlstand
Wenn gewünscht ist, dass das aktuelle COM Verbrauch nicht verallgemeinert wird könnte alternativ ein neues COM Zaehlstand eingeführt werden

obis_kennzahl: Optional[str]
wert: Optional[Decimal] = None
einheit: Optional["Mengeneinheit"] = None
messzeitpunkt: Optional[pydantic.AwareDatetime] = None
messwertstatus: Optional["Messwertstatus"] = None

Erweiterung BO Zaehler
Das BO Zaehler sollte im Anschluss idealerweise erweitert werden um entweder

zaehlstaende: Optional["Energiemenge"] = None

oder

zaehlstaende: Optional[list["Zaehlstand"]] = None

[hf-kklein]

Zum Verständnis: Warum könnte man nicht startzeitpunkt=endzeitpunkt machen?

[XaMa928]

In der derzeitigen Dokumentation heißt es für endzeitpunkt
"""Exklusives Ende des Zeitraumes, für den der Verbrauch angegeben wird"""

Streng genommen hätte somit startzeitpunkt = endzeitpunkt eine widersprüchliche Aussage.

Den Vorschlag finde ich persönlich gut, wenn entsprechend die Dokumentation erweitert wird

[XaMa928]

Öffne das Issue nochmal, da die Themen

• Ergänzung Zählerstände in Zähler
• Diskussion: Umbenennung COM Verbrauch zu Messwert
  noch ungeklärt sind