UC03 – Offene Punkte und Restentscheidungen¶

Stand: 01.08.2026 14:55 Branch: docs/einheitliche-kopfbereiche Status: Arbeitsliste für spätere Detailentscheidungen

Datum, Uhrzeit	Version	Änderung	Autor
01.08.2026 14:55	1.0	Kopfbereich vereinheitlicht	David Mittig

Use Case: UC03 – Füll-Abo & Füllkarten-Verwaltung
Dokumenttyp: konsolidierte offene Punkte

1. Zweck¶

Dieses Dokument sammelt offene Punkte aus der UC03-Spezifikation, der Self-Service-Ergänzung und den Screen-Vorgaben FA-01 bis FA-15.

Die Liste dient dazu, offene fachliche, technische und UI-bezogene Restentscheidungen nicht in einzelnen Screen-Dokumenten zu verlieren.

ID	Thema	Entscheidung / Status
OP-RR1	Mitarbeiter darf neues Füllkonto anlegen	entschieden: Ja
OP-RR2	Mitarbeiter darf Buchung stornieren	entschieden: Ja, mit Pflichtgrund, Datum/Zeit und User-Stempel
OP-RR3	Korrekturfreigabe durch tenant_admin	entschieden: Nein für V1
OP-RR4	Rolle `fill_manager`	V3 im Hinterkopf behalten
OP-RR5	Mitarbeiter darf Self-Service aktivieren	offen
OP-RR6	Mitarbeiter darf QR-Code / Abrufcode erneuern	offen
OP-RR7	Mitarbeiter darf Zahlungsstatus `paid` setzen	offen, fachlich naheliegend

ID	Thema	Entscheidung / Status
OP-NX1	Nitrox als Gasart	entschieden: Ja
OP-NX2	Nitrox 32 / 36 / 40	entschieden: als Standardvarianten vorbereiten
OP-NX3	FO₂ Pflichtfeld	entschieden: optional erfassbar
OP-NX4	Analysebestätigung Pflicht	entschieden: optional erfassbar
OP-NX5	Analyse durch Mitarbeiter oder Kunde	entschieden: beide möglich, Name und Zeitpunkt nachvollziehbar
OP-NX6	Mitarbeiter- und Kundenanalyse nacheinander	entschieden: möglich
OP-NX7	Analysezeitpunkt	entschieden: speichern, wenn Analyse erfasst wird
OP-NX8	Verantwortungsbestätigung	offen / für V1 nicht zwingend
OP-NX9	konkrete Punktewerte für Nitrox 32 / 36 / 40	offen

ID	Thema	Entscheidung / Status
OP-PV1	Punktewerte tenant-spezifisch	entschieden: Ja
OP-PV2	System-Standardwerte	entschieden: Luft 21 % mit Standardwert, Nitrox je Prozentwert vorbereiten
OP-PV3	manuelle Übersteuerung durch Mitarbeiter	entschieden: Ja, nur Mitarbeiter
OP-PV4	Pflichtgrund bei Übersteuerung	entschieden: Ja, inkl. Datum/Zeit und User-Stempel
OP-PV5	Punkteverbrauch pro Gasart oder Produktvorlage	entschieden: V1 pro Gasart / Nitrox-Variante; V2/V3 optional pro Produktvorlage
OP-PQ1	V1-Produktvorlagen	entschieden: 10er-Karte Luft, 10+3 Bonuskarte Luft, Einzel-Füllung Luft
OP-PQ2	Produktvorlagen tenant-spezifisch anpassbar	entschieden: Ja
OP-PQ3	eigene Kartenmodelle durch Tenant	V2/V3 prüfen
OP-PQ4	Bonusmodell hart 10+3 oder allgemein	entschieden: allgemein konfigurierbar
OP-PQ5	Preise informativ oder vollständig	entschieden: V1 nur informativ

ID	Thema	Entscheidung / Status
OP-LQ1	`current_balance` Aktualisierung	entschieden: bei jeder Buchung synchron aktualisieren
OP-LQ2	Transaktionsstrategie	entschieden: Online-Buchungen mit DB-Transaktion und Row Lock
OP-LQ3	Punkte Integer oder Decimal	entschieden: ganze Zahlen für V1
OP-LQ4	Constraint `initial_balance = paid_units + bonus_units`	entschieden: Anwendung prüft; DB-Constraint prüfen, aber nicht zwingend sofort
OP-LQ5	Fehlerhafter synchronisierter Ledger-Eintrag	entschieden: nicht ändern, nur `reverse` oder `correction`
OP-LQ6	parallele Saldoänderung im UI visualisieren	offen
OP-LQ7	Beleg / Quittung nach Buchung	nicht V1

ID	Thema	Entscheidung / Status
OP-OQ1	Offline buchen bei 1 Einheit Restguthaben	entschieden: nur bis verfügbares Guthaben inkl. Vormerkungen
OP-OQ2	Offline-Verbrauch direkt abziehen oder vormerken	entschieden: vormerken; direkter Abzug nur bei Online-Prüfung
OP-OQ3	Sync-Konflikte lösen	entschieden: Mitarbeiter und/oder tenant_admin
OP-OQ4	automatische Gegenbuchung bei Konflikt	entschieden: Nein; System darf Vorschlag machen, Benutzer bestätigt
OP-OQ5	Warnhinweis bei `pending_sync`	entschieden: Ja, praktisch sichtbar im UI
OP-OQ6	Korrektur / Storno offline	entschieden: V1 gesperrt
OP-OQ7	konkrete Konfliktpriorisierung	offen

ID	Thema	Entscheidung / Status
OP-SS1	Self-Service-Füllabruf in V1	entschieden: Ja
OP-SS2	Kundeninitiierter Abruf	entschieden: Ja
OP-SS3	digitale Füllkarte	vorbereitet über FA-11
OP-SS4	Mitarbeiterbestätigung	V1-Standard empfohlen, tenant-spezifisch konfigurierbar
OP-SS5	direkter Self-Service ohne Mitarbeiterbestätigung	optional, sicherheitlich prüfen
OP-SS6	QR-Code gegen Missbrauch schützen	offen, Sicherheitskonzept erforderlich
OP-SS7	Kunde sieht reduzierte Historie	entschieden: Ja
OP-SS8	Benachrichtigung bei niedrigem Guthaben	späterer Bezug zu UC07

ID	Thema	Entscheidung / Status
OP-UI1	FA-01 Tabelle oder Kartenansicht	Vorschlag: Tabelle mit Status-Badges
OP-UI2	abgelaufene Karten standardmässig ausblenden	Vorschlag: Ja, über Filter / Historie erreichbar
OP-UI3	QR-Code direkt in Liste oder Detail	Vorschlag: Aktion in Zeile, Anzeige in FA-03 / FA-11
OP-UI4	anonyme Einzel-Füllung	offen
OP-UI5	QR-Code-Scan direkt in FA-05 oder Dialog	offen
OP-UI6	Export Kundenhistorie	später prüfen
OP-UI7	grafische Saldoentwicklung	Vorschlag: später einfache Kurve / Balken
OP-UI8	Hinweisdialog vor Storno / Korrektur	Vorschlag: Ja

Priorität	Punkte
Vor technischer Umsetzung klären	OP-LQ2, OP-LQ4, OP-LQ5, OP-OQ2, OP-OQ4, OP-SS6
Vor UI-Implementierung klären	OP-UI1, OP-UI3, OP-UI5, OP-SS4
Kann in V1-light bleiben	OP-UI6, OP-UI7, OP-RR4, OP-PQ3
Später / V2/V3	eigene Kartenmodelle, Rolle fill_manager, direkte Self-Service-Buchung ohne Bestätigung

Die wesentlichen UC03-Grundentscheidungen sind getroffen.

Die verbleibenden Punkte betreffen vor allem: