Zum Inhalt

FA-06 – Gasart und Verbrauchsdaten 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-06


Wireframe

FA-06 – Gasart und Verbrauchsdaten erfassen

Zum Vergrössern auf das Bild klicken; es öffnet sich in voller Grösse.


1. Zweck

FA-06 dient zur fachlichen Erfassung der Gasart und der dazugehörigen Verbrauchsdaten für einen Füllvorgang.

Der Screen ist besonders wichtig für Punktekarte, Nitrox-Füllungen und tenant-spezifische Verbrauchswerte. Die verbindliche Buchung erfolgt weiterhin erst in FA-07.


2. Primäre Nutzer

Rolle Nutzung
mitarbeiter erfasst Gasart, Verbrauch, optionale Analyseinformationen und Übersteuerungsgrund
tenant_admin kann Sonderfälle prüfen und Konfigurationen kontrollieren
kunde nicht direkt in dieser internen Ansicht; Self-Service-Variante folgt in FA-11

3. Einstieg / Auslöser

Einstieg Beschreibung
FA-04 Füllvorgang wurde gestartet und Kunde / Füllkonto sind bekannt
FA-05 Kunde und Füllkonto wurden ausgewählt
FA-12 kundeninitiierter Abruf benötigt Prüfung oder Ergänzung der Verbrauchsdaten

4. Angezeigte und erfassbare Informationen

4.1 Kontext

Feld Beschreibung
Kunde ausgewählter Kunde
Füllkonto Karte, Bonuskarte, Punktekarte oder Abo
Restguthaben aktueller Stand vor geplanter Buchung
Einheit Füllungen oder Punkte
Status aktiv, pending_sync, conflict, leer, gesperrt

4.2 Gasart

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
Gasart-Hinweis z. B. „FO₂ ist nicht ppO₂“ Nein

Wichtig:

FO₂ beschreibt den Sauerstoffanteil im Atemgas.
ppO₂ beschreibt den Sauerstoffpartialdruck und hängt zusätzlich von Tiefe / Druck ab.

4.3 Verbrauch

Feld Beschreibung Pflicht
Standardverbrauch aus Tenant-Regel pro Gasart / Nitrox-Variante Ja
berechneter Verbrauch z. B. 1 Füllung oder 2 Punkte Ja
Restguthaben vorher aktueller Stand Ja
Restguthaben nachher Vorschau nach Verbrauch Ja
manuelle Übersteuerung nur durch Mitarbeiter Nein
Übersteuerungsgrund Pflicht bei manueller Übersteuerung falls übersteuert

V1-Regel:

Punkteverbrauch wird pro Gasart / Nitrox-Variante ermittelt.
Eine Abweichung pro Produktvorlage ist für V2 / V3 vorbereitet.

4.4 Nitrox-Analyse

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 analysiert später selbst Nein
Analysebemerkung freie Bemerkung Nein

5. Eingaben / Aktionen

Aktion Beschreibung
Gasart wählen Luft oder Nitrox
Nitrox-Variante wählen 32 %, 36 %, 40 % oder tenant-spezifische Variante
FO₂ erfassen optionaler Sauerstoffanteil
Verbrauch prüfen System zeigt Standardverbrauch und Restguthaben danach
Verbrauch übersteuern nur Mitarbeiter, mit Pflichtgrund
Analyse erfassen optionale Analyseinformationen ergänzen
Zur Vorschau öffnet FA-07
Zurück zurück zu FA-04

6. Validierungen / Regeln

ID Regel
FA06-R01 Gasart ist Pflicht
FA06-R02 Nitrox-Variante ist bei Nitrox fachlich sinnvoll und sollte auswählbar sein
FA06-R03 FO₂ ist bei Nitrox optional erfassbar
FA06-R04 Verbrauch wird in V1 aus Gasart / Nitrox-Variante und Tenant-Regel ermittelt
FA06-R05 Manuelle Übersteuerung ist nur durch Mitarbeiter erlaubt
FA06-R06 Manuelle Übersteuerung benötigt Pflichtgrund, Datum/Zeit und User-Stempel
FA06-R07 Restguthaben nach Verbrauch darf nicht negativ werden, ausser ausdrücklich erlaubte Ausnahme
FA06-R08 Bei Punktekarte muss der Verbrauch vor der Buchung immer sichtbar sein
FA06-R09 Wenn Analyse erfasst wird, müssen Rolle, Name und Zeitpunkt nachvollziehbar sein
FA06-R10 FA-06 erzeugt noch keine Ledger-Buchung; verbindliche Buchung erfolgt in FA-07

7. Status- und Fehlermeldungen

Situation Meldung / Darstellung
Gasart fehlt „Bitte Gasart auswählen.“
Nitrox ohne Variante „Bitte Nitrox-Variante auswählen oder FO₂ manuell erfassen.“
Verbrauch nicht konfiguriert „Für diese Gasart ist kein Verbrauchswert konfiguriert.“
Guthaben reicht nicht „Restguthaben reicht für diesen Verbrauch nicht aus.“
Verbrauch übersteuert ohne Grund „Bitte Grund für die Übersteuerung erfassen.“
Analyse unvollständig „Bitte Name, Rolle und Analysezeitpunkt ergänzen.“

8. Bezug zu Datenmodell / Ledger

Bereich Bezug
Füllvorgang fill_transactions
Gasart gas_type
Nitrox-Variante nitrox_variant_name
FO₂ fo2_percent
Verbrauch consumption_units oder Punktewert
Analyse analysis_performed, analysis_by_role, analysis_by_name, analysis_at, analysis_note
Übersteuerung Pflichtgrund und Auditdaten
Ledger Buchung wird erst in FA-07 erzeugt

9. Self-Service-Bezug

FA-06 ist die interne Erfassungs- und Prüfansicht. Für kundeninitiierte Abrufe können Werte aus FA-11 oder FA-12 übernommen und hier geprüft werden.

Self-Service-Fall Bedeutung
Kunde wählt Gasart selbst Mitarbeiter prüft oder bestätigt in FA-06 / FA-07
Mitarbeiterbestätigung erforderlich FA-06 kann Ergänzung der Fülldaten vor FA-07 ermöglichen
direkter Self-Service Werte müssen für Kunden stark vereinfacht und verständlich sein

10. Akzeptanzkriterien

ID Kriterium
FA06-AC01 Mitarbeiter kann Luft oder Nitrox auswählen
FA06-AC02 Mitarbeiter kann Nitrox 32 / 36 / 40 auswählen
FA06-AC03 System zeigt den Standardverbrauch je Gasart / Nitrox-Variante
FA06-AC04 System zeigt Restguthaben vorher und nachher
FA06-AC05 Mitarbeiter kann FO₂ optional erfassen
FA06-AC06 Mitarbeiter kann Analyseinformationen optional erfassen
FA06-AC07 Manuelle Verbrauchsübersteuerung ist nur mit Pflichtgrund möglich
FA06-AC08 System verhindert unzulässigen Verbrauch bei zu geringem Guthaben
FA06-AC09 Mitarbeiter kann zur verbindlichen Verbrauchsvorschau in FA-07 wechseln

11. Offene Punkte

ID Frage Status
FA06-O01 Welche konkreten Punktewerte gelten initial für Nitrox 32 / 36 / 40? offen
FA06-O02 Darf ein Mitarbeiter Verbrauchswerte dauerhaft für den Tenant speichern? eher FA-15 / Konfiguration
FA06-O03 Wird FO₂ bei Auswahl von Nitrox 32 automatisch mit 32 vorbelegt? Vorschlag: ja
FA06-O04 Wird Analyse bei Nitrox aktiv empfohlen, aber nicht verpflichtend? Vorschlag: ja

Ä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