MABEA/arbeitskacheln/12_personnel.md

# Epic 12 — Personnel

Details zu PERS-001 … PERS-007 (vollständig).

---

## PERS-001 — Person (fachlich)

- **Ziel:** Fachliches Konzept einer Person, getrennt vom technischen Login.
- **Beschreibung:** Person-Entität (Name, Geburtsdatum optional, Kontaktdaten) — kann
  existieren OHNE Systemzugang (z.B. Jugendgruppe, externe Kontaktperson).
- **Benutzerwert:** Nicht jede Person im System braucht einen Login (Kinder/Jugendliche,
  externe Helfer ohne digitale Nutzung).
- **Abhängigkeiten:** FOUND-002
- **Datenmodell:** `person` (id, name, geburtsdatum, kontakt)
- **Backend:** CRUD
- **Frontend:** Verwaltung
- **Mobile:** Anzeige
- **QR-Code/Seriennummer/Inventarnummer:** nein (Person ist keine physische Ressource im
  engeren Sinn — ein optionaler QR-Ausweis wäre ein Erweiterungspunkt, kein Kern)
- **Akte:** eigene Personen-Akte möglich (eigenes Konzept, nicht Ressourcen-Akte)
- **Rechte:** Administrator
- **Audit:** Änderung geloggt
- **Akzeptanzkriterien:** Person ohne Benutzerkonto anlegbar.
- **Tests:** CRUD-Test, Test „Person ohne Benutzer funktioniert".
- **DoD:** ✅ umgesetzt (2026-09-08) — echter Bedarf via AskUserQuestion bestätigt,
  danach live deployed. `Person`-Modell (Migration 0034 mit Backfill bestehender
  Benutzer), `/personen`-CRUD, Admin-UI `PersonSection.tsx`.

## PERS-002 — Benutzer (technisch, verknüpft)

- **Ziel:** Systemzugang, verknüpft mit einer Person.
- **Beschreibung:** `Benutzer` (login, passwort_hash) referenziert optional eine Person
  (1:1 oder 1:0..1).
- **Benutzerwert:** Systemzugang bleibt wie gehabt, aber fachlich sauber von der
  Personen-Stammdatenverwaltung getrennt.
- **Abhängigkeiten:** PERS-001, FOUND-003
- **Datenmodell:** `benutzer.person_id` (FK, optional während Übergang)
- **Backend:** Migration bestehender Benutzer zu Person-Datensätzen
- **Frontend:** Benutzeranlage erzeugt/verknüpft Person
- **Mobile:** kein Unterschied
- **QR-Code/Seriennummer/Inventarnummer:** nein
- **Akte:** nein direkt
- **Rechte:** bestehende Rechte-Logik unverändert
- **Audit:** Verknüpfung geloggt
- **Akzeptanzkriterien:** bestehende Benutzer funktionieren nach Migration unverändert.
- **Tests:** Migrationstest (keine Datenverluste), Regressionstest bestehender
  Auth-Flows.
- **DoD:** ✅ umgesetzt (2026-09-08) — `Benutzer.person_id` FK (nullable), `/benutzer`
  verknüpft bestehende Person oder legt automatisch neue Person an, wenn keine
  `person_id` angegeben wird (Backward-Kompatibilität). Backfill bestehender Benutzer
  via `ROW_NUMBER()`-1:1-Positionsmatch statt Name-Join (Namenskollisionen vermieden).

## PERS-003 — Einheiten/Organisationsstruktur

- **Ziel:** Hierarchische Gliederung von Personen in Züge/Gruppen.
- **Beschreibung:** Einheit mit optionaler übergeordneter Einheit, Person/Benutzer gehört
  zu einer Einheit.
- **Benutzerwert:** Organisationsstruktur abbildbar (Zug → Gruppe → Trupp).
- **Abhängigkeiten:** PERS-001 (oder direkt Benutzer, falls PERS-001 zurückgestellt)
- **Datenmodell:** `einheit` (id, name, uebergeordnete_einheit_id, standort_id)
- **Backend:** CRUD
- **Frontend:** Verwaltung
- **Mobile:** Anzeige
- **QR-Code/Seriennummer/Inventarnummer:** nein
- **Akte:** Verantwortlichkeitsbereich (FILE-004) referenziert Einheit
- **Rechte:** Administrator
- **Audit:** Änderung geloggt
- **Akzeptanzkriterien:** mehrstufige Hierarchie anlegen (Zug→Gruppe).
- **Tests:** Baum-Test.
- **DoD:** deckt sich mit MABEA (`Einheit`-Modell bereits umgesetzt, self-referenzierend)
  — allerdings bisher nur eine Ebene in der Praxis genutzt, mehrstufige Hierarchie ist
  technisch möglich aber ungetestet im echten Einsatz.

## PERS-004 — Funktionen/Rollen im Einsatzkontext

- **Ziel:** Fachliche Funktion einer Person innerhalb einer Einheit (Zugführer, Melder,
  Fahrer, ...) — unterscheidet sich von System-Rollen (Rechte).
- **Beschreibung:** Funktion als Stammdatum, Zuordnung Person↔Einheit↔Funktion.
- **Benutzerwert:** „Wer ist der Zugführer von Zug 3" beantwortbar, unabhängig von
  Systemrechten.
- **Abhängigkeiten:** PERS-003
- **Datenmodell:** `funktion` (id, name), `einheit_mitgliedschaft` (person_id,
  einheit_id, funktion_id)
- **Backend:** CRUD
- **Frontend:** Zuordnung
- **Mobile:** Anzeige
- **QR-Code/Seriennummer/Inventarnummer:** nein
- **Akte:** Verantwortlichkeitsbereich
- **Rechte:** Administrator/Zugführer
- **Audit:** Änderung geloggt
- **Akzeptanzkriterien:** Person mit Funktion in Einheit zuordnen.
- **Tests:** CRUD-Test.
- **DoD:** komplett neu in MABEA — Einheit-Zuordnung existiert (`Benutzer.einheit_id`),
  aber keine fachliche Funktion/Rolle INNERHALB der Einheit (nur System-Rollen wie
  „Materialverantwortlicher" existieren — das ist etwas anderes als „Zugführer von
  Zug 3").

## PERS-005 — Qualifikationen/Lehrgänge

- **Ziel:** Nachgewiesene Qualifikationen einer Person.
- **Beschreibung:** Qualifikationstyp-Katalog + Zuordnung mit Erwerbsdatum/Gültigkeit.
- **Benutzerwert:** Nachweis von Ausbildungsstand.
- **Abhängigkeiten:** PERS-001
- **Datenmodell:** `qualifikationstyp`, `benutzer_qualifikation`
- **Backend:** CRUD
- **Frontend:** Verwaltung
- **Mobile:** Anzeige
- **QR-Code/Seriennummer/Inventarnummer:** nein
- **Akte:** eigener Bereich (Personen-Akte)
- **Rechte:** Administrator
- **Audit:** Änderung geloggt
- **Akzeptanzkriterien:** Qualifikation mit Gültigkeit erfassen.
- **Tests:** CRUD-Test.
- **DoD:** deckt sich 1:1 mit MABEA (`Qualifikationstyp`/`BenutzerQualifikation` bereits
  umgesetzt, inkl. Ablauf-Dashboard-Kachel).

## PERS-006 — Führerscheine/Berechtigungen mit Gültigkeit

- **Ziel:** Spezialfall von PERS-005 — Fahrerlaubnis, die bestimmt, wer welches Fahrzeug
  fahren darf.
- **Beschreibung:** Führerschein als Qualifikationskategorie, Verknüpfung zu
  AssetType-Anforderung.
- **Benutzerwert:** „Wer darf dieses Fahrzeug fahren" automatisch beantwortbar.
- **Abhängigkeiten:** PERS-005, ASSET-002
- **Datenmodell:** `objekttyp_qualifikationsanforderung` (M:N)
- **Backend:** Berechtigungsprüfungs-Endpunkt
- **Frontend:** Anzeige „fehlende Qualifikation"
- **Mobile:** Anzeige vor Fahrtantritt
- **QR-Code/Seriennummer/Inventarnummer:** nein
- **Akte:** Fahrzeug-Akte zeigt erforderliche Qualifikation
- **Rechte:** wie Lese-Recht
- **Audit:** nein zusätzlich
- **Akzeptanzkriterien:** Prüfung liefert korrekt berechtigt/nicht berechtigt + fehlende
  Typen.
- **Tests:** Berechtigungstest (mit/ohne/abgelaufene Qualifikation).
- **DoD:** deckt sich 1:1 mit MABEA — bereits umgesetzt und in dieser Session live gegen
  den Produktivserver getestet (`GET /objekte/{id}/berechtigung/{benutzer_id}`).

## PERS-007 — Qualifikationsablauf-Warnungen

- **Ziel:** Frühwarnung vor ablaufenden Qualifikationen.
- **Beschreibung:** Dashboard-Kachel analog Prüftermine/Ablaufdaten.
- **Benutzerwert:** Rechtzeitig Nachschulung planen, bevor jemand mit abgelaufener
  Qualifikation eingeteilt wird.
- **Abhängigkeiten:** PERS-006
- **Datenmodell:** keins neu
- **Backend:** Abfrage bevorstehender Abläufe
- **Frontend:** Dashboard-Kachel
- **Mobile:** Anzeige
- **QR-Code/Seriennummer/Inventarnummer:** nein
- **Akte:** nein (übergreifende Sicht)
- **Rechte:** Verantwortliche
- **Audit:** nein
- **Akzeptanzkriterien:** korrekte Sortierung, 60 Tage Standard-Vorlauf.
- **Tests:** Schwellenwerttest.
- **DoD:** deckt sich 1:1 mit MABEA
  (`dashboard.bevorstehende_qualifikationsablaeufe()`, bereits umgesetzt).

---

**MABEA-Ist-Stand-Abgleich (aktualisiert 2026-09-09):** PERS-001…003, 005, 006, 007
sind vollständig in MABEA umgesetzt und live deployed. PERS-001/002 (Person↔Benutzer-
Trennung) waren der größte offene Architekturentscheid im gesamten Backlog — echter
Bedarf wurde am 2026-09-08 bestätigt, danach umgesetzt und deployed (Details siehe
PERS-001/002 oben). **PERS-004
(fachliche Funktion innerhalb einer Einheit, z.B. „Zugführer") fehlt komplett** — leicht
zu verwechseln mit den bestehenden System-Rollen, ist aber ein eigenständiges Konzept.