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/api/v1/endpoints/fehlbestaende.py

@@ -6,7 +6,7 @@ from sqlalchemy.ext.asyncio import AsyncSession
 
 from app.api.deps import require_roles
 from app.db.session import get_db
-from app.models.auth import RolleTyp
+from app.models.auth import KnotenTyp, RolleTyp, Systemknoten
 from app.models.fehlbestand import Fehlbestand
 from app.schemas.fehlbestand import (
     FehlbestandRead,
@@ -14,7 +14,11 @@ from app.schemas.fehlbestand import (
     NachfuellungRead,
     NachfuellungResponse,
 )
+from app.schemas.mindermenge import MindermengeGenehmigenRequest, MindermengeRead
 from app.services.fehlbestand import FehlbestandBereitsErledigtError, nachfuellen
+from app.services.mindermenge import BereitsGenehmigtError
+from app.services.mindermenge import FehlbestandBereitsErledigtError as MindermengeAufErledigtemError
+from app.services.mindermenge import genehmigen
 
 router = APIRouter()
 
@@ -29,6 +33,11 @@ _verantwortliche = require_roles(
 )
 
 
+async def _hauptserver_id(db: AsyncSession) -> int:
+    result = await db.execute(select(Systemknoten.id).where(Systemknoten.typ == KnotenTyp.haupt))
+    return result.scalar_one()
+
+
 @router.get("/fehlbestaende", response_model=list[FehlbestandRead])
 async def liste_fehlbestaende(
     status_filter: str | None = None,
@@ -70,9 +79,14 @@ async def erfasse_nachfuellung(
     if fehlbestand is None:
         raise HTTPException(status_code=status.HTTP_404_NOT_FOUND, detail="Fehlbestand nicht gefunden")
 
+    zustaendiger_server_id = await _hauptserver_id(db)
     try:
         nachfuellung, ueberbestand = await nachfuellen(
-            db, fehlbestand=fehlbestand, menge=payload.menge, benutzer_id=current_user.id
+            db,
+            fehlbestand=fehlbestand,
+            menge=payload.menge,
+            benutzer_id=current_user.id,
+            zustaendiger_server_id=zustaendiger_server_id,
         )
     except FehlbestandBereitsErledigtError as exc:
         raise HTTPException(
@@ -84,3 +98,41 @@ async def erfasse_nachfuellung(
         fehlbestand=FehlbestandRead.model_validate(fehlbestand),
         ueberbestand=ueberbestand,
     )
+
+
+@router.post(
+    "/fehlbestaende/{fehlbestand_id}/mindermenge",
+    response_model=MindermengeRead,
+    status_code=status.HTTP_201_CREATED,
+)
+async def genehmige_mindermenge(
+    fehlbestand_id: uuid.UUID,
+    payload: MindermengeGenehmigenRequest,
+    db: AsyncSession = Depends(get_db),
+    current_user=Depends(_verantwortliche),
+) -> MindermengeRead:
+    """Prompt 04: NIEMALS durch Mitarbeiter (Rollen-Dependency erzwingt das bereits),
+    ändert NIEMALS Ist-Menge/Fehlmenge/Fehlbestand-Status (U2)."""
+    fehlbestand = await db.get(Fehlbestand, fehlbestand_id)
+    if fehlbestand is None:
+        raise HTTPException(status_code=status.HTTP_404_NOT_FOUND, detail="Fehlbestand nicht gefunden")
+
+    zustaendiger_server_id = await _hauptserver_id(db)
+    try:
+        genehmigung = await genehmigen(
+            db,
+            fehlbestand=fehlbestand,
+            begruendung=payload.begruendung,
+            genehmigt_von=current_user.id,
+            zustaendiger_server_id=zustaendiger_server_id,
+        )
+    except MindermengeAufErledigtemError as exc:
+        raise HTTPException(
+            status_code=status.HTTP_409_CONFLICT, detail="Fehlbestand ist bereits erledigt"
+        ) from exc
+    except BereitsGenehmigtError as exc:
+        raise HTTPException(
+            status_code=status.HTTP_409_CONFLICT, detail="Fehlbestand hat bereits eine aktive Genehmigung"
+        ) from exc
+
+    return MindermengeRead.model_validate(genehmigung)

backend/app/api/v1/endpoints/kontrollen.py

@@ -154,8 +154,9 @@ async def abschliesse(
 ) -> Kontrolle:
     kontrolle = await _hole_kontrolle_oder_404(db, kontrolle_id)
     _pruefe_besitz(kontrolle, current_user)
+    zustaendiger_server_id = await _hauptserver_id(db)
     try:
-        await abschliesse_kontrolle(db, kontrolle=kontrolle)
+        await abschliesse_kontrolle(db, kontrolle=kontrolle, zustaendiger_server_id=zustaendiger_server_id)
     except UnvollstaendigError as exc:
         raise HTTPException(
             status_code=status.HTTP_409_CONFLICT,
@@ -176,5 +177,8 @@ async def abbreche(
 ) -> Kontrolle:
     kontrolle = await _hole_kontrolle_oder_404(db, kontrolle_id)
     _pruefe_besitz(kontrolle, current_user)
-    await abbreche_kontrolle(db, kontrolle=kontrolle, grund=payload.grund)
+    zustaendiger_server_id = await _hauptserver_id(db)
+    await abbreche_kontrolle(
+        db, kontrolle=kontrolle, grund=payload.grund, zustaendiger_server_id=zustaendiger_server_id
+    )
     return kontrolle