Enelix-EMS/docs/Offene-Punkte.md

Offene Punkte

Diese Datei ist die zentrale, repositoryuebergreifende Liste fuer Themen, die das Enelix-Team noch entscheiden muss. Sie dient als Arbeitsgrundlage fuer Sprintmeetings. Modulinterne Implementierungsdetails bleiben in der jeweiligen Moduldokumentation.

Arbeitsweise

• Neue Punkte erhalten fortlaufende IDs im Format OP-001.
• Erlaubte Status sind Offen, In Klaerung, Entschieden und Zurueckgestellt.
• Ein Eintrag beschreibt die konkrete Entscheidungsfrage, nicht nur ein Stichwort.
• Entscheidungen bleiben in dieser Datei erhalten und verweisen auf ADR, Issue oder Commit.
• Neue Punkte werden standardmaessig ohne Verantwortlichen und Ziel-Sprint erfasst.
• Im Sprintmeeting werden Status, Verantwortlicher und Ziel-Sprint gepflegt.

Aufnahmeschranke fuer offene Punkte und Issues

Ein neuer Eintrag wird nur angelegt, wenn er konkret, abgrenzbar und pruefbar ist.

• Eine offene Entscheidung nennt eine konkrete Entscheidungsfrage, ihren Kontext und die Auswirkung der Entscheidung.
• Ein Bug beschreibt betroffenes Verhalten, Ist- und Sollzustand sowie eine nachvollziehbare Ausloesung.
• Ein Feature oder Task nennt Anwendungsfall, Ausloeser oder Eingabe, erwartetes Verhalten und ein pruefbares Ergebnis.
• Ein Eintrag behandelt genau ein zusammenhaengendes Thema und kann unabhaengig umgesetzt oder entschieden werden.
• Zu grosse oder gebuendelte Anforderungen werden vor der Aufnahme in kleinere, einzeln pruefbare Punkte zerlegt.

Abstrakte Ziele, Visionen und Loesungsideen ohne konkretes Verhalten werden nicht aufgenommen. Die Rueckmeldung lautet in diesem Fall sinngemaess:

Nicht aufgenommen: Der Punkt ist noch zu abstrakt. Bitte in konkrete, einzeln ausfuehrbare und pruefbare Probleme, Entscheidungen oder Schritte unterteilen.

Beispiel fuer einen ausreichend konkreten Ausgangspunkt:

Die Temperatureinheit des Boilers kann zwischen Celsius und Fahrenheit eingestellt werden; Anzeige und Grenzwerte verwenden die gewaehlte Einheit.

Beispiel fuer einen noch zu abstrakten Punkt:

Der Manager soll aufgrund einer Prognose regeln.

Hier fehlen unter anderem Prognoseart, geregelte Verbraucher, konkretes Regelziel, Prioritaeten, Fehlerverhalten und ein pruefbares Ergebnis.

Uebersicht

ID	Status	Bereich	Kurzthema
OP-001	Entschieden	Lizenzierung	Betriebsort des Lizenzservers
OP-002	Erledigt	Grundeinrichtung	Generator und kostenpflichtige Ersteinrichtung
OP-003	Offen	Lizenzportal	VGT-Integration in license.enelix.ch
OP-004	Entschieden	Lizenzierung	Lizenzmodell des Verbrauchskostenreports
OP-005	Offen	Teststrategie	Standort fuer Feldtests

Offene Punkte

OP-003: VGT-Integration in license.enelix.ch

• Entscheidungsfrage: Soll die VGT-Anwendung als Bestandteil in die Oberflaeche von license.enelix.ch integriert werden?
• Kontext: Zu klaeren ist, ob die VGT-Anwendung innerhalb der Oberflaeche von license.enelix.ch oder getrennt davon bereitgestellt wird.
• Auswirkung: Die Entscheidung legt fest, ob die VGT-Anwendung Teil dieser Oberflaeche oder eine eigenstaendige Anwendung bleibt.
• Verantwortlich: Offen
• Ziel-Sprint: Offen
• Ergebnis/Verweis: Offen

OP-005: Standort fuer Feldtests

• Entscheidungsfrage: An welchem Standort koennen die Module aus Enelix EMS und Enelix Utils unter realen Einsatzbedingungen getestet werden?
• Kontext: Fuer die Module aus beiden Repositories soll ein geeigneter Standort fuer Feldtests festgelegt werden.
• Auswirkung: Die Entscheidung legt fest, wo die praktische Validierung der Module unter realen Einsatzbedingungen stattfindet.
• Verantwortlich: Offen
• Ziel-Sprint: Offen
• Ergebnis/Verweis: Offen

Entschiedene Punkte

OP-001: Betriebsort des Lizenzservers

• Entscheidung: Der Entwicklungs-Lizenzdienst wird unter https://license.enelix.ch betrieben.
• Manager-Endpunkt: POST /api/v1/licenses/activate
• Ergebnis/Verweis: Obere Anschluesse und Manager

OP-002: Generator und kostenpflichtige Ersteinrichtung

• Entscheidung: Der automatische Systemgenerator und die kostenpflichtige Ersteinrichtung sind derselbe Vorgang.
• Abrechnung: Eine Bestellung aus dem Systemkonfigurator enthaelt automatisch die noch nicht bezahlten Einrichtungskosten fuer den Manager und die konfigurierten Verbrauchermodule. Bereits bezahlte Einrichtungsmengen werden je Anlage angerechnet. Direkte Lizenzbestellungen enthalten keine Einrichtungskosten.
• Status: Erledigt
• Ergebnis/Verweis: Umsetzung im Lizenzportal unter https://license.enelix.ch.

OP-004: Lizenzmodell des Verbrauchskostenreports

• Entscheidung: Der Verbrauchskostenreport verwendet eine Grundlizenz sowie getrennte Kontingente fuer Stromzaehler und Nebenzaehler. Die Anzahl der konfigurierten Zaehler wird bei der Lizenzpruefung beruecksichtigt.
• Status: Entschieden und implementiert
• Ergebnis/Verweis: Enelix Utils, Commit 1f945be und Verbrauchskostenreport/module.php.

Vorlage fuer neue Punkte

### OP-NNN: Kurztitel

- **Entscheidungsfrage:** Welche konkrete Entscheidung muss das Team treffen?
- **Verantwortlich:** Offen
- **Ziel-Sprint:** Offen
- **Ergebnis/Verweis:** Offen