123 lines
5.3 KiB
Markdown
123 lines
5.3 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 | 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](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`.
|
|
|
|
### 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
|
|
|
|
```markdown
|
|
### OP-NNN: Kurztitel
|
|
|
|
- **Entscheidungsfrage:** Welche konkrete Entscheidung muss das Team treffen?
|
|
- **Verantwortlich:** Offen
|
|
- **Ziel-Sprint:** Offen
|
|
- **Ergebnis/Verweis:** Offen
|
|
```
|