8.1 KiB
Designer-Brief · P17 — HR-Hub
Phase: 17/21 · Modul: M14 · Owner-Dev: Akeshan (AK-P17a/b) · Designer: David
Quellen: ROADMAP.md §Phase 17 · ENTITY-MODEL.md Domäne 10 (HR-Hub) · SCREEN-MAP.md §3 (HR-Compose-Block) · _bmad-output/specs/M14-hr-hub.md
Subframe: Pflicht je Route. Archetypen aus D0 (A2 Liste, A3 Detail, A4 Form/Input, A5 Modal, A6 Settings, A7 Zustände); Reuse: M05-Form-Renderer (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 werden nie automatisch angezeigt (Reveal + Audit-Log). Urlaub/Krank/Requests laufen über M05-Form-Templates — den Form-Renderer aus P16 hier wiederverwenden, nicht neu bauen. Surveys bleiben v1; Memberspot/Boobora-Onboarding-Drittanbieter → v2.
Was dieses Modul tut (Kurzfassung)
Interner verschlüsselter HR-Hub als Mitarbeiterplattform: persönlicher MA-Bereich, Announcements mit Read-Receipt/Reaktionen/Kommentaren, Urlaubs-Approval- und Krankmeldungs-Workflow (mit Plantafel-Konflikt-Hinweisen), Lohnabrechnungen (Bulk-Upload mit Auto-Match), Upload-Erinnerungen, generische Requests via Templates, MA-Verzeichnis + Standorte, verschlüsselter Team-Passwort-Safe (Reveal audit-geloggt) und HR-Surveys.
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] |
Eigene: Liste nach Periode + PDF-Viewer (Öffnen setzt gelesen) · Admin (/admin/hr/payslips): 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. Dashboard-HR-Widgets → P11. Click-to-Call → P15. Chat-Start → P15.)
Geplante Features (muss abgedeckt sein)
- HR-Profile, Urlaubs-/Krank-/Payslip-/Request-Daten liegen AES-256-GCM-verschlüsselt vor; sensible Felder nutzen KMS-backed Envelope-Encryption (AD-8)
- MA-Bereich vs. HR-Admin-Bereich strikt getrennt; sensible Tabellen zusätzlich zum RLS App-Permission-gegated (Standard-MA/Manager sieht „krank von X bis Y" — keine Diagnose, keine AU-Inhalte)
- Verschlüsselter Passwort-Safe mit Audit-Trail: Reveal/Copy entschlüsselt on-demand mit Permission-Check + Audit-Eintrag; Werte nie in Liste, Copy mit 30s-Auto-Clear; DSGVO-Export
- Mehrstufiger Urlaubs-Approval-Workflow (submitted/approved/rejected/withdrawn, Rückfrage) + Krankmeldungs-Erfassung (selbst oder durch Büro im Auftrag) → speisen Abwesenheits-Kalender (M25) und Plantafel-Konflikt-Indikatoren (M04)
- Lohnabrechnungs-Bulk-Upload mit Dateiname-Pattern-Auto-Match (Personalnummer/Name), Match-Vorschau mit Konfidenz, Read-Tracking, Audit pro Read
- Upload-Erinnerungen mit Cadence (once/yearly/every_n_months/on_expiry), Eskalation an Manager bei Überfälligkeit, Erfüllung via Form oder Direkt-Upload
- Announcements mit Audience-Targeting, Acknowledgement-Pflicht + Read-Receipt, Reaktionen, Kommentare; Surveys (anonym möglich) mit Auswertung
- Anträge (Urlaub/Krank/Requests) laufen als M05-Form-Submissions (Form-Renderer aus P16 wiederverwenden)
- Permission-Layer mit Owner-/HR-Admin-Gates; Mobile-Default-Tab für Monteure (eigene Anträge, Payslips, Announcements, AU-Foto-Upload mobil)
Benötigte UI-Elemente (Liste, KEIN Layout — Anordnung = Davids freie Hand)
KPI-Kacheln (heute krank / im Urlaub / pendente Genehmigungen / offene AU), Card-/Widget-Hub-Layout 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 hart/weich/kein), 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 (Rating/NPS/Choice) + 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).
Davids Delta (David füllt aus)
- Überschriebene/geänderte Spec-Punkte:
- Neue UI/UX-Entscheidungen:
- Subframe-Screen-Link(s):
- Offene Fragen an Dev:
Dev-Nachzug (wir nach Davids Delta)
- Spec/ENTITY-MODEL an Davids Entscheidungen angepasst:
- REQUIREMENTS/PHASE-SOURCES nachgezogen:
- Plane-Ticket (AK-P17a/b) aktualisiert: