Mitarbeiter — Personalakte (Sub-Route)

Zweck

Sub-Route /employees/:id/documents ist die digitale Personalakte eines Mitarbeiters — Bewerbungsunterlagen, Verträge, Lohnabrechnungen, Krankheits-Bescheinigungen, Schulungszeugnisse. Verknuepfung über DocumentParent mit parentType = Employee.

Wegen sensibler Inhalte ist der Zugriff oft strenger als andere Doc-Sub-Listen — typischerweise nur HR.

Voraussetzungen

- Berechtigung `view:Employee`, `view:Document`, `view:DocumentParent`. - Für Upload: `create:Document`/`create:DocumentParent`.

Berechtigungen (CASL)

Action	Subject	Wirkung	Keycloak-Rolle
view	FE_Employee, Employee	Detail aufrufbar	—
view/create	Document, DocumentParent	Personalakte pflegen	APP_SPEAMCORE_VIEW/CREATE_DOCUMENT, DOCUMENT_PARENT

Schritt-für-Schritt-Anleitung

1. Mitarbeiter (/employees/:id) → Tab Dokumente.
2. Hochladen — Datei wählen oder per Drag-and-Drop ablegen.
3. Drill-Down via Klick auf Zeile zu /documents/:id.

Anlege-Pattern

Standard-Dokument-Upload (siehe Dokumente und Anhaenge). Erzeugt Document + DocumentParent mit parentType = Employee, parentId = :id.

Typische Inhalte am Mitarbeiter:

• Arbeitsvertrag-PDF (Anhang zum Vertrag)
• Sozialversicherungsausweis
• Steuer-ID, Bankverbindung
• Schulnachweise, Zertifikate (zusaetzlich zu strukturierten Compliance-Checks)
• Interne Personalakten

**Datenschutz:** Mitarbeiter-Dokumente sind oft personenbezogen sensibel. CASL-Zugriff sollte auf `update:Employee` (Vorgesetzter, HR) eingeschraenkt sein — Standardrolle „Mitarbeiter" sieht eigene, aber nicht fremde Mitarbeiter-Dokumente.

Wiederverwendbare Konzepte

• Dokumente und Anhaenge
• Berechtigungen verstehen (CASL)

Verknuepfungen zu anderen Modulen

• Mitarbeiter — Eltern-Modul.
• Document-Center — globale Sicht.
• Documents — Detail.

API/Schnittstellen

Methode	Endpoint	Zweck	CASL
GET	/api/document-parents?filter[parentType=Employee]	Personalakte	view DocumentParent
POST	/api/documents	Upload	create Document

Versionshinweise

• 2026-04-30: Initiale Veroeffentlichung.