55 lines
4.8 KiB
Markdown
55 lines
4.8 KiB
Markdown
# 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
|