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

5.9 KiB

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