Files
Enelix-EMS/docs/Offene-Punkte.md
T
dh e6516f5d7a
Tests / test (push) Successful in 43s
docs: add field-test location decision
2026-09-22 05:17:58 +00:00

126 lines
5.4 KiB
Markdown

# 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 | Offen | Grundeinrichtung | Generator und kostenpflichtige Ersteinrichtung |
| OP-003 | Offen | Lizenzportal | VGT-Integration in license.enelix.ch |
| OP-004 | Offen | Lizenzierung | Lizenzmodell des Verbrauchskostenreports |
| OP-005 | Offen | Teststrategie | Standort fuer Feldtests |
## Offene Punkte
### OP-002: Generator und kostenpflichtige Ersteinrichtung
- **Entscheidungsfrage:** Soll der automatische Generator fuer die
Grundeinrichtung zugleich die kostenpflichtige Ersteinrichtung abbilden?
- **Kontext:** Der vorgesehene automatische Generator fuer die Grundeinrichtung
muss gegenueber der kostenpflichtigen Ersteinrichtung abgegrenzt werden.
- **Auswirkung:** Die Entscheidung legt fest, ob beide als derselbe Vorgang oder
als getrennte Leistungen behandelt werden.
- **Verantwortlich:** Offen
- **Ziel-Sprint:** Offen
- **Ergebnis/Verweis:** Offen
### 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-004: Lizenzmodell des Verbrauchskostenreports
- **Entscheidungsfrage:** Soll der Verbrauchskostenreport nach dem Lizenzmodell
des Managers oder mit einer einzigen, von der Anzahl angeschlossener Zaehler
unabhaengigen Modullizenz angeboten werden?
- **Kontext:** Fuer den Verbrauchskostenreport muss zwischen dem Lizenzmodell des
Managers und einer zaehlerunabhaengigen Modullizenz entschieden werden.
- **Auswirkung:** Die Entscheidung legt fest, ob die Anzahl angeschlossener
Zaehler den Lizenzumfang des Verbrauchskostenreports beeinflusst.
- **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](Obere-Anschluesse.md) und
[Manager](module/Manager/README.md)
## Vorlage fuer neue Punkte
```markdown
### OP-NNN: Kurztitel
- **Entscheidungsfrage:** Welche konkrete Entscheidung muss das Team treffen?
- **Verantwortlich:** Offen
- **Ziel-Sprint:** Offen
- **Ergebnis/Verweis:** Offen
```