Files
HiveGrid-Wireframes/03 Quellen und Referenzen/hivegrid-cloud/.planning/ticket-docs/D-HR.md
T

70 lines
7.8 KiB
Markdown

# D-HR · HR-Compose-Screens
| | |
|---|---|
| **Typ** | Screen (Design) |
| **Owner** | David |
| **Phase** | P17 — HR-Hub (bedient `AK-P17a`/`AK-P17b`) |
| **Cycle/Fenster** | W2 — Plattform & CRM (Demo 1) · 2026-06-25 → fällig 2026-06-26 |
| **Status** | geplant |
> 🟩 **Compose-Ticket:** deckt **alle HR-Screens** (P17). Reines Compose aus A2/A3/A4/A5/A6/A7 — kein Bespoke. **Wiederverwenden statt neu bauen:** M05-Form-Renderer aus P16 (Urlaub/Krank/Requests), KPI-Kacheln + Charts.
> 🟡 **Sehr breites Modul, sensible Daten — strenge Permission-Gates.** Quiply-Komplett-Ablösung. Trennung beachten: **MA-Sicht** (eigener Bereich, eigene Daten) vs. **HR-Admin-Sicht** (`/admin/hr/...`, alle MA). Sensible Tabellen (Lohnabrechnung, Krank-AU, Passwort-Safe, Personaldokumente) haben **zusätzlich** zum RLS einen App-Permission-Layer — Werte nie automatisch angezeigt (Reveal + Audit-Log). Surveys bleiben v1; Memberspot/Boobora-Onboarding-Drittanbieter → v2.
## Abhängigkeiten & Parallelität
- **Blocked by:** `D-D0b` (Archetypen, KPI-Kacheln, Charts)
- **Blockt:** —
- **Bedient (Dev):** `AK-P17a`/`AK-P17b` (M14 HR-Hub)
- **Subframe:** Pflicht je Route. Archetypen aus D0; M05-Form-Renderer aus P16 einbetten (nicht neu bauen).
**UX-Nachzug (2026-07-25):** `R-UX3` konkretisiert Personal als **Für mich / Mein Team /
Verwaltung**; `R-UX4` konkretisiert Passwörter als eigenständigen Hauptbereich. D-HR bleibt
Designquelle für beide Flächen. Bis zum finalen Delta gilt AD-28; die historische D-HR-Spec wird
nicht überschrieben.
## Was wir bauen
Den **kompletten HR-Hub**: persönlicher MA-Bereich + Announcements, Urlaubs-/Krankmeldungs-Workflow, Lohnabrechnungen, MA-Anträge, verschlüsselter Passwort-Safe, Surveys, MA-Verzeichnis + Standorte, eigene Dokumente — plus die HR-Admin-Flächen (`/admin/hr/...`).
## Benötigte Screens
| Screen [Route] | Kern-Inhalt | Archetyp |
|---|---|---|
| HR-Hub-Start [`/hr`] | Angepinnte Announcements, offene Bestätigungs-/Upload-Pflichten, eigene pendente Anträge, Team heute (Urlaub/krank, gegated), Geburtstage, letzte Lohnabrechnung-Hinweis, Quick-Links · prominente Aktionen „Krank melden / Urlaub beantragen / Antrag stellen" | Compose aus KPI + Listen |
| Announcements + Detail [`/hr/announcements`, `/:id`] | Feed mit Pinned-Sektion + Ungelesen-Filter · Detail: Markdown, Anhänge, Reaktionen (gruppiert), Kommentare (1 Ebene), **Bestätigungs-Button + Read-Receipt-Tabelle** (nur Autor/HR) | A2 / A3 |
| 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-Kacheln | A2 + A4 + A5 |
| Lohnabrechnungen [`/hr/payslips`, `/admin/hr/payslips`] | Eigene: Liste nach Periode + PDF-Viewer (Öffnen setzt gelesen) · Admin: alle MA + Einzel-/Bulk-Upload mit **Auto-Match-Vorschau** (hart/weich/kein Match, Farb-Konfidenz) | A2 |
| MA-Anträge [`/hr/requests`] | Template-Wahl (Spesen, Hardware, Schulung, Zeugnis, sonstiges), M05-Form, Genehmiger-Vorauswahl, Priorität, Anhänge · Detail: Kommentar-Stream (interne Notizen verborgen für Requester), Entscheidung | A2 / A3 |
| Passwort-Safe [`/hr/password-safe`] | Vault-Liste (nur mit Access) → Eintrags-Liste (Titel, Tags — **keine Werte!**) → Eintrags-Detail: **Reveal-Button je Wert** (audit-geloggt), Copy mit 30s-Auto-Clear, Access-Verwaltung (nur Vault-Admin), Audit-Log-Anzeige | A2 / A3 + Reveal |
| Surveys [`/hr/surveys`] | Teilnahme: Items (Text/Rating/NPS/Choice/Boolean/Datum) · Auswertung (`/results`, gegated): Häufigkeits-Charts, Durchschnitte, Textantworten · Admin-Editor mit Audience + Sichtbarkeit + Anonymität | A4 + Charts |
| MA-Verzeichnis + MA-Detail [`/hr/directory`, `/:userId`] | Karten/Tabelle: Avatar, Name, Position, Team, Standort · Click-to-Call/Mail/Chat · Detail: Stammdaten, Notfallkontakt (nur self/HR), Inline-Edit der selbst-pflegbaren Felder, eigene Dokumente | A2 / A3 |
| Standorte + Detail [`/hr/locations`, `/:id`] | Karten/Tabelle: Name, Adresse, Telefon, Map-Vorschau, MA-Anzahl, Beschreibung, Bild · Admin: anlegen/bearbeiten/Default/Bulk-Reassign | A2 / A3 |
| Eigene Dokumente [`/hr/my-documents`] | Liste (Titel, Art, Datum, Gültigkeit) + Filter, Upload eigener Dokumente, File-Viewer; vom Büro hochgeladene = read-only | A2 |
| Upload-Erinnerungen-Verwaltung [`/admin/hr/upload-reminders`] | Reminder-Liste (Titel, Cadence, Audience, pendend/überfällig) · Editor (Dokumentart, Cadence, Mandatory, Linked-Form) · Detail mit Dispatch-Liste | A2 + A6 |
| Request-Templates [`/admin/hr/request-templates`] | Template-Liste · Editor: Name, Kind, Default-Approver-Logik, Linked-Form, Instructions, Audience · SHK-Defaults geseedet | A2 + A6 |
| Announcement-Verwaltung [`/admin/hr/announcements`] | Alle (inkl. Draft/archiviert) · Editor: Titel, Markdown-Body, Audience-Wahl, Acknowledgement-Toggle, Reactions/Comments-Toggle, Anhänge, Pin, geplante Veröffentlichung, Ablauf | A2 + A4 |
| Passwort-Safe-Verwaltung [`/admin/hr/password-safe`] | Tenant-weite Vault-Sicht (auch ohne Inhalts-Access), Vault-Anlage/Archiv/Delete, Access-Verwaltung, Audit-Log-Übersicht (Reveals nach User/Vault) | A2 + A6 |
*(Mitarbeiter-Einladung/Rollen → P2-Admin. Plantafel → P9 (`D-PLAN`). Dashboard-HR-Widgets → P11 (`D-DASH`). Click-to-Call/Chat-Start → P15.)*
## Features (muss abgedeckt sein)
- [ ] HR-Daten AES-256-GCM-verschlüsselt; sensible Felder KMS-backed Envelope-Encryption (AD-8)
- [ ] MA-Bereich vs. HR-Admin-Bereich strikt getrennt; sensible Tabellen zusätzlich App-Permission-gegated (Standard-MA sieht „krank von X bis Y" — keine Diagnose/AU-Inhalte)
- [ ] Verschlüsselter Passwort-Safe mit Audit-Trail (Reveal/Copy on-demand + Audit; Werte nie in Liste; Copy 30s-Auto-Clear; DSGVO-Export)
- [ ] Urlaubs-Approval-Workflow + Krankmeldungs-Erfassung → speisen Abwesenheits-Kalender (M25) + Plantafel-Konflikte (M04)
- [ ] Lohnabrechnungs-Bulk-Upload mit Pattern-Auto-Match (Konfidenz), Read-Tracking, Audit pro Read
- [ ] Upload-Erinnerungen mit Cadence + Eskalation; Announcements mit Acknowledgement + Read-Receipt + Reaktionen/Kommentare; Surveys (anonym möglich)
- [ ] Anträge laufen als M05-Form-Submissions (Form-Renderer aus P16 wiederverwenden); Mobile-Default-Tab für Monteure
## UI-Elemente (Liste, KEIN Layout — Anordnung = Davids freie Hand)
KPI-Kacheln (heute krank / im Urlaub / pendente Genehmigungen / offene AU); Card-/Widget-Hub mit Tab-Navigation (nur sichtbare Tabs je Permission); Announcement-Feed mit Pinned-Sektion; Markdown-Renderer + -Editor; Reaktions-Picker (Emoji); Kommentar-Liste mit Reply; Read-Receipt-Tabelle (gegated); Acknowledgement-Button mit Counter; M05-Form-Renderer (eingebettet); Genehmiger-Aktions-Buttons (Approve/Reject/Rückfrage) mit Konflikt-Hinweis-Banner; verschlüsselter File-Upload mit Vertraulichkeits-Marker; Monatskalender-Abwesenheits-Sicht; PDF-Viewer + Download; Bulk-Upload-Dropzone mit Match-Vorschau-Tabelle (Farb-Konfidenz); Vault-Liste/Kacheln; Eintrags-Liste ohne Werte; Reveal-Button je Wert; Copy-mit-Auto-Clear; Audit-Log-Tabelle; Template-Editor mit Approver-Logik-Selector; Survey-Item-Renderer + Auswertungs-Charts; MA-Karten/Tabelle mit Click-to-Call/Mail/Chat; Standort-Karte mit Map-Vorschau; Dispatch-Status-Liste; Empty-/Loading-/Fehler-/Permission-Denied-/Offline-States (Klartext mit Lösungs-Knopf).
## Quellen (granular)
- `designer-briefs/P17-hr-hub.md` (vollständiger Brief — alle HR-Screens, diese Doc ist sein Ticket-Destillat)
- `ENTITY-MODEL.md` → Domäne 10 (HR-Hub)
## Davids Delta (David füllt aus)
- [ ] Überschriebene/geänderte Spec-Punkte:
- [ ] Neue UI/UX-Entscheidungen:
- [ ] Subframe-Screen-Link(s):
- [ ] Offene Fragen an Dev: