60 KiB
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 |
|
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 mitTenantUser)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 aufHrLocation, optional)phone_business,phone_private(separate Felder)address_street,address_zip,address_city,address_countryemergency_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_idtitle(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 nachaudience_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 — beirequires_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_atbody(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_countryphone,emailgeo_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_iddocument_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_idis_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
HrQuickLink
id,tenant_id,label,urlicon_key(Lucide-Icon-Name oder Slug)audience_kind,audience_*positionopen_in_new_tab(Boolean, default true)archived_at
HrSurvey
id,tenant_id,created_by_user_id,created_attitle,description(Markdown)is_anonymous(Boolean — anonyme Auswertung möglich, Submitter-ID dann verschleiert)audience_kind,audience_*opens_at,closes_atstatus(Enum:draft | open | closed | archived)allow_multiple_submissions(Boolean, default false)result_visibility(Enum:creator_only | hr_admins | all_participants)
HrSurveyItem
id,survey_id,positionitem_type(Enum:text | textarea | rating_5 | rating_10 | nps | single_choice | multi_choice | boolean | date)label(Pflicht),descriptionrequired(Boolean)options[](für Choice-Items)
HrSurveySubmission
id,survey_id,submitted_atsubmitter_user_id(NULL beiis_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_atrequester_user_idtemplate_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_notepriority(Enum:normal | urgent)archived_at
HrRequestTemplate
id,tenant_id,name,descriptionrequest_kinddefault_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_idlinked_form_id(optional — M5-Form für Antrag)instructions(Markdown)positionarchived_at
HrRequestComment
id,request_id,user_id,created_at,body(Markdown)is_internal_note(Boolean — Approver-only sichtbar)
EmployeePayslip
id,tenant_id,employee_user_idperiod_year,period_month(z.B. 2026, 4)file_id(FK auf File M23, Pflicht — PDF)uploaded_by_user_id,uploaded_atis_read_by_employee(Boolean — wird gesetzt wenn MA das PDF öffnet)read_atnote(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_idtitle(Pflicht, z.B. „Führerschein-Scan")description(Markdown)document_kind(Enum ausHrEmployeeDocument.document_kind)audience_kind,audience_*(welche MA betroffen)cadence_kind(Enum:once | yearly | every_n_months | on_expiry)cadence_n_months(fürevery_n_months)expiry_lookahead_days(füron_expiry— z.B. 30 Tage vorvalid_until)due_date(füronce)is_mandatory(Boolean — beitrueerscheint im Dashboard als Block)linked_form_id(optional — M5-Form für Upload statt nur File)archived_at
EmployeeUploadReminderDispatch
id,reminder_id,employee_user_iddue_at,dispatched_atstatus(Enum:pending | sent | fulfilled | overdue | dismissed)fulfilled_document_id(FK aufHrEmployeeDocument)fulfilled_atreminder_count(wie oft erinnert)
EmployeeVacationRequest
id,tenant_id,requester_user_idstart_date,end_date(Pflicht, inklusiv)working_days_count(berechnet — netto Arbeitstage zwischenstart_dateundend_dateohne 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_iddecided_at,decided_by_user_id,decision_notecalendar_event_id(FK auf M25-Calendar-Event, gesetzt beiapproved)auto_archive_at
EmployeeSickLeaveReport
id,tenant_id,employee_user_idreported_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 vonemployee_user_idabweichen — Büro meldet im Auftrag)status(Enum:active | returned | cancelled)
EmployeePasswordSafeVault
id,tenant_id,name(Pflicht, z.B. „IT-Disposition")descriptioncreated_by_user_id,created_atarchived_at
EmployeePasswordSafeEntry
id,tenant_id,vault_idtitle(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_atlast_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-SortierungHrAnnouncementRead (announcement_id, user_id)UniqueEmployeePayslip (tenant_id, employee_user_id, period_year DESC, period_month DESC)für ListeEmployeeVacationRequest (tenant_id, status, start_date, end_date)für Plantafel-LookupEmployeeSickLeaveReport (tenant_id, employee_user_id, status, start_date)für aktive SichtEmployeeUploadReminderDispatch (tenant_id, employee_user_id, status, due_at)für DashboardEmployeePasswordSafeEntry (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}/hrals 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
birthdategepflegt 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_acknowledgementund 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_idaus Profil; bei Multi-Manager-Setup wählbar)
Validation beim Submit:
end_date >= start_datestart_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_countautomatisch berechnet aus DE-Feiertagskalender des Standortes (Bundesland ausHrLocation.address_*)
Auto-Submit-Aktionen:
EmployeeVacationRequestangelegt mit Statussubmittedundform_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) → Statuswithdrawn - 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 wennhas_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):
EmployeeSickLeaveReportangelegt, Statusactive- Auto-Versand ans Büro: Email + Notification an alle User mit Permission
hr.read_allUND 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=falseundstart_date >= today + 3(DE-Recht): automatischer Reminder-Eintrag „AU-Bescheinigung bis [3. Tag] vorlegen"
Operationen Antragsteller:
- Verlängern (
expected_return_dateaktualisieren) → erneute Notification - Bescheinigung nachreichen (File-Upload)
- Rückkehr melden (
actual_return_datesetzen, 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_employeeAudit bleibt)
Bulk-Upload-Workflow (/{tenant}/admin/hr/payslips/upload)
Schritte:
- Periode wählen (Jahr + Monat)
- PDF-Files hochladen (mehrere via Drag-&-Drop oder ZIP)
- Auto-Match-Logik:
- PDF-Dateiname-Pattern wird konfiguriert (z.B.
{personal_number}-{yyyy-mm}.pdfoder{lastname}-{yyyy-mm}.pdf) - System matcht jede PDF zu MA über Personalnummer / Lastname-Match
- PDF-Dateiname-Pattern wird konfiguriert (z.B.
- 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
- Bestätigen → Auto-Anlage
EmployeePayslippro MA - Notification an MA: „Neue Lohnabrechnung verfügbar" (Push + Email konfigurierbar)
- 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 wenndue_date - 14 Tageerreicht - Bei
yearly: jährlich dispatchen am gleichen Tag wie Erst-Dispatch - Bei
every_n_months: alle N Monate - Bei
on_expiry: wennHrEmployeeDocument.valid_until - lookahead_dayserreicht
- Bei
- Erstellt
EmployeeUploadReminderDispatchmit Statuspending - 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_counthoch, wiederholt Notification alle 3 Tage bisfulfilled
Erfüllung
- MA klickt Reminder → wird zu Upload-Workflow geleitet
- Falls
linked_form_id: Form öffnet sich, Submit erzeugtHrEmployeeDocumentautomatisch - Falls keine Form: direkter Upload mit Auto-Vorausfüllung (
document_kind,valid_from,valid_untilfalls Pattern erkennbar) - Dispatch-Status →
fulfilled,fulfilled_document_idgesetzt - 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:
- Template-Auswahl (Liste der für User sichtbaren Templates) — alternativ „Sonstiger Antrag" für freien Antrag
- Linked-Form wird gerendert (falls vorhanden) — sonst Titel + Body-Eingabe
- Approver-Vorauswahl basierend auf Template-Logik (User kann ändern falls Permission)
- Priority setzen (normal / urgent)
- Anhänge hochladen
- Submit →
HrRequestStatussubmitted, 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_noteausgeblendet 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_atMitschicken, 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 wirdadmin(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_hashblockiert)
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
Block L — Quick-Links + Resources
Quick-Links (/{tenant}/hr/quick-links)
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_publishedhr.announcement_acknowledgedhr.vacation_requested/hr.vacation_approved/hr.vacation_rejected/hr.vacation_withdrawnhr.sick_leave_reported/hr.sick_leave_returned/hr.sick_leave_cancelledhr.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 beivalid_untilAnnäherung)hr.upload_reminder_sent/hr.upload_reminder_fulfilled/hr.upload_reminder_overduehr.request_submitted/hr.request_approved/hr.request_rejected/hr.request_completedhr.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_approvedundhr.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_publishedhr.vacation_requested/hr.vacation_approved/hr.vacation_rejectedhr.sick_leave_reportedhr.request_submitted/hr.request_status_changedhr.upload_reminder_overduehr.document_expiring_soonhr.payslip_uploadedhr.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_dispatchhr.notify_managerhr.set_request_statushr.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 mitexpires_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_allundhr.upload_payslipempfohlen (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üfungentity.user_id = current_user.idfür User-bezogene Tabellenapprove_team: Server-Side-Prüfungrequest.requester.manager_user_id = current_user.idread_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.employeesieht 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_sensitiveundhr.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