FA-02 – Neues Füllkonto / neue Karte / neues Abo anlegen
Stand: 12.10.2026 11:23
Branch: main
Status: erster Vorschlag
Änderungshistorie anzeigen
Use Case: UC03 – Füll-Abo & Füllkarten-Verwaltung
Screen: FA-02
Wireframe
Zum Vergrössern auf das Bild klicken; es öffnet sich in voller Grösse.
1. Zweck
FA-02 dient zum Anlegen eines neuen Füllkontos für einen Kunden. Ein Füllkonto kann fachlich als Karte, Bonuskarte, Punktekarte oder Abo verwendet werden.
Der Screen soll eine einfache Anlage der V1-Produktvorlagen ermöglichen und gleichzeitig spätere Erweiterungen vorbereiten.
2. Primäre Nutzer
| Rolle |
Nutzung |
mitarbeiter |
legt neue Füllkarten oder Abos für Kunden an |
tenant_admin |
legt Füllkonten an und kann erweiterte Einstellungen setzen |
kunde |
nicht direkt in dieser internen Ansicht |
3. Einstieg / Auslöser
| Einstieg |
Beschreibung |
| FA-01 |
Aktion Neues Füllkonto |
| Kundenprofil |
neues Füllkonto direkt für ausgewählten Kunden anlegen |
| FA-04 |
Füllvorgang startet, aber Kunde hat noch keine passende Karte |
| Administration |
tenant_admin legt Füllkonto manuell an |
4.1 Kundenzuordnung
| Feld |
Beschreibung |
Pflicht |
| Kunde |
bestehender Kunde auswählen |
Ja |
| Kundennummer / Referenz |
automatische Anzeige nach Auswahl |
Nein |
| Hinweis |
z. B. offene Karten, aktive Abos, Konflikte |
Nein |
4.2 Modell / Produktvorlage
| Feld |
Beschreibung |
Pflicht |
| Produktvorlage |
z. B. 10er-Karte Luft, 10+3 Bonuskarte Luft, Einzel-Füllung Luft |
Ja |
| Füllmodell |
Karte, Bonuskarte, Punktekarte, Abo |
Ja |
| Gasbereich |
Luft, Nitrox, gemischt |
Ja |
| Punktekarte |
aktivierbar, wenn Produktvorlage Punkte nutzt |
Nein |
V1-Produktvorlagen:
| Vorlage |
V1 |
| 10er-Karte Luft |
Ja |
| 10+3 Bonuskarte Luft |
Ja |
| Einzel-Füllung Luft |
Ja |
| Punktekarte gemischt |
offen / vorbereitet |
| Saisonabo mit Kontingent |
offen / vorbereitet |
| Nitrox-Karte |
vorbereitet |
4.3 Guthaben / Einheiten
| Feld |
Beschreibung |
Pflicht |
| bezahlte Einheiten |
z. B. 10 |
Ja bei Karte / Bonuskarte |
| Bonus-Einheiten |
z. B. 3 |
Ja bei Bonusmodell, sonst 0 |
| Startguthaben |
berechnet aus bezahlten Einheiten + Bonus-Einheiten |
Ja |
| Einheit |
Füllungen oder Punkte |
Ja |
| Punkteverbrauch |
bei Punktekarte pro Gasart / Nitrox-Variante |
falls Punktekarte |
Regel:
initial_balance = paid_units + bonus_units
Die Anwendung prüft diese Regel in V1. Eine harte Datenbank-Constraint wird geprüft, aber nicht zwingend sofort umgesetzt.
4.4 Gültigkeit und Status
| Feld |
Beschreibung |
Pflicht |
| gültig ab |
Startdatum |
Nein / empfohlen |
| gültig bis |
Ablaufdatum |
Nein / empfohlen bei Abo |
| Startstatus |
draft oder active |
Ja |
| Bemerkung |
freie Notiz |
Nein |
4.5 Self-Service
| Feld |
Beschreibung |
Pflicht |
| Self-Service aktiv |
Kunde kann Karte digital anzeigen / abrufen |
Nein |
| Mitarbeiterbestätigung erforderlich |
Abruf benötigt Freigabe durch Mitarbeiter |
empfohlen |
| digitale Karte vorbereiten |
QR-Code / Abrufcode später nutzbar |
Nein |
Empfehlung für V1:
Self-Service kann beim Anlegen aktiviert werden.
Standardmässig ist Mitarbeiterbestätigung erforderlich.
Preise werden in UC03 V1 nur informativ vorbereitet. Es wird keine vollständige Preis-, Zahlungs-, Steuer- oder Rechnungslogik umgesetzt.
| Feld |
Beschreibung |
Pflicht |
| Zahlungsstatus |
unbekannt, offen, bezahlt, teilweise bezahlt |
Nein |
| bezahlt am |
Zeitpunkt der Zahlungsbestätigung |
Nein |
| Zahlungsart-Hinweis |
Bar, Karte, Überweisung, externes Kassensystem |
Nein |
| Zahlung bestätigt durch |
Benutzer, der Zahlung bestätigt hat |
Nein |
| Zahlungsnotiz |
freie Bemerkung |
Nein |
5. Eingaben / Aktionen
| Aktion |
Beschreibung |
| Kunde auswählen |
sucht oder übernimmt Kunde aus Kontext |
| Produktvorlage wählen |
legt Modell, Gasbereich und Standardwerte fest |
| Guthaben berechnen |
berechnet Startguthaben aus bezahlten und Bonus-Einheiten |
| Self-Service aktivieren |
digitale Karte und Abruf vorbereiten |
| Zahlungsstatus erfassen |
optionale Zahlungsinformation speichern |
| Als Entwurf speichern |
Füllkonto mit Status draft speichern |
| Aktiv anlegen |
Füllkonto mit Status active speichern |
| Abbrechen |
ohne Speicherung zurück zu FA-01 |
6. Validierungen / Regeln
| ID |
Regel |
| FA02-R01 |
Ein neues Füllkonto benötigt eine Kundenzuordnung |
| FA02-R02 |
Produktvorlage oder Füllmodell muss ausgewählt sein |
| FA02-R03 |
Bezahlte Einheiten dürfen nicht negativ sein |
| FA02-R04 |
Bonus-Einheiten dürfen nicht negativ sein |
| FA02-R05 |
Startguthaben wird aus bezahlten und Bonus-Einheiten berechnet |
| FA02-R06 |
Bei Bonuskarten muss initial_balance = paid_units + bonus_units gelten |
| FA02-R07 |
Bei aktivem Self-Service muss festgelegt sein, ob Mitarbeiterbestätigung erforderlich ist |
| FA02-R08 |
Bei Zahlungsstatus paid soll Datum/Zeit und bestätigender Benutzer gespeichert werden |
| FA02-R09 |
Punkteverbrauch ist bei Punktekarten pro Gasart / Nitrox-Variante zu konfigurieren oder aus Tenant-Standardwerten zu übernehmen |
7. Status- und Fehlermeldungen
| Situation |
Meldung / Darstellung |
| Kunde fehlt |
„Bitte Kunde auswählen.“ |
| Produktvorlage fehlt |
„Bitte Karten- oder Abo-Modell auswählen.“ |
| Bonusberechnung ungültig |
„Startguthaben passt nicht zu bezahlten und Bonus-Einheiten.“ |
| Self-Service ohne Bestätigungsregel |
„Bitte Self-Service-Regel festlegen.“ |
| Zahlungsstatus bezahlt ohne Datum |
Hinweis: „Zahlungsdatum kann ergänzt werden.“ |
| erfolgreich gespeichert |
„Füllkonto wurde angelegt.“ |
8. Bezug zu Datenmodell / Ledger
| Bereich |
Bezug |
| Füllkonto |
fill_accounts |
| Produktvorlage |
später ggf. fill_product_templates |
| bezahlte Einheiten |
paid_units |
| Bonus-Einheiten |
bonus_units |
| Startguthaben |
initial_balance |
| aktuelles Guthaben |
current_balance |
| Startbuchung |
fill_ledger_entries mit entry_type = topup und ggf. bonus |
| Self-Service |
self_service_enabled, requires_staff_confirmation |
| Zahlung |
optionale Felder payment_status, paid_at, payment_confirmed_by |
9. Self-Service-Bezug
Beim Anlegen kann Self-Service vorbereitet werden.
| Einstellung |
Bedeutung |
| Self-Service aktiv |
Kunde kann Karte digital sehen oder Abruf starten |
| Mitarbeiterbestätigung erforderlich |
sicherer Standard für V1 |
| digitale Karte vorbereiten |
QR-Code / Abrufcode wird vorbereitet, aber nicht zwingend direkt angezeigt |
10. Akzeptanzkriterien
| ID |
Kriterium |
| FA02-AC01 |
Mitarbeiter kann ein neues Füllkonto für einen Kunden anlegen |
| FA02-AC02 |
Mitarbeiter kann eine Produktvorlage auswählen |
| FA02-AC03 |
System berechnet Startguthaben aus bezahlten und Bonus-Einheiten |
| FA02-AC04 |
System verhindert negative Einheiten |
| FA02-AC05 |
Mitarbeiter kann Self-Service aktivieren oder deaktivieren |
| FA02-AC06 |
Mitarbeiter kann festlegen, ob Mitarbeiterbestätigung erforderlich ist |
| FA02-AC07 |
Mitarbeiter kann optionale Zahlungsinformationen erfassen |
| FA02-AC08 |
System legt das Füllkonto als Entwurf oder aktiv an |
| FA02-AC09 |
Nach Speicherung ist das neue Füllkonto in FA-01 sichtbar |
11. Offene Punkte
| ID |
Frage |
Status |
| FA02-O01 |
Werden Punktekarte und Saisonabo bereits aktiv in V1 angeboten oder nur vorbereitet? |
offen |
| FA02-O02 |
Wird QR-Code direkt beim Anlegen erzeugt oder erst in FA-03 / FA-11? |
Vorschlag: erst in FA-03 / FA-11 anzeigen |
| FA02-O03 |
Darf ein Mitarbeiter Zahlungsstatus paid setzen? |
offen, fachlich naheliegend |
| FA02-O04 |
Gibt es Pflichtfelder für Gültigkeit bei Abo-Modellen? |
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 |