feat(personal): Personal/Qualifikationen-Modul (Roadmap Phase 1)

Neues Modul für die BOS-Ressourcenplattform-Erweiterung: Einheit (Zug/Gruppe, self-referenzierend), Qualifikationstyp (Führerschein/Lehrgang/Berechtigung), BenutzerQualifikation (mit Gültigkeit) und ObjekttypQualifikationsanforderung (M:N) - beantwortet "wer darf dieses Fahrzeug fahren?" über GET /objekte/{id}/berechtigung/{benutzer_id}. Benutzer und Objekt bekommen optionale einheit_id (additiv, analog fahrzeug_id-Muster). Nebenbei Bugfix: PATCH /benutzer konnte einheit_id nicht auf null setzen (Feld-vorhanden-Check via model_fields_set statt is not None). Frontend: neuer Admin-Tab "Personal" (Einheiten, Qualifikationstypen, Benutzer-Qualifikationszuordnung), Einheit-Auswahl im Benutzer-Formular. Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01KC8HYvv6UkCVYheYiTw9DD
2026-09-05 11:13:37 +02:00
parent c3f141f7b0
commit d71d95e17f
17 changed files with 1167 additions and 8 deletions
@@ -0,0 +1,53 @@
+from datetime import date
+
+from sqlalchemy import select
+from sqlalchemy.ext.asyncio import AsyncSession
+
+from app.models.objekt import Objekt
+from app.models.personal import (
+    BenutzerQualifikation,
+    ObjekttypQualifikationsanforderung,
+    Qualifikationstyp,
+)
+
+
+async def pruefe_berechtigung(db: AsyncSession, *, benutzer_id: int, objekt_id: int) -> list[Qualifikationstyp]:
+    """Nutzer-Beispiel Personal-Modul: "wer darf dieses Fahrzeug fahren?".
+    Liefert die Qualifikationstypen, die der Objekttyp verlangt, aber der
+    Benutzer nicht (mehr) gültig nachgewiesen hat - leere Liste = berechtigt."""
+    objekt = await db.get(Objekt, objekt_id)
+    if objekt is None:
+        return []
+
+    erforderlich = (
+        (
+            await db.execute(
+                select(Qualifikationstyp)
+                .join(
+                    ObjekttypQualifikationsanforderung,
+                    ObjekttypQualifikationsanforderung.qualifikationstyp_id == Qualifikationstyp.id,
+                )
+                .where(ObjekttypQualifikationsanforderung.objekttyp_id == objekt.objekttyp_id)
+            )
+        )
+        .scalars()
+        .all()
+    )
+    if not erforderlich:
+        return []
+
+    heute = date.today()
+    gueltige_ids = set(
+        (
+            await db.execute(
+                select(BenutzerQualifikation.qualifikationstyp_id).where(
+                    BenutzerQualifikation.benutzer_id == benutzer_id,
+                    (BenutzerQualifikation.gueltig_bis.is_(None))
+                    | (BenutzerQualifikation.gueltig_bis >= heute),
+                )
+            )
+        )
+        .scalars()
+        .all()
+    )
+    return [q for q in erforderlich if q.id not in gueltige_ids]