4.8 KiB
4.8 KiB
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.prismanur 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.prismanur 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_dataauf 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-safeROADMAP.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-P17aaktualisiert