Sprint 5: Mindermengen-Genehmigung + automatischer Ablauf, Historie für Kernkette

- MindermengenGenehmigung-Modell/Service (Prompt 04): reine fachliche Bewertung,
  ändert NIEMALS Ist-Menge/Fehlmenge/Fehlbestand-Status (Leitplanke, U2)
- Automatischer Ablauf bei Start der nächsten Kontrolle desselben Objekts (Karte 08,
  U6) - kein Zeit-Trigger, der Kontrollstart selbst ist der Ablauf-Zeitpunkt
- Genehmigung endet gemeinsam mit dem Fehlbestand, wenn dieser durch Nachfüllung
  erledigt wird (U7), unabhängig davon ob vorher eine neue Kontrolle stattfand
- Historie-Service (app/services/historie.py) + Verdrahtung in die komplette
  Kernkette: kontrolle_gestartet/-abgeschlossen/-abgebrochen/-uebernommen,
  istmenge_erfasst, fehlbestand_entstanden/-erledigt, nachfuellung_erfasst,
  mindermenge_genehmigt/-abgelaufen/-beendet_durch_erledigung (U14)
  Hinweis: Stammdaten-/Vorlagen-/Benutzerverwaltung noch nicht retrofittet -
  Sprint 5 deckt bewusst die im Testkonzept referenzierte Kernkette ab, keine
  flächendeckende Audit-Abdeckung aller CRUD-Endpunkte.
- Tests: U2, U6, U7, vollständige Historie-Kette nach Prompt-13.3-Beispiel (U14)

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01L85hmKbvX7Cqkq47KnQhFt

backend/app/services/historie.py

@@ -0,0 +1,37 @@
+from datetime import datetime, timezone
+from typing import Any
+
+from sqlalchemy.ext.asyncio import AsyncSession
+
+from app.models.historie import Historie
+
+
+async def log(
+    db: AsyncSession,
+    *,
+    zustaendiger_server_id: int,
+    benutzer_id: int | None,
+    ereignistyp: str,
+    entitaet_typ: str,
+    entitaet_id: Any,
+    alter_wert: dict | None = None,
+    neuer_wert: dict | None = None,
+    begruendung: str | None = None,
+) -> Historie:
+    """Prompt 13: append-only Audit-Log. Deckt Sprint 5 die Kernkette ab (Kontrolle,
+    Fehlbestand, Nachfüllung, Mindermenge) - Stammdaten-/Vorlagen-/Benutzerverwaltung
+    folgen bei Bedarf mit demselben Muster, hier noch nicht flächendeckend verdrahtet."""
+    eintrag = Historie(
+        erzeugt_von_server_id=zustaendiger_server_id,
+        zeitpunkt=datetime.now(timezone.utc),
+        benutzer_id=benutzer_id,
+        ereignistyp=ereignistyp,
+        entitaet_typ=entitaet_typ,
+        entitaet_id=str(entitaet_id),
+        alter_wert=alter_wert,
+        neuer_wert=neuer_wert,
+        begruendung=begruendung,
+    )
+    db.add(eintrag)
+    await db.flush()
+    return eintrag