58 lines
5.9 KiB
Markdown
58 lines
5.9 KiB
Markdown
# 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
|