FA-05 – Kunde / Füllkonto auswählen
Stand: 12.10.2026 11:23
Branch: main
Status: erster Vorschlag
Änderungshistorie anzeigen
Use Case: UC03 – Füll-Abo & Füllkarten-Verwaltung
Screen: FA-05
Wireframe
Zum Vergrössern auf das Bild klicken; es öffnet sich in voller Grösse.
1. Zweck
FA-05 dient zur gezielten Auswahl eines Kunden und eines passenden Füllkontos. Der Screen wird verwendet, wenn ein Füllvorgang gestartet, ein Verbrauch gebucht oder ein kundeninitiierter Abruf geprüft werden soll.
Der Screen soll schnell nutzbare Füllkonten anzeigen und gleichzeitig verhindern, dass gesperrte, leere, abgelaufene oder konfliktbehaftete Füllkonten versehentlich für neue Buchungen verwendet werden.
2. Primäre Nutzer
| Rolle |
Nutzung |
mitarbeiter |
sucht Kunde, Karte oder Abo und wählt das passende Füllkonto aus |
tenant_admin |
kann ebenfalls suchen und zusätzlich Sonderfälle prüfen |
kunde |
nicht direkt in dieser internen Ansicht; Abruf über FA-11 |
3. Einstieg / Auslöser
| Einstieg |
Beschreibung |
| FA-01 |
Suche oder Auswahl eines Füllkontos aus der Übersicht |
| FA-04 |
Kunde / Füllkonto muss für einen Füllvorgang ausgewählt werden |
| FA-07 |
Verbrauchsbuchung benötigt ein Füllkonto |
| FA-12 |
offener Kundenabruf verweist auf Kunde und Füllkonto |
| QR-Code / Abrufcode |
Füllkonto wird über Code geöffnet |
4. Such- und Auswahlwege
| Weg |
Beschreibung |
| Kundensuche |
Suche nach Name, Kundennummer oder Kontaktangabe |
| Füllkontosuche |
Suche nach Kartenname, Abo, Modell oder Referenz |
| QR-Code / Abrufcode |
Code scannt oder öffnet ein konkretes Füllkonto |
| zuletzt verwendet |
schnelle Auswahl zuletzt genutzter Kunden / Karten |
| aktive Füllkonten |
gefilterte Liste nutzbarer Konten |
5.1 Suchbereich
| Feld |
Beschreibung |
| Suche |
Name, Kundennummer, Kartennummer, Abo, QR-Code |
| Filter Status |
aktiv, leer, abgelaufen, gesperrt, Konflikt |
| Filter Modell |
Karte, Bonuskarte, Punktekarte, Abo |
| Filter Gasbereich |
Luft, Nitrox, gemischt |
| Nur nutzbare anzeigen |
blendet gesperrte / leere / konfliktbehaftete Konten aus |
5.2 Ergebnisliste Kunde
| Spalte |
Beschreibung |
| Kunde |
Name des Kunden |
| aktive Füllkonten |
Anzahl aktiver Karten / Abos |
| offene Abrufe |
Anzahl offener Kundenabrufe |
| Hinweise |
pending_sync, Konflikt, Sperre |
5.3 Ergebnisliste Füllkonten
| Spalte |
Beschreibung |
| Modell |
z. B. 10er-Karte, Bonuskarte, Punktekarte, Saisonabo |
| Gasbereich |
Luft, Nitrox 32 / 36 / 40, gemischt |
| Restguthaben |
Füllungen oder Punkte |
| Status |
aktiv, leer, abgelaufen, gesperrt, Konflikt |
| Self-Service |
aktiv, Bestätigung nötig, inaktiv |
| Auswahlstatus |
auswählbar oder gesperrt |
6. Eingaben / Aktionen
| Aktion |
Beschreibung |
| Kunde suchen |
filtert Kundenliste |
| Füllkonto suchen |
filtert Füllkontenliste |
| QR-Code scannen / eingeben |
öffnet Füllkonto direkt |
| Kunde auswählen |
zeigt alle Füllkonten des Kunden |
| Füllkonto auswählen |
übernimmt Füllkonto in FA-04 oder FA-07 |
| neues Füllkonto anlegen |
öffnet FA-02, wenn kein passendes Konto vorhanden ist |
| Detail öffnen |
öffnet FA-03 |
| Historie öffnen |
öffnet FA-08 oder FA-09 |
7. Validierungen / Regeln
| ID |
Regel |
| FA05-R01 |
Standardmässig werden nur aktive und nutzbare Füllkonten vorgeschlagen |
| FA05-R02 |
Leere, gesperrte, abgelaufene oder konfliktbehaftete Konten dürfen nicht direkt ausgewählt werden |
| FA05-R03 |
Füllkonten mit pending_sync dürfen für neue Kundenabbuchungen nicht ausgewählt werden |
| FA05-R04 |
QR-Code darf ein Füllkonto öffnen, aber keine ungeschützte direkte Buchung auslösen |
| FA05-R05 |
Mitarbeiter darf bei fehlendem Konto direkt FA-02 öffnen |
| FA05-R06 |
Auswahl muss Tenant-Isolation beachten; nur Daten des eigenen Tenants sichtbar |
| FA05-R07 |
Bei mehreren aktiven Konten muss der Mitarbeiter bewusst ein Konto auswählen |
8. Status- und Fehlermeldungen
| Situation |
Meldung / Darstellung |
| kein Ergebnis |
„Kein Kunde oder Füllkonto gefunden.“ |
| kein nutzbares Füllkonto |
„Kein aktives Füllkonto verfügbar.“ |
| Füllkonto leer |
Badge „leer“, Auswahl gesperrt |
| Füllkonto gesperrt |
Badge „gesperrt“, Auswahl gesperrt |
| pending_sync vorhanden |
„Nicht synchronisierte Buchungen vorhanden. Auswahl für neue Abbuchung gesperrt.“ |
| Konflikt vorhanden |
„Konflikt muss zuerst geprüft werden.“ |
| QR-Code ungültig |
„Abrufcode ist ungültig oder abgelaufen.“ |
9. Bezug zu Datenmodell / Ledger
| Bereich |
Bezug |
| Kunde |
customers |
| Füllkonto |
fill_accounts |
| Restguthaben |
current_balance, aus Ledger rekonstruierbar |
| Statusprüfung |
status, sync_status, confirmation_status |
| QR-Code / Abrufcode |
access_token_hash, access_token_expires_at oder spätere Token-Tabelle |
| letzte Buchung |
fill_ledger_entries.created_at |
10. Self-Service-Bezug
FA-05 unterstützt den internen Umgang mit QR-Code oder Abrufcode.
| Self-Service-Aspekt |
Bedeutung |
| digitale Füllkarte |
kann zu einem Füllkonto führen |
| Abrufcode |
darf nur sicher identifizieren, nicht unkontrolliert buchen |
| offene Kundenabrufe |
werden sichtbar und können nach FA-12 weitergeleitet werden |
| Mitarbeiterbestätigung |
bei Auswahl erkennbar, wenn Verbrauch später bestätigt werden muss |
11. Akzeptanzkriterien
| ID |
Kriterium |
| FA05-AC01 |
Mitarbeiter kann Kunden und Füllkonten suchen |
| FA05-AC02 |
Mitarbeiter sieht aktive Füllkonten eines Kunden |
| FA05-AC03 |
Mitarbeiter erkennt Restguthaben und Status je Füllkonto |
| FA05-AC04 |
System verhindert Auswahl nicht nutzbarer Füllkonten |
| FA05-AC05 |
System markiert pending_sync und Konflikte deutlich |
| FA05-AC06 |
Mitarbeiter kann ein nutzbares Füllkonto übernehmen |
| FA05-AC07 |
Mitarbeiter kann bei fehlendem Konto FA-02 öffnen |
| FA05-AC08 |
QR-Code / Abrufcode kann ein Füllkonto identifizieren |
| FA05-AC09 |
QR-Code löst keine direkte Buchung ohne weiteren Schritt aus |
12. Offene Punkte
| ID |
Frage |
Status |
| FA05-O01 |
Wird QR-Code-Scan direkt in FA-05 integriert oder über separaten Dialog? |
offen |
| FA05-O02 |
Darf ein Mitarbeiter nicht nutzbare Konten trotzdem im Detail öffnen? |
Vorschlag: ja, aber nicht auswählen |
| FA05-O03 |
Wie viele zuletzt verwendete Kunden werden angezeigt? |
offen |
| FA05-O04 |
Soll die Ergebnisansicht kunden- oder kontozentriert starten? |
Vorschlag: kundenorientiert mit Füllkonto-Detail rechts |
Ä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 |