Files
HiveGrid-Wireframes/03 Quellen und Referenzen/hivegrid-cloud/_bmad-output/specs/M14-hr-hub.md
T

60 KiB
Raw Blame History

module, title, phase, status, last_updated, session_source, related_lps, spec_style, size
module title phase status last_updated session_source related_lps spec_style size
14 HR-Hub / Mitarbeiterplattform 1 detail-spec-draft 2026-05-08 brainstorming-session-2026-05-07-2206.md
LP-2
LP-3
LP-7
LP-9
LP-10
LP-13
requirements-pur XL

Modul 14 — HR-Hub / Mitarbeiterplattform

Detail-Spec gemäß LP-9. Phase 1 voll (User-Korrektur). Quiply-Komplett-Ablösung. Sehr breites Modul mit vielen Sub-Bereichen (eigener MA-Bereich, Lohnabrechnungen, Krank/Urlaub als Forms, Announcements, MA-Verzeichnis, Password-Safe, Upload-Erinnerungen, Surveys, Requests, Quick-Links, Resources). Sensible Daten — strenge Permission-Gates.

Themenblöcke

A. Datenmodell
B. Menü-Struktur und Routes
C. Persönlicher MA-Bereich
D. Announcements
E. Urlaubsantrag + Krankmeldung (Leave-Workflow)
F. Lohnabrechnungen (Payslips)
G. Upload-Erinnerungen (Reminders)
H. Generische Requests + Templates
I. MA-Verzeichnis + Locations
J. Password-Safe (Team-Vaults, verschlüsselt)
K. HR-Surveys
L. Quick-Links + Resources
M. Activity-Stream-Integration
N. Integration mit anderen Modulen
O. Permissions-Anwendung
P. Datenschutz / sensible Daten
Q. Klartext-Hinweise
R. Phase 2

Block A — Datenmodell

Kern-Entitäten

HrEmployeeProfile              — erweitertes MA-Profil pro TenantUser
HrAnnouncement                 — Firmen-Bekanntmachung
HrAnnouncementRead             — Read-Receipt pro User
HrAnnouncementReaction         — Emoji-Reaktion (1 Reaktion pro User pro Announcement)
HrAnnouncementComment          — Kommentar (chronologisch)
HrLocation                     — Firmenstandort
HrEmployeeDocument             — Dokument im MA-Profil (Vertrag, Bescheinigungen, Zeugnisse)
HrResource                     — kuratierte Ressource (intern/extern, mit Beschreibung)
HrQuickLink                    — Schnellzugriff (URL, Icon, Sortierung)
HrSurvey                       — MA-Umfrage
HrSurveyItem                   — Frage innerhalb Survey
HrSurveySubmission             — Antwort eines MA
HrSurveySubmissionAnswer       — pro Frage pro Submission
HrRequest                      — generischer MA-Antrag (Spesen, Hardware, Sonstiges)
HrRequestTemplate              — vorgefertigte Antrags-Vorlage
HrRequestComment               — Kommentar/Klärung pro Antrag
EmployeePayslip                — Lohnabrechnung (PDF, Monat/Jahr)
EmployeeUploadReminder         — Upload-Erinnerungs-Definition (z.B. Führerschein)
EmployeeUploadReminderDispatch — Versand/Erfüllungs-Tracking pro MA
EmployeeVacationRequest        — Urlaubsantrag mit Genehmigungs-Workflow
EmployeeSickLeaveReport        — Krankmeldung (selbst-eingereicht oder durch Büro)
EmployeePasswordSafeVault      — Team-Vault (z.B. „Disposition", „Marketing")
EmployeePasswordSafeEntry      — verschlüsselter Eintrag im Vault
EmployeePasswordSafeAccess     — Vault-Zugriffs-Berechtigung pro User/Group

HrEmployeeProfile

  • id, tenant_id, user_id (1:1 mit TenantUser)
  • personal_number (Personalnummer, Pflicht für Lohnabrechnungs-Upload-Match — Tenant-Admin pflegt)
  • birthdate (optional, für Geburtstags-Hinweise im Hub)
  • hire_date (Eintrittsdatum, optional)
  • position_label (Positionsbezeichnung, Freitext)
  • team_label (Team-Bezeichnung, Freitext — orthogonal zu Groups M27)
  • location_id (FK auf HrLocation, optional)
  • phone_business, phone_private (separate Felder)
  • address_street, address_zip, address_city, address_country
  • emergency_contact_name, emergency_contact_phone, emergency_contact_relation (Notfallkontakt)
  • manager_user_id (FK auf TenantUser — Vorgesetzter für Antrags-Genehmigung)
  • bio (Markdown, optional — sichtbar im MA-Verzeichnis)
  • avatar_file_id (FK auf File, optional)
  • archived_at

Sonderfall: Ein User kann nur ein Profil pro Tenant haben (1:1). Bei Tenant-User-Anlage wird leeres Profil automatisch geseedet.

HrAnnouncement

  • id, tenant_id, created_at, updated_at, created_by_user_id
  • title (Pflicht)
  • body (Markdown, Pflicht)
  • is_pinned (oben angeheftet)
  • published_at (nullable — vor diesem Zeitpunkt = Draft)
  • expires_at (optional — automatische Archivierung)
  • audience_kind (Enum: all | groups | locations | users)
  • audience_group_ids[], audience_location_ids[], audience_user_ids[] (je nach audience_kind)
  • requires_acknowledgement (Boolean — Read-Receipt erforderlich)
  • allow_reactions (Boolean, default true)
  • allow_comments (Boolean, default true)
  • attached_file_ids[] (FK auf Files M23)
  • archived_at

HrAnnouncementRead

  • announcement_id, user_id, read_at, acknowledged_at (optional — bei requires_acknowledgement)
  • Unique-Index: (announcement_id, user_id)

HrAnnouncementReaction

  • announcement_id, user_id, emoji (Enum oder Unicode-String aus Tenant-Whitelist)
  • Unique-Index: (announcement_id, user_id) — eine Reaktion pro User pro Announcement

HrAnnouncementComment

  • id, announcement_id, user_id, created_at, updated_at
  • body (Markdown)
  • parent_comment_id (optional — 1-Ebene-Threading in Phase 1)
  • archived_at

HrLocation

  • id, tenant_id, name (Pflicht, z.B. „Hauptstandort Geerkens", „Außenlager Süd")
  • address_street, address_zip, address_city, address_country
  • phone, email
  • geo_lat, geo_lon (optional — für Map-Anzeige)
  • description (Markdown — Anfahrt, Öffnungszeiten, Hinweise)
  • image_file_id (optional)
  • is_default (Boolean — Default-Standort für neue MA)
  • archived_at

HrEmployeeDocument

  • id, tenant_id, employee_user_id
  • document_kind (Enum: contract | reference | certificate | id_scan | drivers_license | other)
  • title (Pflicht)
  • description (Freitext)
  • file_id (FK auf File M23, Pflicht)
  • valid_from, valid_until (optional — für ablauf-überwachte Dokumente wie Führerschein)
  • uploaded_by_user_id
  • is_self_uploaded (Boolean — vom MA selbst hochgeladen oder vom Büro)
  • visibility (Enum: employee_and_office | office_only — z.B. Vertraulichkeitsstufe)
  • archived_at

HrResource

  • id, tenant_id, title, description (Markdown)
  • kind (Enum: internal_link | external_link | file | text)
  • url (für Links), file_id (für File)
  • category (Freitext, z.B. „Onboarding", „Sicherheit", „IT")
  • audience_kind, audience_* (analog Announcement)
  • position (Sortierung)
  • archived_at
  • id, tenant_id, label, url
  • icon_key (Lucide-Icon-Name oder Slug)
  • audience_kind, audience_*
  • position
  • open_in_new_tab (Boolean, default true)
  • archived_at

HrSurvey

  • id, tenant_id, created_by_user_id, created_at
  • title, description (Markdown)
  • is_anonymous (Boolean — anonyme Auswertung möglich, Submitter-ID dann verschleiert)
  • audience_kind, audience_*
  • opens_at, closes_at
  • status (Enum: draft | open | closed | archived)
  • allow_multiple_submissions (Boolean, default false)
  • result_visibility (Enum: creator_only | hr_admins | all_participants)

HrSurveyItem

  • id, survey_id, position
  • item_type (Enum: text | textarea | rating_5 | rating_10 | nps | single_choice | multi_choice | boolean | date)
  • label (Pflicht), description
  • required (Boolean)
  • options[] (für Choice-Items)

HrSurveySubmission

  • id, survey_id, submitted_at
  • submitter_user_id (NULL bei is_anonymous=true — stattdessen Hash für Doppel-Einreichungs-Schutz)
  • submitter_hash (nur bei anonym — hash(survey_id, user_id) für Doppel-Schutz, kein Reverse-Mapping)

HrSurveySubmissionAnswer

  • submission_id, item_id, value (JSONB)

HrRequest

  • id, tenant_id, created_at, updated_at
  • requester_user_id
  • template_id (FK, optional — bei Antrag aus Template)
  • title, body (Markdown)
  • request_kind (Enum: expense | hardware | training | reference | document_request | generic)
  • form_submission_id (optional — wenn Template ein M5-Form referenziert)
  • attached_file_ids[]
  • status (Enum: submitted | in_review | approved | rejected | withdrawn | completed)
  • assigned_approver_user_id (FK auf TenantUser — Default aus Template oder aus Manager des Requesters)
  • decision_at, decision_by_user_id, decision_note
  • priority (Enum: normal | urgent)
  • archived_at

HrRequestTemplate

  • id, tenant_id, name, description
  • request_kind
  • default_assigned_approver_user_id (optional)
  • default_approver_kind (Enum: manager | fixed_user | role | group — Default für Genehmiger-Auflösung)
  • default_approver_role_id, default_approver_group_id
  • linked_form_id (optional — M5-Form für Antrag)
  • instructions (Markdown)
  • position
  • archived_at

HrRequestComment

  • id, request_id, user_id, created_at, body (Markdown)
  • is_internal_note (Boolean — Approver-only sichtbar)

EmployeePayslip

  • id, tenant_id, employee_user_id
  • period_year, period_month (z.B. 2026, 4)
  • file_id (FK auf File M23, Pflicht — PDF)
  • uploaded_by_user_id, uploaded_at
  • is_read_by_employee (Boolean — wird gesetzt wenn MA das PDF öffnet)
  • read_at
  • note (Freitext, z.B. „Korrektur 04/2026")
  • archived_at
  • Unique-Index: (tenant_id, employee_user_id, period_year, period_month, note) — gleicher Monat darf mit unterschiedlicher Note doppelt vorkommen (Korrektur-Lauf)

EmployeeUploadReminder

  • id, tenant_id, created_by_user_id
  • title (Pflicht, z.B. „Führerschein-Scan")
  • description (Markdown)
  • document_kind (Enum aus HrEmployeeDocument.document_kind)
  • audience_kind, audience_* (welche MA betroffen)
  • cadence_kind (Enum: once | yearly | every_n_months | on_expiry)
  • cadence_n_months (für every_n_months)
  • expiry_lookahead_days (für on_expiry — z.B. 30 Tage vor valid_until)
  • due_date (für once)
  • is_mandatory (Boolean — bei true erscheint im Dashboard als Block)
  • linked_form_id (optional — M5-Form für Upload statt nur File)
  • archived_at

EmployeeUploadReminderDispatch

  • id, reminder_id, employee_user_id
  • due_at, dispatched_at
  • status (Enum: pending | sent | fulfilled | overdue | dismissed)
  • fulfilled_document_id (FK auf HrEmployeeDocument)
  • fulfilled_at
  • reminder_count (wie oft erinnert)

EmployeeVacationRequest

  • id, tenant_id, requester_user_id
  • start_date, end_date (Pflicht, inklusiv)
  • working_days_count (berechnet — netto Arbeitstage zwischen start_date und end_date ohne Wochenende und Feiertage des Bundeslands)
  • request_kind (Enum: paid_vacation | unpaid_vacation | overtime_compensation | special_leave)
  • note (Freitext aus Form-Feld)
  • form_submission_id (FK — Antrag wird als M5-Form-Submission abgelegt)
  • status (Enum: submitted | approved | rejected | withdrawn)
  • assigned_approver_user_id
  • decided_at, decided_by_user_id, decision_note
  • calendar_event_id (FK auf M25-Calendar-Event, gesetzt bei approved)
  • auto_archive_at

EmployeeSickLeaveReport

  • id, tenant_id, employee_user_id
  • reported_at, start_date, expected_return_date (optional — kann später aktualisiert werden)
  • actual_return_date (gesetzt bei Rückmeldung)
  • has_certificate (Boolean — AU-Bescheinigung vorhanden)
  • certificate_file_id (FK auf File, optional — verschlüsselter Storage)
  • certificate_due_date (Pflicht-Vorlage-Datum, z.B. 3. Tag bei DE-Recht)
  • note (Freitext)
  • form_submission_id (FK — Krankmeldung als M5-Form)
  • reported_by_user_id (kann von employee_user_id abweichen — Büro meldet im Auftrag)
  • status (Enum: active | returned | cancelled)

EmployeePasswordSafeVault

  • id, tenant_id, name (Pflicht, z.B. „IT-Disposition")
  • description
  • created_by_user_id, created_at
  • archived_at

EmployeePasswordSafeEntry

  • id, tenant_id, vault_id
  • title (Pflicht, z.B. „Aircall Admin-Login")
  • username (verschlüsselt at-rest)
  • password (verschlüsselt at-rest, AES-256-GCM mit per-Tenant-Key aus Master-KMS)
  • url, notes_encrypted (verschlüsselt)
  • tags[]
  • created_by_user_id, updated_by_user_id, updated_at
  • last_rotated_at (optional — Rotation-Hinweis)
  • archived_at

Sonderfall: Werte werden nie im Klartext in DB gespeichert. Entschlüsselung erst beim API-Read mit Permission-Check + Audit-Log-Eintrag „User X hat Eintrag Y entschlüsselt am Z".

EmployeePasswordSafeAccess

  • id, vault_id, principal_kind (Enum: user | group | role)
  • principal_id (FK auf TenantUser/Group/Role je nach Kind)
  • permission_level (Enum: read | write | admin — read = Werte sehen; write = Einträge anlegen/ändern; admin = Vault-Verwaltung + Access-Verwaltung)
  • granted_by_user_id, granted_at

Indizes (Performance-Pflicht)

  • HrAnnouncement (tenant_id, published_at DESC, archived_at) für Feed-Default-Sortierung
  • HrAnnouncementRead (announcement_id, user_id) Unique
  • EmployeePayslip (tenant_id, employee_user_id, period_year DESC, period_month DESC) für Liste
  • EmployeeVacationRequest (tenant_id, status, start_date, end_date) für Plantafel-Lookup
  • EmployeeSickLeaveReport (tenant_id, employee_user_id, status, start_date) für aktive Sicht
  • EmployeeUploadReminderDispatch (tenant_id, employee_user_id, status, due_at) für Dashboard
  • EmployeePasswordSafeEntry (tenant_id, vault_id) mit RLS-Layer durch Vault-Access

RLS / Datenisolation

  • Alle Tabellen tenant-scoped mit tenant_id NOT NULL
  • Sensible Tabellen (EmployeePayslip, EmployeeSickLeaveReport, EmployeePasswordSafeEntry, HrEmployeeDocument) haben zusätzlich App-Code-Permission-Layer über reine RLS hinaus — nicht jeder Tenant-User darf alle Sätze sehen, auch wenn RLS sie nicht ausschließt
  • Storage-Pfade (M23): Lohnabrechnungen unter tenants/{tenantId}/payslips/{userId}/... mit Bucket-Policy auch dort
  • Krankmeldungs-AU-Bescheinigungen unter tenants/{tenantId}/sick-certs/{userId}/... (verschlüsselt at-rest separat)

Block B — Menü-Struktur und Routes

Sidebar-Hauptpunkt: HR-Hub mit kontextabhängigen Sub-Punkten (siehe Permissions Block O).

/{tenant}/hr                                   → Hub-Startseite mit Tabs
/{tenant}/hr/announcements                     → Announcement-Feed
/{tenant}/hr/announcements/:id                 → Announcement-Detail
/{tenant}/hr/announcements/new                 → neue Announcement (Permission-gegated)

/{tenant}/hr/documents                         → MA-Verzeichnis-Dokumente (HR-Admin-Sicht)
/{tenant}/hr/my-documents                      → eigene Dokumente

/{tenant}/hr/leave                             → Urlaub + Krank (Übersicht)
/{tenant}/hr/leave/new                         → neuer Antrag (Auswahl Urlaub/Krank)
/{tenant}/hr/leave/vacation/:id                → Urlaubsantrag-Detail
/{tenant}/hr/leave/sick/:id                    → Krankmeldungs-Detail

/{tenant}/hr/locations                         → Standort-Liste
/{tenant}/hr/locations/:id                     → Standort-Detail

/{tenant}/hr/payslips                          → eigene Lohnabrechnungen
/{tenant}/hr/payslips/:id                      → einzelne Lohnabrechnung (PDF-Viewer)

/{tenant}/hr/password-safe                     → Vault-Liste (sichtbar nur mit Vault-Access)
/{tenant}/hr/password-safe/:vaultId            → Vault-Detail (Einträge)
/{tenant}/hr/password-safe/:vaultId/:entryId   → Eintrag-Detail (mit Reveal-Funktion)

/{tenant}/hr/quick-links                       → Quick-Links-Liste
/{tenant}/hr/resources                         → Ressourcen-Übersicht
/{tenant}/hr/surveys                           → offene Surveys
/{tenant}/hr/surveys/:id                       → Survey-Teilnahme
/{tenant}/hr/surveys/:id/results               → Survey-Auswertung (Permission-gegated)

/{tenant}/hr/requests                          → eigene Anträge + zur Genehmigung anstehende
/{tenant}/hr/requests/new                      → neuer Antrag (Template-Auswahl)
/{tenant}/hr/requests/:id                      → Antrags-Detail

/{tenant}/hr/directory                         → MA-Verzeichnis (alle Mitarbeiter)
/{tenant}/hr/directory/:userId                 → MA-Detail-Profil

/{tenant}/admin/hr/announcements               → Announcement-Verwaltung
/{tenant}/admin/hr/documents                   → Dokumenten-Verwaltung (alle MA)
/{tenant}/admin/hr/locations                   → Standort-Verwaltung
/{tenant}/admin/hr/payslips                    → Payslip-Upload (Bulk + Einzel)
/{tenant}/admin/hr/payslips/upload             → Bulk-Upload-Workflow
/{tenant}/admin/hr/leave                       → Urlaubs-/Krank-Übersicht aller MA
/{tenant}/admin/hr/upload-reminders            → Upload-Reminder-Definitionen
/{tenant}/admin/hr/upload-reminders/:id        → Reminder-Detail mit Dispatch-Liste
/{tenant}/admin/hr/quick-links                 → Quick-Link-Verwaltung
/{tenant}/admin/hr/resources                   → Ressourcen-Verwaltung
/{tenant}/admin/hr/surveys                     → Survey-Verwaltung
/{tenant}/admin/hr/surveys/new                 → neuer Survey (Editor)
/{tenant}/admin/hr/request-templates           → Request-Template-Verwaltung
/{tenant}/admin/hr/request-templates/:id       → Template-Editor
/{tenant}/admin/hr/password-safe               → Vault-Verwaltung (Tenant-weite Sicht)
/{tenant}/admin/hr/employees                   → MA-Profil-Verwaltung (Personalnummer, Manager, Location)

Mobile-Sichtbarkeit (LP-2):

  • /{tenant}/hr als Mobile-Default-Tab für Monteure (eigene Anträge, Payslips, Announcements)
  • Foto-Upload für Krankmeldungs-AU-Bescheinigung mobile-optimiert
  • Touch-Signatur nicht relevant in M14

Block C — Persönlicher MA-Bereich

Hub-Startseite (/{tenant}/hr)

Zu zeigende Daten (für jeden MA):

  • Aktuelle Pinned-Announcements
  • Offene Acknowledgement-Pflichten (rote Hinweise)
  • Pendente eigene Anträge (Urlaub/Krank/Request) mit Status
  • Pendente Upload-Erinnerungen (z.B. „Führerschein abläuft in 14 Tagen")
  • Heute aktive Krankmeldungen / Urlaube im Team (gegated)
  • Letzte Lohnabrechnung (Hinweis falls ungelesen)
  • Quick-Links
  • Geburtstags-Hinweise im Team (heute / diese Woche — falls Profil birthdate gepflegt und Sichtbarkeit erlaubt)

Benötigte UI-Elemente:

  • Tab-/Sektions-Navigation für: Announcements / Anträge / Dokumente / Lohnabrechnungen / Surveys / Requests / Verzeichnis / Standorte / Resources / Quick-Links / Password-Safe (nur sichtbare Tabs je nach Permission)
  • Card-/Widget-Anzeige der Hub-Inhalte
  • Action-Funktionen „Krankmeldung melden", „Urlaub beantragen", „Antrag stellen" prominent zugänglich

Operationen:

  • Klick auf Announcement → Detail
  • Acknowledgement-Klick (bei requires_acknowledgement)
  • Klick auf eigenen Antrag → Detail
  • Klick auf Upload-Erinnerung → öffnet Upload-Workflow / verlinktes Form
  • Klick auf Quick-Link → externes Ziel
  • Klick auf Lohnabrechnungs-Hinweis → PDF-Viewer

Eigenes Profil (/{tenant}/hr/directory/:userId mit userId == self)

Zu zeigende Daten:

  • Persönliche Stammdaten (Profil-Felder, Avatar, Position, Team, Standort)
  • Notfallkontakt (nur self + HR-Admins sichtbar)
  • Eigene hochgeladene Dokumente (nur self-sichtbar)
  • Manager (Vorgesetzter)
  • Eigener Resturlaub (Phase 2 — Kontingent-Tracking)
  • Eigene aktive Krankmeldung (falls vorhanden)

Benötigte UI-Elemente:

  • Sektionierte Anzeige aller Felder
  • Inline-Edit-Funktion für Felder, die der MA selbst pflegen darf (phone_private, address_*, emergency_contact_*, bio, avatar_file_id)
  • Read-only-Anzeige für Felder, die nur HR-Admin pflegt (personal_number, position_label, manager_user_id, hire_date, team_label, location_id)
  • Avatar-Upload-Funktion
  • Markdown-Editor für bio

Operationen:

  • Persönliche Daten editieren (siehe oben)
  • Dokumente hochladen (eigene)
  • DSGVO-Datenexport (eigene Daten als JSON+Files-ZIP) — siehe M35

Eigene Dokumente (/{tenant}/hr/my-documents)

Zu zeigende Daten pro Dokument:

  • Titel, document_kind, Upload-Datum, Uploader, valid_from / valid_until (falls relevant)
  • Datei-Vorschau (PDF/Bild)
  • Visibility-Hinweis (employee_and_office / office_only — Letzteres erscheint hier nicht!)

Benötigte UI-Elemente:

  • Liste mit Filter nach document_kind
  • Upload-Funktion (is_self_uploaded = true)
  • File-Viewer
  • Download-Funktion

Operationen:

  • Eigenes Dokument hochladen (Default visibility = employee_and_office, Tenant-Admin-Setting kann erzwingen)
  • Eigenes selbst-hochgeladenes Dokument löschen (mit Klartext-Warnung)
  • Vom Büro hochgeladene Dokumente: nur Read

Block D — Announcements

Feed-View (/{tenant}/hr/announcements)

Zu zeigende Daten pro Announcement-Eintrag:

  • Titel, Vorschau-Body (gekürzt), Autor + Avatar, Veröffentlichungs-Datum
  • Pinned-Indikator
  • Audience-Hinweis (z.B. „An: Alle" / „An: Team Süd" / „An: Marketing")
  • Anzahl Reads / Reaktionen / Kommentare
  • Acknowledgement-Status (eigene Sicht: noch offen / bereits bestätigt)
  • Anhang-Hinweis (Anzahl Dateien)

Benötigte UI-Elemente:

  • Chronologische Liste mit Pinned-Sektion oben
  • Filter-Funktionen: nur ungelesen / mit Acknowledgement / nach Autor / Zeitraum / Tag
  • Search-Funktion über Titel + Body
  • Pagination (Cursor-basiert, 20 pro Seite)

Operationen:

  • Klick → Detail-View
  • Schnell-Reaktion direkt aus Feed (Phase 2)

Detail-View (/{tenant}/hr/announcements/:id)

Zu zeigende Daten:

  • Titel, Body (Markdown gerendert), Autor, Datum, Audience-Hinweis
  • Anhänge mit Vorschau
  • Reaktionen (gruppiert nach Emoji mit Anzahl + Hover-Liste der User)
  • Kommentare chronologisch (1-Ebene-Threading)
  • Read-Receipt-Liste (nur sichtbar für Autor + HR-Admins): Wer hat gelesen / acknowledged / nicht
  • Acknowledgement-Funktion (falls requires_acknowledgement und User noch nicht bestätigt)

Benötigte UI-Elemente:

  • Markdown-Renderer
  • Attachment-Liste mit Download/Vorschau
  • Reaction-Picker (Emoji-Auswahl aus Tenant-Whitelist, Default: 6 Emojis)
  • Comment-Editor mit Markdown
  • Comment-Liste mit Reply-Funktion
  • Read-Receipt-Tabelle (Permission-gegated)
  • Acknowledgement-Button mit Bestätigungs-Counter

Operationen:

  • Read-Receipt automatisch beim Öffnen (HrAnnouncementRead.read_at = now)
  • Acknowledgement-Klick (separater Schritt: acknowledged_at = now)
  • Reaktion setzen / ändern / entfernen (1 pro User, ändert ersetzt)
  • Kommentar schreiben / löschen (eigenen) / bearbeiten (eigenen, mit Edit-Indikator)
  • Anhang öffnen / herunterladen
  • Announcement bearbeiten / archivieren (nur Autor + HR-Admin)
  • Pin / Unpin (HR-Admin)

Klartext-Hinweise:

  • Acknowledgement offen: „Bitte bestätige, dass du diese Information gelesen hast."
  • Kommentare deaktiviert: „Zu dieser Bekanntmachung können keine Kommentare hinterlegt werden."

Verwaltung (/{tenant}/admin/hr/announcements)

Zu zeigende Daten:

  • Alle Announcements (inkl. Drafts und archivierte)
  • Pro Eintrag: Status (Draft / Veröffentlicht / Archiviert), Audience, Reads/Reactions/Comments-Counts

Operationen:

  • Neue Announcement anlegen (Editor)
  • Editor: Titel, Body (Markdown), Audience-Wahl, requires_acknowledgement-Toggle, Reactions/Comments-Toggles, Anhänge, Pin-Toggle, Veröffentlichungs-Zeitpunkt (sofort / geplant), Ablaufdatum
  • Veröffentlichen (löst Notifications M22 aus)
  • Archivieren / Reaktivieren
  • Hard-Delete (nur HR-Admin, mit Klartext-Warnung)

Block E — Urlaubsantrag + Krankmeldung (Leave-Workflow)

Übersicht (/{tenant}/hr/leave)

Zu zeigende Daten:

  • Eigene aktive + zukünftige Urlaube + Krankmeldungen (chronologisch)
  • Eigene Antrags-Historie (alle Status)
  • Falls Approver: anstehende Genehmigungen (eigene Team-Sicht oder Alle, je nach Permission)
  • Team-Übersicht (gegated): Wer ist heute / diese Woche im Urlaub / krank

Benötigte UI-Elemente:

  • Tab-Navigation: Meine Anträge / Genehmigungen / Team-Übersicht
  • Filter-Komponenten: nach Status, Zeitraum, Antragsart
  • Listen-Anzeige
  • Action-Funktionen „Urlaub beantragen" und „Krankmeldung melden" prominent

Antrag stellen (/{tenant}/hr/leave/new)

Schritt 1 — Auswahl: Urlaub / Krankmeldung.

Urlaubsantrag

Form-basierter Workflow (M5 Template Urlaubsantrag als Subtyp standard):

Felder im Form-Template (Default, anpassbar pro Tenant):

  • start_date (Date)
  • end_date (Date)
  • request_kind (Select: bezahlter Urlaub / unbezahlter Urlaub / Überstundenausgleich / Sonderurlaub)
  • note (Textarea — Begründung, optional)
  • assigned_approver_user_id (Select — Default: manager_user_id aus Profil; bei Multi-Manager-Setup wählbar)

Validation beim Submit:

  • end_date >= start_date
  • start_date >= today (kein rückwirkender Antrag — Klartext-Hinweis bei Versuch)
  • Konflikt-Check (Klartext-Hinweis, kein Block):
    • Wenn auf gleichen Tag bereits genehmigter Urlaub existiert: „Du hast für diesen Zeitraum bereits einen genehmigten Urlaub. Trotzdem fortfahren?"
    • Wenn aktive Krankmeldung im Zeitraum: „Du bist im Zeitraum krankgemeldet. Krankmeldung beendet sich automatisch ab Genehmigung dieses Urlaubs?" (Hinweis, nicht-blockierend)
  • working_days_count automatisch berechnet aus DE-Feiertagskalender des Standortes (Bundesland aus HrLocation.address_*)

Auto-Submit-Aktionen:

  • EmployeeVacationRequest angelegt mit Status submitted und form_submission_id
  • Notification (M22) Push + Email an assigned_approver_user_id: „[Mitarbeiter] hat einen Urlaubsantrag gestellt"
  • Activity-Stream-Eintrag (Subject: User-Profil)
  • Automation-Trigger hr.vacation_requested (M17)

Approver-View (Detail /{tenant}/hr/leave/vacation/:id):

Zu zeigende Daten:

  • Antragsteller (Avatar + Name + Position + Team)
  • Zeitraum + Working-Days-Count
  • Antragsart, Note
  • Konflikt-Hinweise (siehe Plantafel-Integration unten)
  • Bisherige Anträge des Antragstellers (Historie)

Operationen Approver:

  • Genehmigen (mit optionaler Notiz)
  • Ablehnen (mit Pflicht-Notiz für Klartext-Begründung an Antragsteller)
  • Rückfrage stellen (Status bleibt submitted, Comment angelegt; Antragsteller bekommt Notification)

Operationen Antragsteller:

  • Zurückziehen (nur in Status submitted) → Status withdrawn
  • Comment hinzufügen / lesen
  • Bei Ablehnung: neuen Antrag mit anderen Daten stellen

Auto-Aktionen bei Genehmigung:

  • Status → approved
  • Calendar-Event-Anlage in M25 (eigener Kalender Antragsteller + abonnierte Tenant-Kalender wie „Team-Urlaube")
  • ScheduleEntry-Konflikt-Hinweis in M4-Plantafel:
    • Falls bereits ScheduleEntries im Zeitraum existieren: rote Konflikt-Indikatoren in Plantafel
    • PL bekommt Notification „Genehmigter Urlaub von [MA] kollidiert mit Schedule"
  • Activity-Stream-Eintrag
  • Email an Antragsteller mit Klartext-Bestätigung
  • Automation-Trigger hr.vacation_approved

Auto-Aktionen bei Ablehnung:

  • Status → rejected
  • Notification an Antragsteller mit Klartext-Begründung aus decision_note
  • Activity-Stream-Eintrag
  • Kein Calendar-Event

Krankmeldung

Form-basierter Workflow (M5 Template Krankmeldung):

Felder im Form-Template:

  • start_date (Date — Default heute)
  • expected_return_date (Date, optional)
  • has_certificate (Boolean)
  • certificate_file_upload (File — nur sichtbar wenn has_certificate=true; verschlüsselter Upload)
  • note (Textarea, optional)

Validation:

  • start_date <= today + 1 (max. 1 Tag in Zukunft)
  • expected_return_date >= start_date

Auto-Submit-Aktionen (kein Approval-Workflow):

  • EmployeeSickLeaveReport angelegt, Status active
  • Auto-Versand ans Büro: Email + Notification an alle User mit Permission hr.read_all UND opt-in für Sick-Notifications
  • Direkter Manager-Notification (HrEmployeeProfile.manager_user_id)
  • Activity-Stream-Eintrag (gegated — nur HR-Admin und Manager sehen)
  • Plantafel-Integration M4: aktive Krankmeldung erscheint als Konflikt-Indikator für ScheduleEntries im Zeitraum
  • Automation-Trigger hr.sick_leave_reported
  • Bei has_certificate=false und start_date >= today + 3 (DE-Recht): automatischer Reminder-Eintrag „AU-Bescheinigung bis [3. Tag] vorlegen"

Operationen Antragsteller:

  • Verlängern (expected_return_date aktualisieren) → erneute Notification
  • Bescheinigung nachreichen (File-Upload)
  • Rückkehr melden (actual_return_date setzen, Status → returned)
  • Stornieren falls fälschlicherweise gemeldet (Status → cancelled, mit Pflicht-Notiz)

Operationen Büro / HR-Admin:

  • Krankmeldung im Auftrag eines MA erfassen (reported_by_user_id != employee_user_id)
  • AU-Bescheinigung nach Erhalt einsehen / herunterladen (Audit-Log-Eintrag)
  • Status-Korrektur

Datenschutz:

  • AU-Bescheinigung streng permission-gegated (nur hr.read_all + hr.upload_payslip-Bundle)
  • Standard-MA / Manager sieht nur „Krank von X bis Y" — keine Diagnose-Details, keine Bescheinigungs-Inhalte

Verwaltung Leave (/{tenant}/admin/hr/leave)

Zu zeigende Daten:

  • Tabellarische Übersicht aller Anträge / Meldungen aller MA mit Filter
  • Kalender-Sicht (Monatsansicht aller MA-Abwesenheiten)
  • KPI-Tiles: Heute krank / Diese Woche im Urlaub / Pendente Genehmigungen / Offene AU-Bescheinigungen

Operationen:

  • Bulk-Approve (Phase 2)
  • Export als CSV
  • Direkt-Erfassung im Auftrag eines MA

Block F — Lohnabrechnungen (Payslips)

Eigene Sicht (/{tenant}/hr/payslips)

Zu zeigende Daten:

  • Liste eigener Lohnabrechnungen, sortiert nach Periode absteigend
  • Pro Eintrag: Periode (z.B. „04/2026"), Note (falls Korrektur), Upload-Datum, Read-Status, PDF-Link
  • Optional: Zusatzhinweise vom Büro

Benötigte UI-Elemente:

  • Liste mit Periode-Filter (Jahr-Auswahl)
  • PDF-Viewer / Download-Funktion

Operationen:

  • PDF öffnen → automatisch is_read_by_employee = true, read_at = now
  • Herunterladen (mit Audit-Log)

Klartext-Hinweise:

  • Keine Lohnabrechnungen vorhanden: „Hier erscheinen deine Lohnabrechnungen, sobald das Büro sie hochlädt."

Verwaltung (/{tenant}/admin/hr/payslips)

Zu zeigende Daten:

  • Tabelle aller Payslips über alle MA mit Filter (MA, Periode, Read-Status)
  • Bulk-Upload-Status

Operationen:

  • Einzel-Upload für bestimmten MA + Periode
  • Bulk-Upload (siehe Workflow unten)
  • Löschen (nur HR-Admin, mit Klartext-Warnung — is_read_by_employee Audit bleibt)

Bulk-Upload-Workflow (/{tenant}/admin/hr/payslips/upload)

Schritte:

  1. Periode wählen (Jahr + Monat)
  2. PDF-Files hochladen (mehrere via Drag-&-Drop oder ZIP)
  3. Auto-Match-Logik:
    • PDF-Dateiname-Pattern wird konfiguriert (z.B. {personal_number}-{yyyy-mm}.pdf oder {lastname}-{yyyy-mm}.pdf)
    • System matcht jede PDF zu MA über Personalnummer / Lastname-Match
  4. Match-Vorschau: Liste mit pro PDF zugeordnetem MA + Confidence
    • Hard-Match (Personalnummer eindeutig): grün
    • Soft-Match (Name): gelb mit Bestätigungs-Funktion
    • Kein Match: rot, manuell zuordnen
  5. Bestätigen → Auto-Anlage EmployeePayslip pro MA
  6. Notification an MA: „Neue Lohnabrechnung verfügbar" (Push + Email konfigurierbar)
  7. Aktivitäts-Bericht (Anzahl Erfolg / Fehler / Übersprungen)

Klartext-Validation:

  • PDF ohne erkennbare Personalnummer: „Konnte keine Personalnummer im Dateinamen erkennen. Bitte manuell zuordnen oder Dateiname-Pattern anpassen."
  • MA ohne Personalnummer im Profil: „Mitarbeiter [Name] hat keine Personalnummer hinterlegt. Bitte im Profil ergänzen oder per Lastname-Match fortfahren."
  • Doppel-Upload (gleicher MA + Periode + leere Note): „Für [MA] existiert bereits eine Lohnabrechnung 04/2026. Als Korrektur hochladen (mit Note)?"

Audit:

  • Pro Upload: User, Datum, Anzahl Files, Match-Resultat geloggt
  • Pro Read: Audit-Eintrag (Compliance — Zugang nachweisbar)

Block G — Upload-Erinnerungen (Reminders)

Verwaltung (/{tenant}/admin/hr/upload-reminders)

Zu zeigende Daten:

  • Liste aller Reminder-Definitionen
  • Pro Eintrag: Titel, Cadence, Audience, Anzahl pendender Dispatches, Anzahl überfälliger

Benötigte UI-Elemente:

  • Liste mit Filter
  • Editor für neue Reminder
  • Detail-View pro Reminder mit Dispatch-Liste

Editor-Felder:

  • Titel, Beschreibung
  • document_kind (welche Dokumentart wird erwartet)
  • Audience (alle / Group / Location / einzelne User)
  • Cadence (once | yearly | every_n_months | on_expiry)
  • Bei once: Due-Date
  • Bei every_n_months: N
  • Bei on_expiry: Lookahead-Days
  • Mandatory-Toggle
  • Linked-Form (optional — z.B. Form-Template „Führerschein-Update" mit Felder zur Fahrerlaubnis-Klasse + File)

Operationen:

  • Reminder anlegen / bearbeiten / archivieren
  • Manueller Re-Dispatch an einzelnen MA
  • Dispatch dismiss (z.B. MA hat aus dem Unternehmen ausgeschieden)

Cron-Logik (Scheduler)

  • Täglicher Cron prüft pro Reminder:
    • Bei once: einmalig dispatchen wenn due_date - 14 Tage erreicht
    • Bei yearly: jährlich dispatchen am gleichen Tag wie Erst-Dispatch
    • Bei every_n_months: alle N Monate
    • Bei on_expiry: wenn HrEmployeeDocument.valid_until - lookahead_days erreicht
  • Erstellt EmployeeUploadReminderDispatch mit Status pending
  • Sendet Notification (Push + Email konfigurierbar in M22) an betroffenen MA: „Bitte [Dokument] hochladen — fällig am [Datum]"
  • Bei Überfälligkeit (>7 Tage nach due_at): Status → overdue + Eskalations-Notification an Manager + HR-Admin
  • Reminder zählt reminder_count hoch, wiederholt Notification alle 3 Tage bis fulfilled

Erfüllung

  • MA klickt Reminder → wird zu Upload-Workflow geleitet
  • Falls linked_form_id: Form öffnet sich, Submit erzeugt HrEmployeeDocument automatisch
  • Falls keine Form: direkter Upload mit Auto-Vorausfüllung (document_kind, valid_from, valid_until falls Pattern erkennbar)
  • Dispatch-Status → fulfilled, fulfilled_document_id gesetzt
  • Notification an HR-Admin: „[MA] hat [Dokument] eingereicht"

Eigene Sicht im Hub

  • Pendente Reminders erscheinen prominent auf Hub-Startseite
  • Mandatory-Reminders blocken den Hub mit Klartext-Hinweis (nicht aber andere Module)

Block H — Generische Requests + Templates

Templates (/{tenant}/admin/hr/request-templates)

Zu zeigende Daten:

  • Liste aller Templates mit Kind, Default-Approver-Logik, Linked-Form (falls)
  • Anzahl Anträge aus Template

Editor-Felder:

  • Name, Beschreibung, request_kind
  • Default-Approver-Logik (manager | fixed_user | role | group)
  • Linked-Form (M5-Form, optional)
  • Instructions (Markdown — User-Hinweise beim Anträgen)
  • Audience für Sichtbarkeit (welche MA dürfen Antrag aus diesem Template stellen)

SHK-Default-Templates (geseedet):

  • „Spesenabrechnung" — Linked-Form mit Datum, Anlass, Betrag, Beleg-Upload; Approver = Manager
  • „Hardware-Anfrage" — Linked-Form mit Hardware-Typ, Begründung; Approver = IT-Rolle
  • „Schulung / Weiterbildung" — Approver = Manager; Linked-Form mit Anbieter, Termin, Kosten
  • „Arbeitszeugnis" — Approver = HR-Rolle
  • „Sonstiger Antrag" — Generisch, freier Text

Antrag stellen (/{tenant}/hr/requests/new)

Schritte:

  1. Template-Auswahl (Liste der für User sichtbaren Templates) — alternativ „Sonstiger Antrag" für freien Antrag
  2. Linked-Form wird gerendert (falls vorhanden) — sonst Titel + Body-Eingabe
  3. Approver-Vorauswahl basierend auf Template-Logik (User kann ändern falls Permission)
  4. Priority setzen (normal / urgent)
  5. Anhänge hochladen
  6. Submit → HrRequest Status submitted, Notification an Approver

Detail-View (/{tenant}/hr/requests/:id)

Zu zeigende Daten:

  • Requester + Approver + Status + Datum
  • Form-Submission-Inhalte (rendered) oder Title/Body
  • Anhänge
  • Comment-Stream (chronologisch — is_internal_note ausgeblendet für Requester)
  • Decision-Note (bei abgeschlossenem Antrag)

Operationen Requester:

  • Comment hinzufügen
  • Zurückziehen (nur in submitted / in_review)
  • Editieren der Form-Submission (Phase 2)

Operationen Approver:

  • Status ändern (submitted → in_review → approved | rejected | completed)
  • Internal-Note hinterlegen
  • Reassign (an anderen Approver delegieren)

Operationen HR-Admin:

  • Hard-Delete
  • Bulk-Status-Update

Block I — MA-Verzeichnis + Locations

MA-Verzeichnis (/{tenant}/hr/directory)

Zu zeigende Daten pro MA-Eintrag:

  • Avatar, Name, Position, Team, Standort
  • Phone-Business, Email
  • Manager
  • (Geburtstag falls eigene Sichtbarkeitsfreigabe)

Benötigte UI-Elemente:

  • Tabellarische oder Kartenliste
  • Filter: Standort, Team, Manager, Position
  • Search (Volltext über Name, Position, Team)
  • Wahlweise Karten- oder Listen-Ansicht

Operationen:

  • Klick → Profil-Detail
  • Direkt-Telefon-Klick (Click-to-Call M12)
  • Direkt-Mail-Klick
  • Direkt-Chat-Start (M13)

Standort-Liste (/{tenant}/hr/locations)

Zu zeigende Daten pro Standort:

  • Name, Adresse, Telefon, Email
  • Map-Vorschau
  • Anzahl zugeordneter MA
  • Beschreibung (Anfahrt, Öffnungszeiten)
  • Bild

Operationen:

  • Standort öffnen → Detail
  • Direkt-Map-Link / Anfahrts-Funktion

Standort-Verwaltung (/{tenant}/admin/hr/locations)

Operationen:

  • Standort anlegen / bearbeiten / archivieren
  • Default-Standort setzen
  • Bulk-Reassign von MA bei Standort-Schließung

Block J — Password-Safe (Team-Vaults, verschlüsselt)

Vault-Liste (/{tenant}/hr/password-safe)

Zu zeigende Daten:

  • Nur Vaults, für die User Access hat (EmployeePasswordSafeAccess)
  • Pro Vault: Name, Beschreibung, Anzahl Einträge, Permission-Level (Read/Write/Admin)

Benötigte UI-Elemente:

  • Liste / Kacheln
  • Suchfunktion über Vaults

Vault-Detail (/{tenant}/hr/password-safe/:vaultId)

Zu zeigende Daten:

  • Vault-Stammdaten
  • Liste der Einträge (Title, Tags, letztes Update — keine Werte sichtbar in Liste!)
  • Access-Liste (wer hat Zugang) — nur für Vault-Admin

Benötigte UI-Elemente:

  • Liste der Einträge mit Suche
  • Add-Eintrag-Funktion (bei write / admin)
  • Add-Access-Funktion (nur admin)

Eintrag-Detail (/{tenant}/hr/password-safe/:vaultId/:entryId)

Zu zeigende Daten:

  • Title, Username, Password, URL, Notes, Tags, last_rotated_at
  • Werte werden nicht automatisch angezeigt — Reveal-Funktion erforderlich

Benötigte UI-Elemente:

  • Reveal-Buttons pro Wert (Username/Password/Notes)
  • Copy-to-Clipboard mit Auto-Clear nach 30 Sekunden
  • Edit-Funktion (bei write / admin)
  • Audit-Log-Anzeige (wer hat wann entschlüsselt) — bei admin

Operationen:

  • Reveal-Klick: API-Call an Server, der Wert entschlüsselt mit Tenant-Key, Audit-Log-Eintrag erstellt, Wert für 30 Sekunden im Frontend hält, dann clear
  • Copy: gleiche Audit-Wirkung
  • Edit: optimistic-Locking (last updated_at Mitschicken, Block bei Konflikt)
  • Hard-Delete: Klartext-Warnung „Eintrag wird unwiderruflich gelöscht."

Vault-Verwaltung (/{tenant}/admin/hr/password-safe)

Tenant-Admin-Sicht — alle Vaults sichtbar (auch ohne Access am Inhalt):

  • Vault-Anlage / Archivierung / Hard-Delete
  • Access-Verwaltung pro Vault
  • Audit-Log-Übersicht (alle Reveals, Group-by-User, Group-by-Vault)

Verschlüsselung (Architektur-Pflicht)

  • Per-Tenant-Master-Key in KMS (z.B. Scaleway-KMS)
  • Per-Eintrag-DEK (Data Encryption Key) gewrappt mit Master-Key
  • Algorithmus: AES-256-GCM
  • DB speichert nur verschlüsselte Werte + Wrapped-DEK
  • Server entschlüsselt on-demand beim Read mit Permission-Check
  • Frontend bekommt Klartext nur über HTTPS-Antwort, hält max. 30 Sekunden, ist nicht persistent
  • Audit-Log: jede Entschlüsselung mit User, Eintrag-ID, Timestamp, IP, User-Agent geloggt

Edge-Cases

  • User wird aus Tenant entfernt → Vault-Access automatisch revoked, aktive Sessions invalidiert
  • Vault-Owner verlässt Tenant → falls einziger admin: Tenant-Admin wird admin (Auto-Reassign mit Klartext-Hinweis)
  • Master-Key-Rotation: Phase 2

Block K — HR-Surveys

Liste (/{tenant}/hr/surveys)

Zu zeigende Daten:

  • Offene Surveys, an denen User teilnehmen darf (Audience-Match)
  • Pro Eintrag: Titel, Beschreibung-Vorschau, Frist, Eigener Submission-Status

Operationen:

  • Klick → Teilnahme

Teilnahme (/{tenant}/hr/surveys/:id)

Workflow:

  • Survey-Items werden gerendert wie M5-Form
  • Pflicht-Validation
  • Bei is_anonymous=true: Klartext-Hinweis „Diese Umfrage ist anonym — deine Antworten werden ohne Namens-Zuordnung gespeichert."
  • Submit → HrSurveySubmission + Answers
  • Bei allow_multiple_submissions=false: nach Submit kein erneuter Zugriff (submitter_hash blockiert)

Auswertung (/{tenant}/hr/surveys/:id/results)

Zu zeigende Daten je nach result_visibility:

  • Antworten-Counts pro Item
  • Visualisierungen (Bar-Chart für Choice-Items, Avg-Score für Rating-Items, NPS-Score, Word-Cloud für Text-Items — Phase 1 mindestens Counts und Avg)
  • Bei is_anonymous=false: Liste der Submitter (Permission-gegated)
  • Bei is_anonymous=true: nur Aggregate, keine Submitter-IDs

Operationen:

  • Export als CSV (Permission-gegated)
  • Survey schließen / wieder öffnen

Verwaltung (/{tenant}/admin/hr/surveys)

Operationen:

  • Survey anlegen / Items konfigurieren
  • Audience setzen
  • Veröffentlichung steuern
  • Schließen / Archivieren
  • Reminder an Nicht-Teilnehmer schicken

Zu zeigende Daten:

  • Audience-gefilterte Liste mit Icon, Label, URL
  • Sortierung nach position

Operationen User: Klick → externes Ziel (Tab je nach Setting)

Verwaltung (/{tenant}/admin/hr/quick-links):

  • Anlegen / sortieren / archivieren
  • Audience setzen

Resources (/{tenant}/hr/resources)

Zu zeigende Daten:

  • Audience-gefilterte Ressourcen, gruppiert nach Kategorie
  • Pro Eintrag: Titel, Beschreibung, Kind-Icon (Link / File / Text)

Operationen User:

  • Klick auf Link → öffnet
  • Klick auf File → Download / Vorschau
  • Klick auf Text → Inline-Detail

Verwaltung (/{tenant}/admin/hr/resources):

  • Anlegen / sortieren / archivieren
  • Audience setzen
  • Kategorien pflegen

Block M — Activity-Stream-Integration

Activity-Typen (Erweiterung M1 Block E)

  • hr.announcement_published
  • hr.announcement_acknowledged
  • hr.vacation_requested / hr.vacation_approved / hr.vacation_rejected / hr.vacation_withdrawn
  • hr.sick_leave_reported / hr.sick_leave_returned / hr.sick_leave_cancelled
  • hr.payslip_uploaded (Subject = User-Profil; sichtbar nur User selbst + HR-Admin)
  • hr.payslip_read (gegated)
  • hr.document_uploaded (Subject = User-Profil; gegated nach Visibility)
  • hr.document_expiring_soon (System-Activity bei valid_until Annäherung)
  • hr.upload_reminder_sent / hr.upload_reminder_fulfilled / hr.upload_reminder_overdue
  • hr.request_submitted / hr.request_approved / hr.request_rejected / hr.request_completed
  • hr.password_safe_revealed (Subject = Vault; sichtbar nur Vault-Admin + HR-Admin)
  • hr.survey_published / hr.survey_submitted (gegated nach Anonymität)

Verknüpfungen:

  • HR-Activities erscheinen im User-Profil-Stream und (gegated) im Aggregat-Stream der Tenant-Admins
  • Plantafel-Konflikt-Indikatoren beziehen sich auf hr.vacation_approved und hr.sick_leave_reported

Block N — Integration mit anderen Modulen

M4 Auftragspipeline / Plantafel

  • Genehmigte Urlaube + aktive Krankmeldungen werden als Konflikt-Indikatoren in der Plantafel angezeigt
  • Beim Anlegen einer ScheduleEntry, die Urlaub/Krank überschneidet: Klartext-Warnung (siehe M4 Block G)
  • Plantafel kann „Abwesenheits-Layer" toggeln (ein/aus)

M5 Form Builder

  • Krankmeldung + Urlaubsantrag laufen als Forms (Templates Krankmeldung / Urlaubsantrag)
  • Request-Templates können Forms referenzieren
  • Upload-Reminder können Forms referenzieren
  • Form-Action create_hr_vacation_request, create_hr_sick_leave, create_hr_request, create_hr_employee_document

M22 Notifications

  • Push + Email an Approver bei Antrag
  • Push + Email an Antragsteller bei Entscheidung
  • Push + Email an HR-Admin bei AU-Bescheinigungs-Versäumnis
  • Push an Audience bei neuer Announcement (mit requires_acknowledgement-Markierung)
  • Push bei Reminder-Fälligkeit

M25 Calendar

  • Genehmigter Urlaub → Calendar-Event in eigenem Kalender Antragsteller (Tenant-default-konfigurierbar: ganztags / sichtbar als „Außer Haus")
  • Optional Tenant-Kalender „Team-Urlaube" (alle MA-Urlaube aggregiert) für PL-Sicht
  • Sync zu Google/Microsoft (Modul 25)

M17 Automation-Engine

Trigger:

  • hr.announcement_published
  • hr.vacation_requested / hr.vacation_approved / hr.vacation_rejected
  • hr.sick_leave_reported
  • hr.request_submitted / hr.request_status_changed
  • hr.upload_reminder_overdue
  • hr.document_expiring_soon
  • hr.payslip_uploaded
  • hr.survey_submitted

Actions:

  • hr.send_announcement (System postet auto-Announcement, z.B. Welcome bei neuem MA)
  • hr.create_request (z.B. Auto-Antrag bei Trigger)
  • hr.create_upload_reminder_dispatch
  • hr.notify_manager
  • hr.set_request_status
  • hr.archive_announcement

M23 Files

  • Alle Dokument-Anhänge (Payslips, Employee-Docs, Sick-Certs, Announcement-Attachments, Request-Attachments, Survey-Attachments) liegen in M23 unter tenant-isolierten Pfaden
  • Sensible Pfade (Payslips, Sick-Certs, Password-Safe-Backups Phase 2) zusätzlich App-Permission-gegated
  • Ablauf-Tracking für valid_until-Felder läuft über M23-Integration mit expires_at-Setting (Phase 2)

M13 Team-Chat

  • Direkt-Chat-Start aus MA-Verzeichnis
  • Optional: Auto-Chat-Channel pro Standort (Phase 2)

M27 Auth / Permissions

  • Permissions-Definition siehe Block O
  • Tenant-Admin → automatisch alle HR-Permissions
  • 2FA-Pflicht für hr.read_all und hr.upload_payslip empfohlen (Tenant-Admin-Setting)

M35 DSGVO-Export / Löschung

  • HR-Daten werden vollständig in MA-Datenexport eingeschlossen
  • Bei MA-Löschung aus Workspace: HR-Profil + Dokumente + Payslips bleiben Audit-Compliance-konform archiviert (gesetzliche Aufbewahrungspflichten 6/10 Jahre); PII anonymisiert wo möglich

Block O — Permissions-Anwendung

Permission-IDs

Permission Erlaubt
hr.read_own Eigene Profildaten, eigene Dokumente, eigene Payslips, eigene Anträge, eigene Krankmeldungen, eigene Survey-Submissions
hr.read_team Profile + Anträge des eigenen Teams (User mit manager_user_id = self) — typisch PL/Bauleiter
hr.read_all Alle MA-Profile (außer sensible Felder), alle Anträge, alle Krankmeldungen-Stammdaten (kein AU-Cert), Standorte, Verzeichnis voll
hr.read_sensitive AU-Bescheinigungen, Notfallkontakt-Daten, Lohnabrechnungen aller MA, sensible Dokumente
hr.write_own Eigene Profilfelder editieren, eigene Anträge stellen, eigene Dokumente hochladen, eigene Krankmeldung melden, eigenen Urlaub beantragen
hr.approve_team Anträge und Urlaube des eigenen Teams genehmigen/ablehnen
hr.approve_all Anträge und Urlaube tenant-weit genehmigen/ablehnen
hr.upload_payslip Payslips hochladen / löschen
hr.write_announcement Announcements anlegen + bearbeiten
hr.publish_announcement Announcements veröffentlichen + pinnen
hr.write_resource Resources / Quick-Links anlegen + verwalten
hr.write_survey Surveys anlegen + veröffentlichen + auswerten
hr.write_request_template Request-Templates verwalten
hr.write_upload_reminder Upload-Reminder verwalten
hr.manage_employees MA-Profile editieren (Personalnummer, Manager, Position, Location, Hire-Date)
hr.password_safe.access Genereller Zugang zum Password-Safe-Modul (zusätzlich pro Vault EmployeePasswordSafeAccess)
hr.password_safe.admin Vault-Verwaltung tenant-weit
hr.admin Voll-Verwaltung HR (alles obige)

Bundle-Mapping (Variante 2)

Bundle Atomare Permissions
hr.none (keine — User hat keinen HR-Hub-Tab in Sidebar)
hr.employee read_own + write_own + password_safe.access (Vault-Access kommt pro Vault)
hr.team_lead obigen + read_team + approve_team
hr.office obigen + read_all + read_sensitive + upload_payslip + manage_employees + write_announcement + write_resource
hr.admin alle

Default-Rollen-Zuweisung (SHK-Template)

Rolle HR-Bundle
GF hr.admin
Vertriebsleiter hr.team_lead
Vertriebler hr.employee
Projektleiter / Bauleiter hr.team_lead
Büro / Backoffice hr.office
Marketing hr.employee
Monteur hr.employee

Anwendung in Routes

Route Permission
/{tenant}/hr hr.read_own (alle eingeladenen User mind.)
/{tenant}/hr/announcements hr.read_own
/{tenant}/hr/announcements/new hr.write_announcement
/{tenant}/hr/documents hr.read_all
/{tenant}/hr/my-documents hr.read_own
/{tenant}/hr/leave hr.read_own (eigene); hr.approve_team / hr.approve_all (Genehmigungs-Tab); hr.read_team / hr.read_all (Team-Übersicht)
/{tenant}/hr/leave/new hr.write_own
/{tenant}/hr/leave/vacation/:id Owner-Check (Antragsteller) ODER hr.approve_team mit Team-Match ODER hr.approve_all
/{tenant}/hr/leave/sick/:id Owner-Check ODER hr.read_team/read_all (ohne Cert) bzw. hr.read_sensitive (mit Cert)
/{tenant}/hr/locations hr.read_own (jeder im Tenant)
/{tenant}/hr/payslips hr.read_own
/{tenant}/hr/payslips/:id Owner-Check (eigener User) ODER hr.read_sensitive (HR-Admin / Büro)
/{tenant}/hr/password-safe hr.password_safe.access (zusätzlich pro Vault Access)
/{tenant}/hr/quick-links hr.read_own
/{tenant}/hr/resources hr.read_own
/{tenant}/hr/surveys hr.read_own (für Audience-Match)
/{tenant}/hr/surveys/:id/results hr.write_survey ODER result_visibility=all_participants
/{tenant}/hr/requests hr.read_own (eigene); hr.approve_team/approve_all für Genehmigungs-Sicht
/{tenant}/hr/requests/new hr.write_own
/{tenant}/hr/directory hr.read_own (alle eingeladenen User dürfen Verzeichnis sehen, aber sensible Felder gegated)
/{tenant}/hr/directory/:userId analog (sensible Felder über hr.read_sensitive)
/{tenant}/admin/hr/announcements hr.write_announcement + hr.publish_announcement
/{tenant}/admin/hr/documents hr.read_all + hr.read_sensitive
/{tenant}/admin/hr/locations hr.admin
/{tenant}/admin/hr/payslips hr.upload_payslip
/{tenant}/admin/hr/payslips/upload hr.upload_payslip
/{tenant}/admin/hr/leave hr.read_all + hr.approve_all
/{tenant}/admin/hr/upload-reminders hr.write_upload_reminder
/{tenant}/admin/hr/quick-links hr.write_resource
/{tenant}/admin/hr/resources hr.write_resource
/{tenant}/admin/hr/surveys hr.write_survey
/{tenant}/admin/hr/request-templates hr.write_request_template
/{tenant}/admin/hr/password-safe hr.password_safe.admin
/{tenant}/admin/hr/employees hr.manage_employees

Owner-Check-Logik

  • read_own / write_own: Server-Side-Prüfung entity.user_id = current_user.id für User-bezogene Tabellen
  • approve_team: Server-Side-Prüfung request.requester.manager_user_id = current_user.id
  • read_team: gleiches Manager-Pattern
  • Bei Fehl-Match: 404 statt 403 (LP-9 Information-Hiding)

UI-Anwendung

  • Sidebar-Sub-Menü dynamisch je nach Permissions: ein User mit nur hr.employee sieht keinen Admin-Bereich
  • Action-Buttons (z.B. „Genehmigen") nur sichtbar mit passender Permission
  • Sensible Feld-Werte (Notfallkontakt, AU-Cert-Link) maskiert/ausgeblendet ohne hr.read_sensitive
  • Lohnabrechnungs-Datei: Download-Link nur für Owner ODER hr.read_sensitive

Klartext-Fehler

  • Antragsteller versucht Genehmigungs-Tab zu öffnen ohne Permission: Tab gar nicht sichtbar
  • Approver versucht zu genehmigen, ist aber nicht Manager des Antragstellers: 404 mit „Antrag nicht gefunden"
  • MA versucht fremde Krankmeldung anzusehen: 404
  • HR-Admin versucht Payslip zu löschen: Klartext „Lohnabrechnungen sind 10 Jahre aufzubewahren. Stattdessen archivieren?" — tatsächlicher Hard-Delete erfordert sekundären Bestätigungs-Schritt + Audit-Log

Block P — Datenschutz / sensible Daten

Klassifizierung

Stufe 1 — Öffentlich im Tenant:

  • MA-Verzeichnis-Stammdaten (Name, Position, Team, Standort, Business-Phone, Avatar, Bio)
  • Quick-Links, Resources, Locations
  • Announcements (audience-gemäß)

Stufe 2 — Mitarbeiter-vertraulich (eigener User + HR-Admin):

  • Profil-Felder (Birthdate, Hire-Date, Address, Private-Phone, Notfallkontakt)
  • Eigene Dokumente
  • Eigene Anträge / Surveys
  • Eigene Krankmeldungs-Stammdaten

Stufe 3 — Streng vertraulich (hr.read_sensitive only):

  • Lohnabrechnungen
  • AU-Bescheinigungs-Files
  • Personalnummer
  • Vertragliche Detail-Dokumente

Stufe 4 — Verschlüsselt (Password-Safe):

  • Vault-Einträge — siehe Block J

Compliance-Pflichten

  • DSGVO-Auskunftsrecht: MA kann alle eigenen Daten als JSON+Files exportieren (siehe M35)
  • DSGVO-Löschungsrecht: auf Anfrage werden Daten anonymisiert wo gesetzliche Aufbewahrungspflicht es nicht verbietet
  • Aufbewahrungspflichten DE:
    • Lohnabrechnungen: 10 Jahre
    • Arbeitsverträge / Kündigungen: 10 Jahre
    • AU-Bescheinigungen: 4 Jahre
    • Genehmigte Urlaube / Krankmeldungen: 4 Jahre
  • Bei MA-Austritt: Daten werden archiviert mit archived_at, automatischer Hard-Delete-Job nach Aufbewahrungsfrist + 1 Monat (Cron, mit Klartext-Vorschau-Hinweis an HR-Admin 30 Tage vorher)

Audit

  • Jeder Read auf hr.read_sensitive-Daten: Audit-Eintrag (User, Subject, Timestamp, IP)
  • Jede Password-Safe-Reveal-Action: Audit-Eintrag (Block J)
  • Jede Payslip-Download-Action: Audit-Eintrag
  • Audit-Log einsehbar nur durch Tenant-Admin / HR-Admin

2FA-Empfehlung

  • Tenant-Admin-Setting: 2FA-Pflicht für User mit hr.read_sensitive und hr.password_safe.admin
  • Default empfohlen, aber per Tenant-Admin überschreibbar (siehe M27 B.4)

Block Q — Klartext-Hinweise

Allgemein

  • Empty-State Hub ohne Inhalt: „Hier wirst du Bekanntmachungen, deine Lohnabrechnungen und mehr finden."
  • HR-Hub für deaktivierten Tenant (frozen): nur Read, Klartext-Banner „Workspace ist pausiert — neue Anträge nicht möglich"

Urlaub

  • Antrag erfolgreich gestellt: „Dein Urlaubsantrag wurde an [Manager] gesendet. Du erhältst eine Benachrichtigung, sobald über deinen Antrag entschieden wurde."
  • Genehmigung: „Dein Urlaub vom [Datum] bis [Datum] wurde genehmigt — Calendar-Eintrag wurde erstellt."
  • Ablehnung: „Dein Urlaubsantrag wurde abgelehnt. Begründung: [decision_note]"
  • Konflikt: „In diesem Zeitraum sind bereits 2 Mitarbeiter im Urlaub (Max M., Lisa K.). Trotzdem genehmigen?"
  • Approver-Notification: „[Mitarbeiter] beantragt Urlaub vom [Datum] bis [Datum] ([N] Arbeitstage). [Genehmigen] [Ablehnen]"

Krankmeldung

  • Erfasst: „Krankmeldung für [Datum] wurde aufgenommen — dein Vorgesetzter und das Büro sind informiert. Gute Besserung!"
  • AU-Bescheinigung-Reminder am 3. Tag: „Bitte lade bis morgen die AU-Bescheinigung hoch."
  • Rückkehr melden: „Willkommen zurück! Bitte trage deinen ersten Arbeitstag ein."

Payslip

  • Neue Lohnabrechnung verfügbar: „Deine Lohnabrechnung [Monat/Jahr] ist bereit. [Öffnen]"
  • Bulk-Upload-Erfolg: „42 von 45 Lohnabrechnungen erfolgreich zugeordnet. 3 Files ohne Match — bitte manuell prüfen."
  • Upload Doppel-Versuch: „Für [MA] existiert bereits eine Lohnabrechnung [Monat/Jahr]. Als Korrektur hochladen?"

Upload-Reminder

  • Pendant: „Bitte aktualisiere deinen Führerschein-Scan bis [Datum]."
  • Überfällig: „Dein Führerschein-Scan ist seit [Datum] überfällig — bitte zeitnah einreichen."
  • Überfällig + Manager-Eskalation: „[MA] hat den Reminder ‚Führerschein' seit 7+ Tagen nicht erfüllt."

Password-Safe

  • Reveal: „Wert wird für 30 Sekunden angezeigt und automatisch ausgeblendet."
  • Eintrag-Anlage erfolgreich: „Eintrag verschlüsselt gespeichert. Nur User mit Vault-Zugriff können den Wert entschlüsseln."
  • Vault-Access entzogen: „Dein Zugriff auf Vault [Name] wurde entfernt."

Announcements

  • Acknowledgement-Pflicht: „Bitte bestätige, dass du die Information gelesen hast."
  • Veröffentlichung: „Bekanntmachung wurde an [Audience-Beschreibung, z.B. „alle Mitarbeiter (28)"] veröffentlicht. Push-Benachrichtigungen wurden ausgelöst."

Requests

  • Antrag pending: „Dein Antrag ‚[Titel]' wurde an [Approver] geschickt."
  • Approver-Internal-Note: „[Notiz] (intern, nur für Genehmiger sichtbar)"

Surveys

  • Anonym-Hinweis: „Diese Umfrage ist anonym — deine Antworten werden nicht mit deinem Namen verknüpft gespeichert."
  • Bereits teilgenommen: „Du hast an dieser Umfrage bereits teilgenommen. Mehrfach-Teilnahme ist nicht möglich."

Block R — Phase 2

  • Resturlaub-Kontingent-Tracking: pro MA Soll/Ist-Vergleich, automatische Verrechnung, Übertrag ins Folgejahr
  • Mehr-Stufen-Genehmigungs-Workflows: Manager → HR → GF
  • Bulk-Approve für Anträge
  • Anonyme Whistleblower-Inbox als spezielle Request-Variante
  • Onboarding-Checklisten pro neuem MA (mit verlinkten Forms, Tasks, Reminders)
  • Offboarding-Checklisten
  • Resource-Booking (z.B. Firmenwagen, Werkstatt-Zeitfenster)
  • MA-Befragung-Auto-Versand (z.B. monatlich Pulse-Survey)
  • Geburtstags-Auto-Announcement an MA selbst und Team
  • Krankheits-Statistiken für HR-Admin (anonymisiert nach DSGVO)
  • Multi-Sprachen-Profil (i18n M30)
  • Master-Key-Rotation für Password-Safe
  • 2FA-Hardware-Key-Pflicht für Password-Safe-Admin
  • Vacation-Calendar-Sharing auf Standort-Ebene mit konfigurierbaren Sicht-Levels
  • Quiply-Migrations-Tool (Datenimport für Bestandskunden)
  • Skill-/Qualifikations-Matrix pro MA
  • Integration mit externen Lohn-Systemen (DATEV, Lexware) — über Apps Engine M33a
  • Survey-Word-Cloud / Sentiment-Analyse (KI M18, EU-Provider)
  • Erweiterte Audit-Reports (DSGVO-Compliance-Reports)
  • Custom-Felder pro HrEmployeeProfile (analog M1 Custom-Felder)
  • Mehr Reaction-Emojis (Tenant-Admin-konfigurierbar)
  • Threading-Tiefe > 1 für Announcement-Comments
  • Conditional-Audience (z.B. nur User mit Tag X)

Architektur-Vorschriften (Querschnitt)

  • LP-2: Mobile-First für eigene Anträge, Krankmeldung, Payslip-Viewer
  • LP-3, AV #3: SHK-Template-Seeding für Request-Templates, Default-Reminder, Default-Announcements
  • LP-7: Quiply-Komplett-Ablösung — alle dort genutzten Funktionen müssen in Phase 1 abgedeckt sein
  • LP-9: UI-Element-Anforderungen als Liste, kein Layout
  • LP-10, AV #1: Klartext-Diagnostik überall (Beispiele in Block Q)
  • LP-13: EU-Stack für sensible Daten — Storage in Scaleway-Buckets, KMS in Scaleway, kein US-Cloud-Provider
  • AV #5: Permissions-aware-Default in allen Listen/Suchen
  • AV #6: Audit-Trail-Default für alle schreibenden Aktionen UND für sensible Reads (Payslip, Sick-Cert, Password-Safe)
  • AV #7: Feature-Flag-Hülle für neue HR-Features (z.B. hr.feature_resturlaub_tracking)
  • AV #20: KI darf keine Anträge / Genehmigungen ohne User-Bestätigung auslösen

Detail-Spec-Status: DRAFT

Erste vollständige Detail-Spec für Modul 14 (HR-Hub). Vor Bau: Verifizierung mit Noah, speziell zu:

  • DE-Aufbewahrungsfristen-Mapping (10/4 Jahre)
  • Quiply-Feature-Parität-Sweep (welche Features fehlen ggf. noch)
  • Default-Approver-Logik bei Multi-Manager-MA
  • Master-Key-Architektur und KMS-Integration (Scaleway-KMS-Details)

Offene Detail-Punkte (nicht-blockierend):

  • DE-Feiertagskalender pro Bundesland (Datenquelle / Library)
  • AU-Bescheinigungs-Pflicht-Tag konfigurierbar pro Tenant (3-Tage-Default)
  • Auto-Match-Pattern für Payslip-Bulk-Upload (Tenant-konfigurierbar)
  • Konkrete SHK-Default-Templates für Request, Survey, Announcement
  • Subframe-UI-Designs (separat)
  • Cron-Frequenz für Reminder-Engine (täglich vs. stündlich)
  • Performance-Strategie für Aggregat-Queries auf Plantafel-Konflikt-Detection bei 50+ MA
  • Mehrfach-Sprache der Klartext-Fehler in Phase 2 (heute DE-only)

Abhängige Module:

  • M27 (Auth/Permissions) — Permission-IDs werden hier registriert
  • M5 (Form Builder) — Templates für Krankmeldung/Urlaubsantrag/Request-Forms
  • M4 (Auftragspipeline) — Plantafel-Konflikt-Detection
  • M22 (Notifications) — alle Push/Email-Versende
  • M25 (Calendar) — Urlaubs-Calendar-Events
  • M17 (Automation) — Trigger + Actions
  • M23 (Files) — Storage für alle Anhänge
  • M35 (DSGVO-Export) — HR-Daten in Export inkludieren