# AK-P17b · P17 HR Urlaub/Krank + Surveys + Self-Service | | | |---|---| | **Typ** | Dev (Code) | | **Owner** | Akeshan | | **Phase** | P17 — HR-Hub | | **Cycle/Fenster** | W2 — Plattform & CRM (Demo 1) · fällig 2026-06-26 · Gate W2 | | **Status** | geplant | ## Abhängigkeiten & Parallelität - **Blocked by:** `AK-P17a` (HR-Kern + Verschlüsselungs-Pattern + MA/Admin-Trennung) - **Blocks:** `R-P9b` (Abwesenheiten → Plantafel-Konflikt-Indikatoren) - **Läuft parallel zu:** Raffaels Kern-Kette. **HR hängt nur an P1/P2**; nutzt den Form-Renderer (M05) — der kommt erst in P16 (AK-P16c), liegt aber zeitlich **nach** P17. **Pragma:** Urlaub/Krank/Requests werden als M05-Form-Templates modelliert; bis der Renderer aus P16 steht, dienen schlanke HR-eigene Formulare als Übergang (Nachzug-Punkt). Eigene `prisma/schema/hr.prisma` (gleicher Namespace, additiv — AD-21). - **Konflikt-Risiko:** keines auf Schema-Ebene; Calendar-Relation (M25) über `calendar_event_id` (P16) — read-only. ## Was wir bauen Die **HR-Workflows**: einen **mehrstufigen Urlaubs-Approval-Workflow** (submitted/approved/rejected/withdrawn + Rückfrage) mit **Abwesenheits-Kalender** und **Plantafel-Konflikt-Hinweisen**, **Krankmeldung** (selbst oder durch Büro im Auftrag) mit **verschlüsseltem AU-Upload**, **Announcements** (Audience-Targeting, Acknowledgement-Pflicht + Read-Receipt, Reaktionen, Kommentare), **Lohnabrechnungs-Bulk-Upload** mit Dateiname-Auto-Match + Read-Tracking, **Upload-Erinnerungen** (Cadence + Eskalation), generische **Requests** via Templates, **Surveys** (anonym möglich, mit Auswertung) und den **Mitarbeiter-Self-Service** (Web/PWA; Web-Push als Kanal → v2). ## Benötigte Screens (Backend bedient — Design liefert `D-HR`) | Screen [Route] | Kern-Inhalt | |---|---| | Urlaub & Krankmeldung [`/hr/leave`] | Tabs Meine/Genehmigungen/Team; Antrag (M05-Form: Zeitraum/Art/Genehmiger); Genehmiger-Sicht (Approve/Reject/Rückfrage + **Konflikt-Hinweise** Plantafel/vorhandener Urlaub); Krankmeldung (Start, erwartete Rückkehr, **AU-Upload verschlüsselt**); Admin-Monatskalender + KPI | | Announcements + Detail [`/hr/announcements`, `/:id`] · Verwaltung [`/admin/hr/announcements`] | Feed + Pinned + Ungelesen-Filter; Detail mit Markdown/Reaktionen/Kommentare/**Bestätigungs-Button + Read-Receipt-Tabelle**; Editor (Audience, Acknowledgement-Toggle, Pin, geplant, Ablauf) | | Lohnabrechnungen [`/hr/payslips`, `/admin/hr/payslips`] | Eigene Liste + PDF-Viewer (Öffnen = gelesen); Admin: alle MA + Bulk-Upload mit **Auto-Match-Vorschau** (hart/weich/kein, Farb-Konfidenz) | | MA-Anträge [`/hr/requests`] · Request-Templates [`/admin/hr/request-templates`] | Template-Wahl (Spesen/Hardware/Schulung/Zeugnis), M05-Form, Genehmiger-Vorauswahl; Editor mit Approver-Logik + Linked-Form | | Surveys [`/hr/surveys`] | Teilnahme (Text/Rating/NPS/Choice/Boolean/Datum); Auswertung (gegated, Charts); Admin-Editor (Audience/Sichtbarkeit/Anonymität) | | Upload-Erinnerungen-Verwaltung [`/admin/hr/upload-reminders`] | Reminder-Liste (Titel/Cadence/Audience/Status), Editor (Dokumentart/Cadence/Mandatory/Linked-Form), Dispatch-Liste | ## Definition of Done - [ ] **Mehrstufiger Urlaubs-Approval-Workflow** (submitted/approved/rejected/withdrawn + Rückfrage) → speist **Abwesenheits-Kalender** (M25) + **Plantafel-Konflikt-Indikatoren** (R-P9b) - [ ] **Krankmeldung** (selbst/durch Büro) + **AU-Upload verschlüsselt** - [ ] **Announcements** (Audience, Acknowledgement-Pflicht + Read-Receipt, Reaktionen, Kommentare) - [ ] **Lohnabrechnungs-Bulk-Upload** mit Dateiname-Auto-Match (Personalnummer/Name), Match-Vorschau mit Konfidenz, Read-Tracking, Audit pro Read - [ ] **Upload-Erinnerungen** (Cadence once/yearly/every_n_months/on_expiry, Eskalation an Manager) + **Requests** via Templates - [ ] **Surveys** (anonym möglich) mit Auswertung - [ ] **Mitarbeiter-Self-Service** (Web/PWA; Web-Push → v2, AD-17); Anträge als **M05-Form-Submissions** (Renderer aus P16 wiederverwenden) - [ ] Konnektor `tenantHasModule('hr')`; RLS + App-Permission-Gates; sensible Felder verschlüsselt ## Technische Bausteine - **Entities** (eigene `prisma/schema/hr.prisma`, additiv): `EmployeeVacationRequest` (start/end_date, request_kind, status, assigned_approver, calendar_event_id), `EmployeeSickLeaveReport` (start/return_date, certificate_file_id, status — **[verschlüsselt]** AU-Schein), `HrAnnouncement` (+ Read/Reaction/Comment), `EmployeePayslip` (period_year/month, file_id, is_read), `EmployeeUploadReminder` (+ Dispatch), `HrRequest` (+ Template — request_kind, form_submission_id, status, assigned_approver), `HrSurvey` (+ Item/Submission — is_anonymous, submitter_hash). `calendar.prisma`/`forms.prisma` über Relationen (AD-21). - **Approval-Workflow** als State-Machine; Abwesenheits-Sync in `CalendarEvent` (P16); Plantafel-Konflikt-Hinweis-Feed für R-P9b. - **Auto-Match** (Bulk-Payslip): Dateiname-Pattern → Personalnummer/Name, Konfidenz-Klassifizierung; Read-Tracking + Audit. - **Form-Integration**: Urlaub/Krank/Requests als M05-Submissions (AK-P16c-Renderer); Übergangs-Formulare bis Renderer steht. - **RLS** + App-Permission-Gates; AU-Schein verschlüsselt (AD-8); `is_demo_data` auf Demo-Daten. ## Quellen (granular) - `ENTITY-MODEL.md` → **Domäne 10: HR-Hub** (EmployeeVacationRequest, EmployeeSickLeaveReport, HrAnnouncement, EmployeePayslip, EmployeeUploadReminder, HrRequest, HrSurvey) - `REQUIREMENTS.md` → `REQ-hr-urlaub-krank` - `ROADMAP.md` → Phase 17 · `PHASE-SOURCES.md` → Phase 17 (M135-urlaub, M136-krankmeldungen, M137-kommunikation, M139-berichte-lohn-export, M140-selbstbedienung; Surveys bleiben v1, M140 ohne Push) - `designer-briefs/P17-hr-hub.md` (Urlaub/Krank, Lohn-Bulk-Match, Surveys, M05-Renderer wiederverwenden) - `_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-P17b` aktualisiert