62 lines
8.1 KiB
Markdown
62 lines
8.1 KiB
Markdown
# 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:
|