71 lines
2.9 KiB
Markdown
71 lines
2.9 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 |
|
|
|
|
## 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
|
|
```
|