FA-03 – Füllkarte / Abo verwalten
Stand: 12.10.2026 11:23
Branch: main
Status: erster Vorschlag
Änderungshistorie anzeigen
Use Case: UC03 – Füll-Abo & Füllkarten-Verwaltung
Screen: FA-03
Wireframe
Zum Vergrössern auf das Bild klicken; es öffnet sich in voller Grösse.
1. Zweck
FA-03 ist die Detail- und Verwaltungsansicht eines bestehenden Füllkontos. Ein Füllkonto kann fachlich eine Füllkarte, Bonuskarte, Punktekarte oder ein Abo sein.
Der Screen zeigt Stammdaten, Restguthaben, Status, Self-Service-Einstellungen, Zahlungsinformation und die wichtigsten Aktionen. Von hier aus können Mitarbeiter Füllungen buchen, Historien öffnen, Self-Service verwalten oder eine Sperre / Korrektur vorbereiten.
2. Primäre Nutzer
| Rolle |
Nutzung |
mitarbeiter |
prüft Guthaben, bucht Füllungen, sieht Status und Historie |
tenant_admin |
verwaltet Status, Sperren, Bonus, Korrekturen und erweiterte Einstellungen |
kunde |
nicht direkt in dieser internen Ansicht; Kundenansicht folgt in FA-11 |
3. Einstieg / Auslöser
| Einstieg |
Beschreibung |
| FA-01 |
Aktion Öffnen auf einer Karte / einem Abo |
| FA-02 |
nach dem Anlegen eines neuen Füllkontos |
| FA-04 |
Rücksprung nach einem Füllvorgang |
| FA-08 / FA-09 |
aus Historienansichten zurück zum Füllkonto |
| FA-12 |
aus einem offenen Self-Service-Abruf zum betroffenen Füllkonto |
4.1 Kopfbereich
| Information |
Beschreibung |
| Titel |
z. B. 10+3 Bonuskarte Luft |
| Kunde |
Name des Kunden |
| Status |
aktiv, leer, gesperrt, abgelaufen, Konflikt |
| Schnellaktionen |
Füllung buchen, Historie, QR-Code, Storno / Korrektur |
4.2 Stammdaten des Füllkontos
| Feld |
Beschreibung |
| Füllkonto-ID |
technische Referenz / UUID, intern |
| Modell |
Karte, Bonuskarte, Punktekarte, Abo |
| Produktvorlage |
z. B. 10+3 Bonuskarte Luft |
| Gasbereich |
Luft, Nitrox, gemischt |
| Einheit |
Füllungen oder Punkte |
| gültig ab |
Startdatum |
| gültig bis |
Ablaufdatum, falls vorhanden |
| erstellt von |
Benutzer |
| erstellt am |
Zeitpunkt |
4.3 Guthaben und Bonus
| Feld |
Beschreibung |
| bezahlte Einheiten |
z. B. 10 |
| Bonus-Einheiten |
z. B. 3 |
| Startguthaben |
z. B. 13 |
| aktuelles Restguthaben |
z. B. 8 / 13 |
| letzte Buchung |
Zeitpunkt und Art der letzten Buchung |
| Guthabenstatus |
ausreichend, niedrig, leer, Konflikt |
Regel:
current_balance darf nur über Ledger-Buchungen verändert werden.
4.4 Self-Service
| Feld |
Beschreibung |
| Self-Service aktiv |
Kunde kann Füllkonto digital anzeigen oder Abruf starten |
| Mitarbeiterbestätigung erforderlich |
sicherer Standard in V1 |
| digitale Karte |
vorbereitet / aktiv |
| QR-Code / Abrufcode |
anzeigen, erneuern oder deaktivieren |
| letzter Self-Service-Abruf |
Zeitpunkt des letzten Abrufs |
| Feld |
Beschreibung |
| Zahlungsstatus |
unbekannt, offen, bezahlt, teilweise bezahlt |
| bezahlt am |
Zeitpunkt der Zahlungsbestätigung |
| Zahlungsart-Hinweis |
z. B. Bar, Karte, Überweisung, externes Kassensystem |
| Zahlung bestätigt durch |
Benutzer |
| Zahlungsnotiz |
freie Bemerkung |
Hinweis:
Diese Zahlungsinformationen sind in V1 nur informativ.
Es gibt keine vollständige Preis-, Zahlungs-, Steuer- oder Rechnungslogik.
5. Eingaben / Aktionen
| Aktion |
Beschreibung |
| Füllung buchen |
öffnet FA-07 mit vorausgewähltem Füllkonto |
| Historie anzeigen |
öffnet FA-09 |
| Kundehistorie anzeigen |
öffnet FA-08 |
| QR-Code / digitale Karte anzeigen |
öffnet FA-11 oder zeigt Detailpanel |
| Self-Service aktivieren / deaktivieren |
ändert Self-Service-Status |
| Mitarbeiterbestätigung ein / aus |
konfiguriert Freigaberegel |
| Füllkonto sperren |
nur berechtigte Rolle |
| Füllkonto reaktivieren |
nur berechtigte Rolle |
| Korrektur / Storno starten |
öffnet FA-10 |
| Zahlungsstatus aktualisieren |
optionale V1-Information pflegen |
6. Validierungen / Regeln
| ID |
Regel |
| FA03-R01 |
Gesperrte Füllkonten dürfen nicht für neue Buchungen genutzt werden |
| FA03-R02 |
Leere Füllkonten dürfen nicht weiter verbraucht werden |
| FA03-R03 |
current_balance darf nicht direkt manuell geändert werden |
| FA03-R04 |
Korrekturen laufen über Ledger-Einträge correction oder reverse |
| FA03-R05 |
Storno und Korrektur benötigen Pflichtgrund, Datum/Zeit und User-Stempel |
| FA03-R06 |
QR-Code darf keine ungeschützte direkte Buchung ermöglichen |
| FA03-R07 |
Bei pending_sync müssen neue Kundenabbuchungen gesperrt werden |
| FA03-R08 |
Bei conflict muss eine Prüfung vor weiterer Nutzung erfolgen |
| FA03-R09 |
Zahlungsinformationen sind optional und nicht abrechnungsführend |
7. Status- und Fehlermeldungen
| Situation |
Meldung / Darstellung |
| Füllkonto aktiv |
Badge „aktiv“ |
| Guthaben niedrig |
Hinweis „Restguthaben niedrig“ |
| Guthaben leer |
Badge „leer“ und Buchungsaktion gesperrt |
| Füllkonto gesperrt |
rotes Badge „gesperrt“ |
| Konflikt vorhanden |
rotes Banner „Konflikt prüfen“ |
| pending_sync vorhanden |
gelber Hinweis „Nicht synchronisierte Buchungen vorhanden“ |
| Self-Service aktiv |
Badge „Self-Service aktiv“ |
| Mitarbeiterbestätigung aktiv |
Badge „Bestätigung nötig“ |
8. Bezug zu Datenmodell / Ledger
| Bereich |
Bezug |
| Füllkonto |
fill_accounts |
| Restguthaben |
current_balance, aus Ledger rekonstruierbar |
| bezahlte Einheiten |
paid_units |
| Bonus-Einheiten |
bonus_units |
| Startguthaben |
initial_balance |
| Ledger |
fill_ledger_entries |
| Self-Service |
self_service_enabled, requires_staff_confirmation |
| QR-Code / Token |
access_token_hash, access_token_expires_at oder spätere Token-Tabelle |
| Zahlung |
payment_status, paid_at, payment_confirmed_by, payment_note |
9. Self-Service-Bezug
FA-03 ist die interne Verwaltungsstelle für Self-Service-Einstellungen eines Füllkontos.
| Funktion |
Bedeutung |
| digitale Karte anzeigen |
Vorschau der Kundenkarte |
| QR-Code anzeigen |
Abrufcode für Kunden oder Mitarbeiter |
| Abrufcode erneuern |
Sicherheitsmassnahme bei Verdacht auf Weitergabe |
| Mitarbeiterbestätigung erzwingen |
sicherer Standard für V1 |
| Self-Service deaktivieren |
falls Karte gesperrt, leer oder konfliktbehaftet ist |
10. Akzeptanzkriterien
| ID |
Kriterium |
| FA03-AC01 |
Mitarbeiter kann ein bestehendes Füllkonto öffnen |
| FA03-AC02 |
Mitarbeiter sieht Kunde, Modell, Gasbereich, Gültigkeit und Status |
| FA03-AC03 |
Mitarbeiter sieht bezahlte Einheiten, Bonus-Einheiten und Restguthaben |
| FA03-AC04 |
Mitarbeiter kann eine Füllung aus dem Füllkonto heraus starten |
| FA03-AC05 |
Mitarbeiter kann die Füllkonto-Historie öffnen |
| FA03-AC06 |
Mitarbeiter erkennt Self-Service-Status und Bestätigungsregel |
| FA03-AC07 |
Mitarbeiter kann digitale Karte / QR-Code öffnen |
| FA03-AC08 |
Storno / Korrektur ist nur über FA-10 möglich |
| FA03-AC09 |
Bei Konflikt oder pending_sync wird eine deutliche Warnung angezeigt |
| FA03-AC10 |
Zahlungsinformationen werden als informative V1-Angaben angezeigt |
11. Offene Punkte
| ID |
Frage |
Status |
| FA03-O01 |
Darf ein Mitarbeiter Self-Service selbst aktivieren oder nur tenant_admin? |
offen |
| FA03-O02 |
Darf ein Mitarbeiter QR-Code / Abrufcode erneuern? |
offen |
| FA03-O03 |
Wird Zahlungsstatus durch Mitarbeiter gepflegt oder nur tenant_admin? |
offen |
| FA03-O04 |
Soll Sperren / Reaktivieren in FA-03 direkt möglich sein oder über separaten Dialog? |
offen |
Änderungshistorie
| Datum, Uhrzeit |
Version |
Änderung |
Autor |
| 12.10.2026 11:23 |
1.3 |
Abschnitt «Wireframe» mit klickbarem Bild des Screens ergänzt |
Claude |
| 12.10.2026 09:58 |
1.2 |
Änderungshistorie ans Dokumentende verschoben und Sprunglink «Änderungshistorie anzeigen» unter dem Kopf ergänzt (einheitlicher Dokumentaufbau gemäss AGENTS.md) |
Claude |
| 12.10.2026 09:08 |
1.1 |
Branch-Angabe im Kopfbereich auf main korrigiert |
Claude |
| 01.08.2026 14:55 |
1.0 |
Kopfbereich vereinheitlicht |
David Mittig |