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

backend/app/schemas/benutzer.py

@@ -9,6 +9,7 @@ class BenutzerCreate(BaseModel):
     passwort: str
     email: str | None = None
     rollen: list[RolleTyp] = []
+    einheit_id: int | None = None
 
 
 class BenutzerRead(BaseModel):
@@ -19,6 +20,7 @@ class BenutzerRead(BaseModel):
     email: str | None
     aktiv: bool
     rollen: list[str]
+    einheit_id: int | None
 
     @classmethod
     def from_orm_benutzer(cls, benutzer) -> "BenutzerRead":
@@ -29,6 +31,7 @@ class BenutzerRead(BaseModel):
             email=benutzer.email,
             aktiv=benutzer.aktiv,
             rollen=benutzer.rollen_namen,
+            einheit_id=benutzer.einheit_id,
         )
 
 
@@ -37,3 +40,4 @@ class BenutzerUpdate(BaseModel):
     email: str | None = None
     aktiv: bool | None = None
     rollen: list[RolleTyp] | None = None
+    einheit_id: int | None = None

backend/app/schemas/personal.py

@@ -0,0 +1,82 @@
+import uuid
+from datetime import date
+
+from pydantic import BaseModel, ConfigDict
+
+from app.models.personal import Qualifikationskategorie
+
+
+class EinheitCreate(BaseModel):
+    name: str
+    uebergeordnete_einheit_id: int | None = None
+    standort_id: int | None = None
+
+
+class EinheitRead(BaseModel):
+    model_config = ConfigDict(from_attributes=True)
+    id: int
+    name: str
+    uebergeordnete_einheit_id: int | None
+    standort_id: int | None
+
+
+class EinheitUpdate(BaseModel):
+    name: str | None = None
+    uebergeordnete_einheit_id: int | None = None
+    standort_id: int | None = None
+
+
+class QualifikationstypCreate(BaseModel):
+    name: str
+    kategorie: Qualifikationskategorie
+    gueltigkeit_monate: int | None = None
+
+
+class QualifikationstypRead(BaseModel):
+    model_config = ConfigDict(from_attributes=True)
+    id: int
+    name: str
+    kategorie: Qualifikationskategorie
+    gueltigkeit_monate: int | None
+
+
+class QualifikationstypUpdate(BaseModel):
+    name: str | None = None
+    kategorie: Qualifikationskategorie | None = None
+    gueltigkeit_monate: int | None = None
+
+
+class BenutzerQualifikationCreate(BaseModel):
+    benutzer_id: int
+    qualifikationstyp_id: int
+    erworben_am: date
+    gueltig_bis: date | None = None
+    nachweis_nummer: str | None = None
+
+
+class BenutzerQualifikationRead(BaseModel):
+    model_config = ConfigDict(from_attributes=True)
+    id: uuid.UUID
+    benutzer_id: int
+    qualifikationstyp_id: int
+    erworben_am: date
+    gueltig_bis: date | None
+    nachweis_nummer: str | None
+
+
+class ObjekttypQualifikationsanforderungCreate(BaseModel):
+    objekttyp_id: int
+    qualifikationstyp_id: int
+
+
+class ObjekttypQualifikationsanforderungRead(BaseModel):
+    model_config = ConfigDict(from_attributes=True)
+    objekttyp_id: int
+    qualifikationstyp_id: int
+
+
+class BerechtigungspruefungRead(BaseModel):
+    """Antwort auf "darf Benutzer X Objekt Y bedienen/fahren?" (Nutzer-Beispiel)."""
+
+    berechtigt: bool
+    fehlende_qualifikationstypen: list[QualifikationstypRead]