Files
HiveGrid-Wireframes/hivegrid-cloud/.planning/ticket-docs/AK-P17a.md
T

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.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