FA-08 – Füllhistorie je Kunde
Stand: 12.10.2026 11:23
Branch: main
Status: erster Vorschlag
Änderungshistorie anzeigen
Use Case: UC03 – Füll-Abo & Füllkarten-Verwaltung
Screen: FA-08
Wireframe
Zum Vergrössern auf das Bild klicken; es öffnet sich in voller Grösse.
1. Zweck
FA-08 zeigt die vollständige Füllhistorie eines Kunden über alle zugeordneten Füllkarten, Abos, Punktekarten und Einzel-Füllungen hinweg.
Der Screen dient der Nachvollziehbarkeit: Mitarbeiter und tenant_admin sollen erkennen, wann welches Füllkonto genutzt wurde, welche Füllungen gebucht wurden, ob Self-Service beteiligt war und ob Stornos oder Korrekturen vorhanden sind.
2. Primäre Nutzer
| Rolle |
Nutzung |
mitarbeiter |
prüft Kundenhistorie, frühere Buchungen und Reststände |
tenant_admin |
prüft Korrekturen, Konflikte, Stornos und auffällige Buchungen |
kunde |
eigene reduzierte Historie später in FA-11 oder Kundenportal |
3. Einstieg / Auslöser
| Einstieg |
Beschreibung |
| FA-01 |
aus Übersicht über Kunde oder Aktion Historie |
| FA-03 |
aus Füllkonto-Detailansicht zur Kundehistorie |
| FA-07 |
nach erfolgreicher Buchung als Schnellaktion |
| FA-10 |
Prüfung vor oder nach Korrektur / Storno |
| Kundenprofil |
Absprung zur Füllhistorie des Kunden |
4.1 Kundenkopf
| Information |
Beschreibung |
| Kunde |
Name und Kundennummer / Referenz |
| aktive Füllkonten |
Anzahl aktiver Karten / Abos |
| Gesamtstatus |
Hinweise auf offene Abrufe, pending_sync oder Konflikte |
| Schnellaktionen |
neues Füllkonto, Füllung buchen, Kundenprofil öffnen |
4.2 Zusammenfassung
| Kennzahl |
Beschreibung |
| aktive Karten / Abos |
aktuell nutzbare Füllkonten |
| Gesamt-Restguthaben |
Summe oder separate Anzeige je Einheit / Punkteart |
| letzte Füllung |
Datum und Gasart |
| offene Abrufe |
Anzahl pending_confirmation |
| offene Sync-Vorgänge |
Anzahl pending_sync |
| Korrekturen / Stornos |
Anzahl relevanter Audit-Einträge |
4.3 Historientabelle
| Spalte |
Beschreibung |
| Datum / Zeit |
Zeitpunkt der Buchung |
| Füllkonto |
Karte / Abo / Punktekarte |
| Vorgang |
topup, bonus, consume, reverse, correction, cancel |
| Gasart |
Luft, Nitrox 32 / 36 / 40, gemischt |
| Verbrauch / Betrag |
Füllungen oder Punkte |
| Saldo danach |
Guthaben nach Buchung |
| Auslöser |
Mitarbeiter, Kunde, Self-Service |
| Status |
gebucht, storniert, korrigiert, pending_sync, conflict |
| Hinweis |
Grund, Analyse, Zahlungs- oder Stornohinweis |
| Aktion |
Detail öffnen, Storno / Korrektur, Füllkonto öffnen |
5. Filter und Ansichten
| Filter |
Zweck |
| Zeitraum |
z. B. letzte 30 Tage, Jahr, frei wählbar |
| Füllkonto |
einzelne Karte / Abo filtern |
| Vorgangstyp |
Verbrauch, Aufladung, Bonus, Korrektur, Storno |
| Gasart |
Luft, Nitrox, Variante |
| Status |
gebucht, pending_sync, conflict, storniert |
| Auslöser |
Mitarbeiter, Kunde, Self-Service |
6. Eingaben / Aktionen
| Aktion |
Beschreibung |
| Füllkonto öffnen |
öffnet FA-03 |
| Füllkonto-Historie öffnen |
öffnet FA-09 |
| Füllung buchen |
öffnet FA-04 / FA-07 mit Kunde vorausgewählt |
| Korrektur / Storno starten |
öffnet FA-10 für ausgewählten Ledger-Eintrag |
| Export vorbereiten |
später möglich, nicht V1-Kern |
| Filter anwenden |
aktualisiert Historientabelle |
7. Validierungen / Regeln
| ID |
Regel |
| FA08-R01 |
Es dürfen nur Historieneinträge des eigenen Tenants angezeigt werden |
| FA08-R02 |
Historie darf Ledger-Einträge nicht verändern |
| FA08-R03 |
Korrektur oder Storno erfolgt nur über FA-10 |
| FA08-R04 |
Synchronisierte Ledger-Einträge werden nicht überschrieben |
| FA08-R05 |
Storno und Korrektur müssen Pflichtgrund, Datum/Zeit und User-Stempel anzeigen |
| FA08-R06 |
pending_sync und conflict müssen deutlich markiert werden |
| FA08-R07 |
Kundeninitiierte Abrufe müssen als solche erkennbar sein |
| FA08-R08 |
Analyseinformationen bei Nitrox werden nur angezeigt, wenn erfasst |
8. Status- und Fehlermeldungen
| Situation |
Meldung / Darstellung |
| keine Historie vorhanden |
„Für diesen Kunden sind noch keine Füllbuchungen vorhanden.“ |
| pending_sync vorhanden |
gelber Hinweis: „Nicht synchronisierte Buchungen vorhanden.“ |
| Konflikt vorhanden |
roter Hinweis: „Konflikt muss geprüft werden.“ |
| Storno vorhanden |
Status-Badge „storniert“ |
| Korrektur vorhanden |
Status-Badge „korrigiert“ |
| Filter ohne Ergebnis |
„Keine Einträge für diese Filterauswahl.“ |
9. Bezug zu Datenmodell / Ledger
| Bereich |
Bezug |
| Kunde |
customers |
| Füllkonto |
fill_accounts |
| Ledger |
fill_ledger_entries |
| Füllvorgang |
fill_transactions |
| Status |
sync_status, confirmation_status, entry_type |
| Self-Service |
customer_initiated, initiated_by_customer_id, confirmed_by_user_id |
| Korrektur |
reverse, correction, Bezug auf Ursprungsbuchung |
| Audit |
created_by, created_at, reason, confirmed_by_user_id |
10. Self-Service-Bezug
FA-08 muss kundeninitiierte Abrufe sichtbar machen.
| Self-Service-Aspekt |
Darstellung |
| kundeninitiierter Abruf |
Auslöser = Kunde |
| Mitarbeiterbestätigung |
bestätigender Mitarbeiter sichtbar |
| pending_confirmation |
offener Abruf sichtbar, falls noch nicht erledigt |
| abgelehnter Abruf |
Status „abgelehnt“ oder „cancelled“ |
| direkter Self-Service |
als Kunde / Self-Service im Auslöser sichtbar |
11. Akzeptanzkriterien
| ID |
Kriterium |
| FA08-AC01 |
Mitarbeiter kann die Füllhistorie eines Kunden öffnen |
| FA08-AC02 |
Mitarbeiter sieht Buchungen über alle Füllkonten des Kunden |
| FA08-AC03 |
System zeigt Datum, Füllkonto, Vorgang, Gasart, Verbrauch und Status |
| FA08-AC04 |
Kundeninitiierte Abrufe sind erkennbar |
| FA08-AC05 |
Stornos und Korrekturen sind nachvollziehbar markiert |
| FA08-AC06 |
pending_sync und Konflikte werden deutlich angezeigt |
| FA08-AC07 |
Mitarbeiter kann von einem Eintrag zur Füllkonto-Detailansicht wechseln |
| FA08-AC08 |
Mitarbeiter kann bei berechtigtem Vorgang FA-10 öffnen |
| FA08-AC09 |
Historie verändert keine Ledger-Einträge direkt |
12. Offene Punkte
| ID |
Frage |
Status |
| FA08-O01 |
Wird ein Export der Kundenhistorie bereits in V1 vorbereitet? |
offen / eher später |
| FA08-O02 |
Soll die Historie standardmässig nach Datum absteigend sortiert sein? |
Vorschlag: ja |
| FA08-O03 |
Werden Zahlungsinformationen in der Kundenhistorie angezeigt? |
optional als Hinweis, keine Abrechnung |
| FA08-O04 |
Soll die Kundenansicht dieselbe Historie in reduzierter Form erhalten? |
Bezug zu FA-11 |
Ä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 |