# 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]]