FA-04 – Füllvorgang erfassen
Stand: 12.10.2026 11:23
Branch: main
Status: erster Vorschlag
Änderungshistorie anzeigen
Use Case: UC03 – Füll-Abo & Füllkarten-Verwaltung
Screen: FA-04
Wireframe
Zum Vergrössern auf das Bild klicken; es öffnet sich in voller Grösse.
1. Zweck
FA-04 ist der operative Einstieg zum Erfassen eines konkreten Füllvorgangs. Der Mitarbeiter wählt Kunde und Füllkonto, prüft Status und Restguthaben, erfasst Gasart und Verbrauchsdaten und leitet den Vorgang zur verbindlichen Buchung weiter.
Die eigentliche Ledger-Buchung erfolgt nicht direkt in FA-04, sondern nach Verbrauchsvorschau und Bestätigung in FA-07.
2. Primäre Nutzer
| Rolle |
Nutzung |
mitarbeiter |
erfasst den Füllvorgang im Tagesbetrieb |
tenant_admin |
kann ebenfalls Füllvorgänge erfassen und Sonderfälle prüfen |
kunde |
indirekt betroffen; kundeninitiierte Variante über FA-11 / FA-12 |
3. Einstieg / Auslöser
| Einstieg |
Beschreibung |
| FA-01 |
Aktion Füllung erfassen |
| FA-03 |
Aktion Füllung buchen aus einem Füllkonto |
| FA-05 |
Kunde / Füllkonto wurde ausgewählt |
| FA-12 |
Mitarbeiter bestätigt einen kundeninitiierten Abruf und prüft Fülldaten |
4.1 Kundenauswahl
| Feld |
Beschreibung |
Pflicht |
| Kunde |
bestehender Kunde auswählen |
Ja, ausser bewusst anonyme Einzel-Füllung vorgesehen wird |
| Füllkonto |
aktive Karte / Abo / Punktekarte auswählen |
Ja, ausser Einzel-Füllung |
| Hinweis |
aktive Karten, offene Abrufe, pending_sync, Konflikte |
Nein |
4.2 Füllkonto-Zusammenfassung
| Information |
Beschreibung |
| Modell |
z. B. 10er-Karte, Bonuskarte, Punktekarte, Saisonabo |
| Restguthaben |
aktuelle Füllungen oder Punkte |
| Status |
aktiv, leer, gesperrt, abgelaufen, Konflikt |
| Self-Service |
aktiv / Bestätigung erforderlich / nicht aktiv |
| letzte Buchung |
letzte relevante Ledger-Buchung |
4.3 Fülldaten
| Feld |
Beschreibung |
Pflicht |
| Gasart |
Luft oder Nitrox |
Ja |
| Nitrox-Variante |
z. B. Nitrox 32, 36, 40 |
bei Nitrox sinnvoll |
| FO₂ |
Sauerstoffanteil in Prozent |
optional bei Nitrox |
| Verbrauchseinheiten |
z. B. 1 Füllung oder Punktewert |
Ja |
| Verbrauchsart |
Standard, manuell übersteuert |
Ja |
| Bemerkung |
freie Notiz |
Nein |
| Feld |
Beschreibung |
Pflicht |
| Analyse durchgeführt |
ja / nein |
Nein |
| Analyse durch Rolle |
Mitarbeiter oder Kunde |
wenn analysiert |
| Analyse durch Name |
Name der Person |
wenn analysiert |
| Analysezeitpunkt |
Datum / Zeit |
wenn analysiert |
| Kundenanalyse zusätzlich |
Kunde hat selbst nochmals geprüft |
optional |
| Analysebemerkung |
freie Bemerkung |
Nein |
5. Eingaben / Aktionen
| Aktion |
Beschreibung |
| Kunde / Füllkonto auswählen |
öffnet oder nutzt FA-05 |
| Gasart wählen |
Luft, Nitrox 32, Nitrox 36, Nitrox 40 oder tenant-spezifische Variante |
| Verbrauch berechnen |
System ermittelt Verbrauch nach Gasart / Punktewert |
| Verbrauch manuell übersteuern |
nur Mitarbeiter, mit Pflichtgrund und User-Stempel |
| Analyse erfassen |
optionale Nitrox-Analyseinformationen ergänzen |
| Zur Buchung weiter |
öffnet FA-07 mit Verbrauchsvorschau |
| Als Entwurf speichern |
Füllvorgang als draft speichern |
| Abbrechen |
zurück zu vorherigem Screen |
6. Validierungen / Regeln
| ID |
Regel |
| FA04-R01 |
Füllkonto muss aktiv sein, wenn gegen Karte oder Abo gebucht wird |
| FA04-R02 |
Gesperrte, leere oder konfliktbehaftete Füllkonten dürfen nicht verbraucht werden |
| FA04-R03 |
Bei pending_sync sind neue Kundenabbuchungen zu sperren |
| FA04-R04 |
Verbrauch darf das verfügbare Guthaben nicht überschreiten |
| FA04-R05 |
Punkteverbrauch wird in V1 pro Gasart / Nitrox-Variante ermittelt |
| FA04-R06 |
Manuelle Übersteuerung des Punkteverbrauchs nur durch Mitarbeiter und mit Pflichtgrund |
| FA04-R07 |
FO₂ ist bei Nitrox optional erfassbar, aber fachlich sinnvoll |
| FA04-R08 |
Wenn Analyse erfasst wird, müssen Person, Rolle und Zeitpunkt nachvollziehbar sein |
| FA04-R09 |
FA-04 erzeugt noch keine wirksame Ledger-Buchung; verbindliche Buchung erfolgt in FA-07 |
7. Status- und Fehlermeldungen
| Situation |
Meldung / Darstellung |
| kein Kunde gewählt |
„Bitte Kunde auswählen.“ |
| kein Füllkonto gewählt |
„Bitte Füllkonto oder Einzel-Füllung wählen.“ |
| Guthaben reicht nicht |
„Restguthaben reicht für diesen Verbrauch nicht aus.“ |
| pending_sync vorhanden |
„Nicht synchronisierte Buchungen vorhanden. Neue Abbuchung gesperrt.“ |
| Konflikt vorhanden |
„Konflikt muss vor weiterer Buchung geklärt werden.“ |
| Nitrox ohne FO₂ |
Hinweis: „FO₂ kann optional erfasst werden.“ |
| Verbrauch übersteuert |
Hinweis: „Pflichtgrund erforderlich.“ |
8. Bezug zu Datenmodell / Ledger
| Bereich |
Bezug |
| Füllvorgang |
fill_transactions |
| Füllkonto |
fill_accounts |
| Gasart |
fill_gas_types |
| Nitrox |
fo2_percent, nitrox_variant_name, Analysefelder |
| Verbrauch |
consumption_units / Punkteverbrauch |
| Sync |
sync_status |
| Ledger |
Buchung wird erst in FA-07 als fill_ledger_entries erzeugt |
9. Self-Service-Bezug
FA-04 kann sowohl aus einem mitarbeitergeführten Prozess als auch aus einem kundeninitiierten Abruf erreicht werden.
| Fall |
Bedeutung |
| Mitarbeitergeführt |
Mitarbeiter erfasst alle Daten selbst |
| kundeninitiiert |
Kunde hat Abruf gestartet, Mitarbeiter ergänzt / prüft Daten |
| echter Self-Service |
Kunde wählt Fülldaten selbst, Mitarbeiterbestätigung kann erforderlich sein |
10. Akzeptanzkriterien
| ID |
Kriterium |
| FA04-AC01 |
Mitarbeiter kann Kunde und Füllkonto auswählen |
| FA04-AC02 |
System zeigt Status und Restguthaben des Füllkontos |
| FA04-AC03 |
Mitarbeiter kann Gasart und Verbrauch erfassen |
| FA04-AC04 |
System berechnet Verbrauch nach Gasart / Nitrox-Variante |
| FA04-AC05 |
System blockiert Verbrauch bei gesperrtem, leerem oder konfliktbehaftetem Füllkonto |
| FA04-AC06 |
System blockiert neue Kundenabbuchungen bei offenen pending_sync-Buchungen |
| FA04-AC07 |
Nitrox-Analyseinformationen können optional erfasst werden |
| FA04-AC08 |
Verbrauchsübersteuerung erfordert Pflichtgrund und Benutzerstempel |
| FA04-AC09 |
Mitarbeiter kann zur Verbrauchsvorschau in FA-07 wechseln |
11. Offene Punkte
| ID |
Frage |
Status |
| FA04-O01 |
Wird anonyme Einzel-Füllung in V1 erlaubt oder immer Kunde erforderlich? |
offen |
| FA04-O02 |
Welche konkreten Standard-Punktewerte gelten für Nitrox 32 / 36 / 40? |
offen |
| FA04-O03 |
Wird bei Nitrox eine Verantwortungsbestätigung im UI angezeigt? |
optional, später prüfen |
| FA04-O04 |
Darf FA-04 offline als Entwurf gespeichert werden? |
ja, aber Buchung nur mit Sync-Regeln |
Ä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 |