--- module: 14 title: HR-Hub / Mitarbeiterplattform phase: 1 status: detail-spec-draft last_updated: 2026-05-08 session_source: brainstorming-session-2026-05-07-2206.md related_lps: [LP-2, LP-3, LP-7, LP-9, LP-10, LP-13] spec_style: requirements-pur size: 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` ### HrQuickLink - `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 --- ## 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_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