FA-09 – Füllhistorie je Füllkonto
Stand: 12.10.2026 11:23
Branch: main
Status: erster Vorschlag
Änderungshistorie anzeigen
Use Case: UC03 – Füll-Abo & Füllkarten-Verwaltung
Screen: FA-09
Wireframe
Zum Vergrössern auf das Bild klicken; es öffnet sich in voller Grösse.
1. Zweck
FA-09 zeigt die vollständige Historie eines einzelnen Füllkontos. Ein Füllkonto kann fachlich eine Füllkarte, Bonuskarte, Punktekarte oder ein Abo sein.
Der Screen dient der detaillierten Nachvollziehbarkeit aller Ledger-Einträge dieses Füllkontos: Anlage, Aufladung, Bonus, Verbrauch, Storno, Korrektur, Self-Service-Abruf und Sync-Status.
Im Unterschied zu FA-08 zeigt FA-09 nicht die gesamte Kundenhistorie, sondern den Verlauf genau eines Füllkontos.
2. Primäre Nutzer
| Rolle |
Nutzung |
mitarbeiter |
prüft Verlauf, Restguthaben und letzte Buchungen eines Füllkontos |
tenant_admin |
prüft Korrekturen, Stornos, Konflikte und Audit-Verlauf |
kunde |
reduzierte Kundenansicht später in FA-11 möglich |
3. Einstieg / Auslöser
| Einstieg |
Beschreibung |
| FA-03 |
Aktion Historie anzeigen aus der Füllkonto-Detailansicht |
| FA-08 |
Auswahl eines Füllkontos aus der Kundenhistorie |
| FA-07 |
nach erfolgreicher Buchung als Schnellaktion |
| FA-10 |
Prüfung vor oder nach Storno / Korrektur |
4.1 Kopfbereich
| Information |
Beschreibung |
| Füllkonto |
Name / Modell, z. B. 10+3 Bonuskarte Luft |
| Kunde |
zugeordneter Kunde |
| Status |
aktiv, leer, gesperrt, abgelaufen, Konflikt |
| Restguthaben |
aktueller Stand |
| Schnellaktionen |
Füllung buchen, Korrektur / Storno, Detail öffnen, Kundenhistorie |
4.2 Saldo-Zusammenfassung
| Kennzahl |
Beschreibung |
| bezahlte Einheiten |
z. B. 10 |
| Bonus-Einheiten |
z. B. 3 |
| Startguthaben |
z. B. 13 |
| verbraucht |
Summe aller Verbrauchsbuchungen |
| korrigiert / storniert |
Summe relevanter Gegenbuchungen |
| aktuelles Restguthaben |
aktueller Stand current_balance |
4.3 Ledger-Tabelle
| Spalte |
Beschreibung |
| Datum / Zeit |
Zeitpunkt des Ledger-Eintrags |
| Typ |
topup, bonus, consume, reverse, correction |
| Gasart |
Luft, Nitrox 32 / 36 / 40 oder gemischt |
| Menge / Punkte |
Buchungswert |
| Saldo vorher |
Stand vor Buchung |
| Saldo nachher |
Stand nach Buchung |
| Auslöser |
Mitarbeiter, Kunde, Self-Service, System |
| Status |
gebucht, pending_sync, conflict, storniert, korrigiert |
| Bezug |
Ursprungsbuchung bei reverse / correction |
| Hinweis |
Grund, Analysehinweis oder Audit-Kommentar |
| Aktion |
Detail, Korrektur / Storno, Ursprungsbuchung öffnen |
5. Filter und Ansichten
| Filter |
Zweck |
| Zeitraum |
z. B. gesamte Laufzeit, letzte 30 Tage, Jahr |
| Vorgangstyp |
Anlage, Verbrauch, 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-Detail öffnen |
zurück zu FA-03 |
| Kundehistorie öffnen |
öffnet FA-08 |
| Füllung buchen |
öffnet FA-04 / FA-07 mit Füllkonto vorausgewählt |
| Korrektur / Storno starten |
öffnet FA-10 für ausgewählten Ledger-Eintrag |
| Ursprungsbuchung öffnen |
bei reverse / correction zur referenzierten Buchung springen |
| Filter anwenden |
Historientabelle einschränken |
7. Validierungen / Regeln
| ID |
Regel |
| FA09-R01 |
FA-09 ist eine lesende Historienansicht |
| FA09-R02 |
Ledger-Einträge dürfen in FA-09 nicht direkt verändert werden |
| FA09-R03 |
Korrektur oder Storno erfolgt ausschliesslich über FA-10 |
| FA09-R04 |
Synchronisierte Ledger-Einträge werden nie überschrieben |
| FA09-R05 |
Reverse- und Correction-Einträge müssen auf die Ursprungsbuchung verweisen |
| FA09-R06 |
balance_before und balance_after müssen nachvollziehbar angezeigt werden |
| FA09-R07 |
pending_sync und conflict müssen deutlich markiert werden |
| FA09-R08 |
Storno und Korrektur müssen Pflichtgrund, Datum/Zeit und User-Stempel anzeigen |
| FA09-R09 |
Tenant-Isolation muss eingehalten werden |
8. Status- und Fehlermeldungen
| Situation |
Meldung / Darstellung |
| keine Einträge vorhanden |
„Für dieses Füllkonto sind noch keine Buchungen vorhanden.“ |
| pending_sync vorhanden |
gelber Hinweis „Nicht synchronisierte Buchung vorhanden.“ |
| Konflikt vorhanden |
roter Hinweis „Konflikt muss geprüft werden.“ |
| Storno vorhanden |
Status-Badge „storniert“ oder Typ reverse |
| Korrektur vorhanden |
Status-Badge „korrigiert“ oder Typ correction |
| Ursprungsbuchung fehlt |
Warnhinweis „Referenzierte Buchung konnte nicht geladen werden.“ |
9. Bezug zu Datenmodell / Ledger
| Bereich |
Bezug |
| Füllkonto |
fill_accounts |
| Kunde |
customers |
| Ledger |
fill_ledger_entries |
| Buchungstyp |
entry_type |
| Saldo vorher |
balance_before |
| Saldo nachher |
balance_after |
| Referenz |
related_ledger_entry_id oder vergleichbares Feld |
| Sync |
sync_status |
| Self-Service |
customer_initiated, confirmation_status, confirmed_by_user_id |
| Audit |
created_by, created_at, reason, note |
10. Self-Service-Bezug
FA-09 zeigt, ob und wie Self-Service an Buchungen beteiligt war.
| Self-Service-Aspekt |
Darstellung |
| kundeninitiierter Abruf |
Auslöser = Kunde / Self-Service |
| Mitarbeiterbestätigung |
bestätigender Mitarbeiter sichtbar |
| pending_confirmation |
offener Abruf sichtbar, falls Buchung noch nicht abgeschlossen ist |
| abgelehnter Abruf |
Status „abgelehnt“ oder „cancelled“ |
| QR-Code-Bezug |
optionaler Hinweis, falls Abruf über digitale Karte gestartet wurde |
11. Akzeptanzkriterien
| ID |
Kriterium |
| FA09-AC01 |
Mitarbeiter kann die Historie eines Füllkontos öffnen |
| FA09-AC02 |
Mitarbeiter sieht Startguthaben, Verbrauch und aktuelles Restguthaben |
| FA09-AC03 |
System zeigt alle Ledger-Einträge des Füllkontos chronologisch |
| FA09-AC04 |
Jeder Eintrag zeigt Typ, Wert, Saldo vorher und Saldo nachher |
| FA09-AC05 |
Stornos und Korrekturen sind nachvollziehbar markiert |
| FA09-AC06 |
Reverse- und Correction-Einträge verweisen auf Ursprungsbuchungen |
| FA09-AC07 |
pending_sync und Konflikte werden deutlich angezeigt |
| FA09-AC08 |
Mitarbeiter kann von FA-09 aus FA-10 öffnen |
| FA09-AC09 |
FA-09 verändert keine Ledger-Einträge direkt |
12. Offene Punkte
| ID |
Frage |
Status |
| FA09-O01 |
Wird eine grafische Saldoentwicklung in V1 angezeigt? |
Vorschlag: ja, einfache Kurve oder Balken später möglich |
| FA09-O02 |
Wird ein Export der Füllkonto-Historie vorbereitet? |
offen / eher später |
| FA09-O03 |
Soll bei Storno die Ursprungsbuchung direkt inline angezeigt werden? |
Vorschlag: ja, wenn technisch einfach möglich |
| FA09-O04 |
Werden Analyseinformationen in der Tabelle oder im Detaildialog angezeigt? |
Vorschlag: Detaildialog |
Ä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 |