Mitarbeiter — Compliance-Checks (Sub-Route)

Zweck

Sub-Route /employees/:id/compliance-checks zeigt alle Compliance-Checks des Mitarbeiters — typische Inhalte: jaehrliche Sicherheitsunterweisung, Datenschutz-Schulung, fachliche Befaehigungs-Nachweise mit Ablaufdatum.

Voraussetzungen

- Berechtigung `view:Employee` und `view:ComplianceCheck`. - Für Anlegen: `create:ComplianceCheck`.

Berechtigungen (CASL)

Action	Subject	Wirkung	Keycloak-Rolle
view	FE_Employee, Employee, FE_ComplianceCheck, ComplianceCheck	Liste sichtbar	—
create	ComplianceCheck	Pruefnachweis anlegen	APP_SPEAMCORE_CREATE_COMPLIANCE_CHECK

Schritt-für-Schritt-Anleitung

1. Mitarbeiter (/employees/:id) → Tab Compliance.
2. + Check → Compliance-Pruefungs-Vorlage wählen aus dem Stamm /compliance-checks (z. B. „Sicherheitsunterweisung", „G42-Untersuchung", „Erste-Hilfe-Kurs", „SCC-Pass").
3. Pruefungs-Datum (completedAt), Gültigkeit (validUntil), ggf. PDF-Nachweis hochladen.
4. Reminder-Workflow:
   • 30 Tage vor validUntil → Notification an Mitarbeiter UND Vorgesetzten.
   • 7 Tage vor validUntil → Eskalation an HR-Verantwortlichen.
   • Nach validUntil → Status = expired, Mitarbeiter darf bestimmte Tätigkeiten nicht mehr ausführen (z. B. „G42-abgelaufen → Hochregal-Lager-Sperre").

Status-Indikator im DataGrid

Die Compliance-Liste hat eine Status-Ampel je Zeile, die abhaengig vom Verhaeltnis validUntil zu heute eingefaerbt wird:

Farbe	Bedingung	Bedeutung
🟢 Gruen	validUntil > heute + 30 Tage	Pruefnachweis aktuell, kein Handlungsbedarf.
🟡 Gelb	heute + 7 Tage <= validUntil <= heute + 30 Tage	Bald faellig — Termin für Nachpruefung organisieren.
🟠 Orange	heute < validUntil <= heute + 7 Tage	Dringend — letzte Woche, Eskalation laeuft.
🔴 Rot	validUntil < heute	Abgelaufen — Mitarbeiter ggf. aus relevanten Aufträgen abziehen, bis erneuert.

**Compliance steuert Auftrags-Eligibility:** In Aufträgen mit Anforderung `requireCompliance = true` (z. B. Höhenarbeit erfordert G41) duerfen nur Mitarbeiter zugeordnet werden, die einen aktiven Compliance-Check des passenden Typs haben. Das ist eine zentrale Sicherheits- und Compliance-Funktion für regulierte Branchen.

Wiederverwendbare Konzepte

• Berechtigungen verstehen (CASL)

Verknuepfungen zu anderen Modulen

• Mitarbeiter — Eltern-Modul.
• Compliance-Checks — globale Sicht und Vorlagen.
• Notification-Events — Erinnerung bei Ablauf.
• Kurs-Anmeldungen — Prüfungen sind oft an Kurse geknuepft.

API/Schnittstellen

Methode	Endpoint	Zweck	CASL
GET	/api/compliance-checks?filter[employeeId]	Liste	view ComplianceCheck
POST	/api/compliance-checks	Anlegen	create ComplianceCheck

Versionshinweise

• 2026-04-30: Initiale Veroeffentlichung.