1413 lines
60 KiB
Markdown
1413 lines
60 KiB
Markdown
---
|
||
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
|