MABEA/ergebnisse/13_historie_audit.md

Prompt 13 – Historie und Nachvollziehbarkeit

Bezug: 06_datenmodell (Historieneintrag), 03_fehlbestandsmanagement, 04_mindermengen, 10_individuelle_beladung.

1. Grundprinzip

Jede fachlich relevante Aktion erzeugt einen unveränderlichen Historieneintrag: wer, was, wann, vorheriger Wert, neuer Wert, Begründung (falls vorhanden). Kein Löschen/Überschreiben von Historie, nur Anhängen.

2. Protokollierte Ereignistypen

Ereignis	Ausgelöst durch	Gespeicherte Werte
Kontrolle gestartet/abgeschlossen/abgebrochen	Mitarbeiter	Objekt, Zeitpunkt, Status-Wechsel
Ist-Menge erfasst (je Position)	Mitarbeiter	Material, Soll, alter Ist, neuer Ist
Fehlbestand entstanden	System (automatisch)	Material, Objekt, Soll, Ist, Fehlmenge, entstanden am
Nachfüllung	Mitarbeiter/Verantwortlicher	Material, Objekt, Menge, wer, wann, verknüpfter Fehlbestand
Fehlbestand erledigt	System (automatisch bei Ist=Soll)	Zeitpunkt, auslösende Nachfüllung
Mindermenge genehmigt	Materialverantwortlicher/Leitung	Fehlbestand, Begründung, wer, wann, gültig bis
Mindermenge abgelaufen/beendet	System (automatisch)	Fehlbestand, Zeitpunkt/Kontrolle, die sie beendet hat
Sollmenge geändert (Vorlage oder Override)	Materialverantwortlicher/Administration	Material, Objekt/Vorlage, alter Wert, neuer Wert
Vorlage geändert (neue Version)	Administration/Materialverantwortlicher	Vorlage, Version alt/neu, geänderte Positionen
Individuelle Abweichung gesetzt/aufgehoben	Materialverantwortlicher	Objekt, Material, Override ja/nein, Begründung
Objekt dupliziert/angelegt	Administration	Quelle, neues Objekt, Zeitpunkt
Benutzer-/Rollenänderung	Administration	Benutzer, alte/neue Rolle(n)
Zuständigkeits-Zuordnung geändert	Administration	Benutzer, Standort/Objekt, alt/neu

3. Beispiel-Kette (aus Prompt-Vorgabe)

Soll 10, Ist 8 → Fehlbestand entstanden (Fehlmenge 2) → keine Nachfüllung möglich (Status offen) → Mindermenge genehmigt (Begründung, gültig bis nächste Kontrolle) → später 2 Stück nachgefüllt → Ist wieder 10 → Fehlbestand automatisch erledigt, Mindermengen-Genehmigung automatisch beendet (verknüpft mit derselben Erledigung). Jeder dieser Schritte ist ein eigener, zeitlich geordneter Historieneintrag, alle auf denselben Fehlbestand referenziert.

4. Darstellung

Für Mitarbeiter

• Eigene Aktionen einsehbar (was habe ich wann bei welchem Objekt erfasst) – Prompt 05: keine fremde Historie sichtbar.
• Objektbezogene Detailansicht (Prompt 11 Screen 4/6): Verlauf der letzten Kontrollen dieses Objekts.

Für Verantwortliche/Administration

• Vollständige Timeline je Fehlbestand (Dashboard-Detail, Prompt 12): chronologische Liste aller Ereignisse mit Icon je Typ.
• Filterbare globale Historie (z. B. „alle Änderungen an Vorlage X", „alle Genehmigungen von Benutzer Y") – v. a. für Administration/Audit-Zwecke.

5. Technische/fachliche Anforderungen an Historie

• Unveränderlich (Append-only), kein Update/Delete bestehender Einträge.
• Referenzintegrität auch bei gelöschten/inaktiven Stammdaten erhalten (z. B. Material wird deaktiviert, Historie zeigt trotzdem den Namen von damals – Snapshot-Prinzip wie bei Kontrollpositionen, Prompt 06).
• Zeitstempel immer serverseitig, nicht durch Client vorgebbar (Manipulationsschutz, Nachvollziehbarkeit im Rettungsdienst-/KatS-Kontext).

Referenzen

Bezug: 06_datenmodell, 03_fehlbestandsmanagement, 04_mindermengen, 10_individuelle_beladung, 05_rollen_rechte