# AK-P17a · P17 HR-Kern (Stammdaten, Doku, Passwort-Safe) | | | |---|---| | **Typ** | Dev (Code) | | **Owner** | Akeshan | | **Phase** | P17 — HR-Hub | | **Cycle/Fenster** | W2 — Plattform & CRM (Demo 1) · fällig 2026-06-25 · Gate W2 | | **Status** | geplant | ## Abhängigkeiten & Parallelität - **Blocked by:** `AK-P4b` (Files/Tasks + EntityLink — HR-Dokumente hängen an Files) - **Blocks:** `AK-P17b` (Urlaub/Krank/Surveys) - **Läuft parallel zu:** Raffaels Kern-Kette (P6/P7). **HR hängt nur an P1/P2** (User/RLS/Verschlüsselungs-Fundament) — KEINE Abhängigkeit von R-P5/R-P6, daher früh in W2 baubar. Eigene `prisma/schema/hr.prisma` (AD-21); `core.prisma` nur für User-Relation berührt. - **Konflikt-Risiko:** keines auf Schema-Ebene — disjunkte HR-Domäne. ## Was wir bauen Den **verschlüsselten HR-Kern** (Quiply-Ablösung): **MA-Stammdaten** (HrEmployeeProfile, Standorte), **Personaldokumente** und den **verschlüsselten Team-Passwort-Safe**. Sensible Daten liegen **AES-256-GCM** mit KMS-backed Envelope-Encryption (AD-8) vor; sensible Tabellen haben **zusätzlich** zum RLS einen App-Permission-Layer — Werte werden **nie automatisch angezeigt** (Reveal on-demand + Audit-Eintrag). Strikte Trennung **MA-Sicht** (eigener Bereich, eigene Daten) vs. **HR-Admin-Sicht** (`/admin/hr/...`). Passwort-Safe: Werte nie in der Liste, Reveal/Copy entschlüsselt on-demand mit Permission-Check, Copy mit 30s-Auto-Clear, DSGVO-Export. ## Benötigte Screens (Backend bedient — Design liefert `D-HR`) | Screen [Route] | Kern-Inhalt | |---|---| | HR-Hub-Start [`/hr`] | Angepinnte Announcements, offene Pflichten, eigene Anträge, Team heute (gegated), Geburtstage, Quick-Links, prominente Aktionen | | MA-Verzeichnis + Detail [`/hr/directory`, `/:userId`] | Karten/Tabelle (Avatar/Name/Position/Team/Standort), Click-to-Call/Mail/Chat; Detail: Stammdaten, Notfallkontakt (nur self/HR), Inline-Edit selbst-pflegbarer Felder, eigene Dokumente | | Standorte + Detail [`/hr/locations`, `/:id`] | Karten/Tabelle (Name/Adresse/Map/MA-Anzahl/Bild); Admin: anlegen/bearbeiten/Default/Bulk-Reassign | | Eigene Dokumente [`/hr/my-documents`] | Liste (Titel/Art/Datum/Gültigkeit) + Filter, Upload eigener Dokumente, File-Viewer; vom Büro hochgeladene = read-only | | Passwort-Safe [`/hr/password-safe`] | Vault-Liste → Eintrags-Liste (Titel/Tags, **keine Werte!**) → Detail mit **Reveal je Wert** (audit-geloggt), Copy mit 30s-Auto-Clear, Access-Verwaltung, Audit-Log | | Passwort-Safe-Verwaltung [`/admin/hr/password-safe`] | Tenant-weite Vault-Sicht (ohne Inhalts-Access), Vault-Anlage/Archiv/Delete, Access-Verwaltung, Audit-Log-Übersicht | ## Definition of Done - [ ] **HR-Profile/Dokumente AES-256-GCM** (KMS-Envelope-Encryption, AD-8) - [ ] **MA-Bereich vs. HR-Admin-Bereich strikt getrennt**; sensible Tabellen zusätzlich App-Permission-gegated - [ ] **Verschlüsselter Passwort-Safe mit Audit-Trail**: Reveal/Copy entschlüsselt on-demand + Permission-Check + Audit-Eintrag; Werte nie in Liste; Copy mit 30s-Auto-Clear; DSGVO-Export - [ ] MA-Verzeichnis + Standorte (Admin-CRUD) + eigene Dokumente (Upload + read-only Büro-Uploads) - [ ] Konnektor `tenantHasModule('hr')`; RLS auf allen Tenant-Tabellen; sensible Felder verschlüsselt ## Technische Bausteine - **Entities** (eigene `prisma/schema/hr.prisma`): `HrEmployeeProfile` (user_id 1:1, personal_number, hire_date, position, team, location_id, manager_user_id, emergency_contact_*), `HrLocation` (name, address_*, geo, image_file_id), `HrEmployeeDocument` (employee_user_id, document_kind, file_id, visibility), `HrResource`/`HrQuickLink`, `EmployeePasswordSafeVault` (+ `Entry`/`Access` — username/password/notes **AES-256-GCM**, permission_level read/write/admin). `core.prisma` nur für User-Relation (AD-21). - **Verschlüsselung**: KMS-backed Envelope (per-Tenant-DEK, AD-8); Reveal entschlüsselt on-demand mit Permission-Check + `AuditEntry`. - **App-Permission-Layer** oben auf RLS für sensible Tabellen (Werte nie in Listen, Reveal-gated). - **Konnektor** `tenantHasModule('hr')`; `is_demo_data` auf Demo-Profilen/-Standorten. - Dokumente via Files/FileEntityLink (AK-P4a/b). ## Quellen (granular) - `ENTITY-MODEL.md` → **Domäne 10: HR-Hub** (HrEmployeeProfile, HrLocation, HrEmployeeDocument, HrResource/QuickLink, EmployeePasswordSafeVault — viel Verschlüsselung) - `REQUIREMENTS.md` → `REQ-hr-datenmodell`, `REQ-hr-passwort-safe` - `ROADMAP.md` → Phase 17 · `PHASE-SOURCES.md` → Phase 17 (M133-stammdaten, M134-dokumente; M138 Drittanbieter-Onboarding → v2) - `designer-briefs/P17-hr-hub.md` (MA- vs. HR-Admin-Trennung, Passwort-Safe-Reveal, sensible Daten) - `_bmad-output/specs/M14-hr-hub.md` ## Dev-Nachzug (nach Davids `D-HR`-Delta) - [ ] Spec/ENTITY-MODEL an Davids UI-Entscheidungen angepasst - [ ] REQUIREMENTS/PHASE-SOURCES nachgezogen - [ ] Plane-Ticket `AK-P17a` aktualisiert