Files
Enelix-EMS/docs/Offene-Punkte.md
T
2026-09-22 14:43:36 +00:00

127 lines
5.5 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 | Erledigt | 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-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)
### 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`.
## Vorlage fuer neue Punkte
```markdown
### OP-NNN: Kurztitel
- **Entscheidungsfrage:** Welche konkrete Entscheidung muss das Team treffen?
- **Verantwortlich:** Offen
- **Ziel-Sprint:** Offen
- **Ergebnis/Verweis:** Offen
```