23 KiB
Boilerplate-Mapping: M14 — HR-Hub / Mitarbeiterplattform
Abgleich-Report. Stellt fest, was fuer M14 aus der Boilerplate (
/Users/raffaelsheikh/Documents/GitHub/boilerplate) uebernommen werden kann, was angepasst werden muss und was komplett fehlt. Boilerplate wurde NUR gelesen. Alle Pfade absolut.
Kopf
| Feld | Wert |
|---|---|
| Modul-ID | M14 |
| Name | HR-Hub / Mitarbeiterplattform |
| Spec | /Users/raffaelsheikh/Documents/GitHub/HiveGrid-Cloud/_bmad-output/specs/M14-hr-hub.md |
| Milestones | M133 (Stammdaten+Standorte), M134 (Dokumente), M135 (Urlaub), M136 (Krankmeldungen), M137 (Kommunikation/Announcements/Quick-Links/Resources/Password-Safe), M138 (Onboarding-Drittanbieter), M139 (Anträge+Surveys+Lohn-Export+DSGVO), M140 (MA-Selbstbedienung/Hub) |
| Pflichtenheft-Block | Block 6, Modul 14 (_bmad-output/pflichtenheft/blocks/block6.md Abschnitte 14.1–14.17) |
| Size | XL |
| Reuse-Level | low (kein einziges HR-Domänen-Modell vorhanden; aber sehr starke Querschnitt-/Infrastruktur-Basis) |
Begründung Reuse-Level = low
Die HR-Fachdomäne ist in der Boilerplate vollständig abwesend: es gibt keine der 21 in der Spec genannten Entitäten als Prisma-Modell und kein HR-Modul in apps/web. Verifiziert per Grep gegen prisma/schema/*.prisma (keine Treffer auf Hr*, Employee*, Vacation*, Sick*, Payslip*, PasswordSafe*, Announcement*, Survey*, Leave*) und gegen apps/web/app/** (kein hr/, employee/, payslip/, vacation/, announcement/, directory/-Verzeichnis).
Trotzdem ist der Wiederverwendungs-Hebel auf der Querschnitt-/Infrastruktur-Ebene hoch: Verschlüsselung (AES-256-GCM-Helper), Storage+Signed-URLs, Audit-Hash-Kette, Notifications (In-App/E-Mail/Push), Permissions/Owner-Check, Export (CSV/DSGVO/Audit-PDF), Import (Bulk/Dedupe — für Payslip-Bulk-Upload), Form-Widget, Worker/Cron (Reminder-Engine), Feature-Flags und das View-Model-/Sidebar-Registry-Fundament sind alle vorhanden. M14 baut sein Datenmodell + Service-Layer + UI neu, klinkt sich aber durchgängig in fertige Querschnitte ein.
Übernehmbar aus Boilerplate
| Boilerplate-Pfad | Was | Wie nutzbar |
|---|---|---|
/Users/raffaelsheikh/Documents/GitHub/boilerplate/apps/web/app/utils/api/.server/CryptoApi.ts |
AES-256-GCM Encrypt/Decrypt (aes-256-gcm, 12-Byte-IV, AuthTag, versioniertes v1:iv:tag:ct-Format, Key = SHA-256 von CRYPTO_SECRET) |
als-vorlage — direkt für Password-Safe-Werte (username/password/notes_encrypted) und Sick-Cert-Encryption. ACHTUNG: nutzt einen Env-Key, nicht Per-Tenant-KMS/per-Eintrag-DEK wie die Spec (Block J) fordert → Architektur-Lücke (s.u.) |
/Users/raffaelsheikh/Documents/GitHub/boilerplate/apps/web/app/utils/leads/marketingIntegrations.db.server.ts |
Muster „selektive Feld-Verschlüsselung at-rest in JSON + nie Re-Display im UI" (encryptSensitive/decryptSensitive mit CRYPTO_TAG-Prefix, Merge+Re-Encrypt bei Patch) |
als-vorlage — exakt das Reveal/Edit-Verhalten für Password-Safe-Einträge (UI zeigt entschlüsselten Wert nie automatisch) |
/Users/raffaelsheikh/Documents/GitHub/boilerplate/packages/storage/src/index.ts + /Users/raffaelsheikh/Documents/GitHub/boilerplate/packages/storage/src/signed/ |
putObject, Signed-Upload/-Download, S3/Scaleway-Provider |
1:1 — für alle Datei-Anhänge (Payslips, Employee-Docs, Sick-Certs, Announcement-/Request-Attachments). Tenant-isolierte Pfade (tenants/{tenantId}/payslips/{userId}/…) als Key-Konvention selbst setzen |
prisma/schema/core.prisma → model FileObject (/Users/raffaelsheikh/.../boilerplate/prisma/schema/core.prisma) |
Storage-Metadaten-Modell (provider/bucket/key/contentType/byteSize/checksumSha256, signed-Timestamps) |
1:1 — File-Referenzen aller HR-Dokumente (Spec verweist auf „File M23"; M23 = dieses FileObject) |
/Users/raffaelsheikh/Documents/GitHub/boilerplate/packages/foundation/src/notifications.ts |
notify/notifyMany/bundleNotifications, Preference-Check, sourceKey-Upsert, assertI18nKey |
1:1 — alle M14-Notifications (Approver/Antragsteller/HR-Admin/Reminder/Announcement-Push). INTEGRATION-CONTRACTS §6 verlangt notify() statt Direkt-Versand |
prisma/schema/notifications.prisma → NotificationDelivery, UserNotificationPreference, DeviceToken |
In-App + E-Mail + Push-Token-Modelle (APNs/FCM/WebPush) | 1:1 — Push für Krankmeldung/Urlaub/Payslip/Reminder (Spec Block N M22); Mobile-Push bereits modelliert |
/Users/raffaelsheikh/Documents/GitHub/boilerplate/packages/foundation/src/permissions.ts |
withTenantScope, withPermission, withOwnerCheck, requirePermission; Fehlschlag = CatalogError(notFound) (404, nicht 403) |
1:1 — deckt Block O exakt: Owner-Check (read_own), 404-statt-403 (LP-9 Information-Hiding), Tenant-Scope. HR-Permission-IDs selbst registrieren |
prisma/schema/permissions.prisma → Role, Permission, RolePermission, UserRole, Group, GroupUser |
RBAC-Fundament; Group/GroupUser für Audience-Auflösung (audience_group_ids) |
1:1 — HR-Permission-Bundles (hr.employee…hr.admin) als Permission-Sätze + Default-Rollen-Zuweisung. Audience „groups" nutzt Group |
/Users/raffaelsheikh/Documents/GitHub/boilerplate/packages/foundation/src/audit.ts + /Users/raffaelsheikh/.../packages/db/src/audit-hash.ts |
auditEvent/withAuditMiddleware; tamper-evidente Hash-Kette (previousHash/eventHash), dataSensitivity, regulatoryScope[] |
1:1 — Block P „Audit": Pflicht-Audit für sensible Reads (Payslip-Download, Sick-Cert-Einsicht, Password-Safe-Reveal), regulatoryScope=gdpr, dataSensitivity=pii |
prisma/schema/core.prisma → AuditEvent |
Audit-Trail-Tabelle (actor, target, outcome, Hash-Chain) | 1:1 — alle schreibenden HR-Aktionen + sensible Reads |
/Users/raffaelsheikh/Documents/GitHub/boilerplate/packages/foundation/src/idempotency.ts + core.prisma:IdempotencyKey |
withIdempotency (scope+key, In-Process-Lock, 409 bei Konflikt) |
1:1 — Antrags-Submit, Payslip-Bulk-Upload, Reveal-Endpoint (Replay-Schutz) |
/Users/raffaelsheikh/Documents/GitHub/boilerplate/packages/exports/ (./csv, ./json, ./pdf, ./audit-pdf, ./s3-multipart, ./limits) |
Streaming-Export CSV/JSON/PDF + Audit-Compliance-PDF + Plan-Row-Caps | 1:1 — M139 Lohn-Export-CSV (Steuerberater), Survey-CSV-Export, DSGVO-MA-Datenexport, Audit-Reports |
/Users/raffaelsheikh/Documents/GitHub/boilerplate/apps/worker/src/jobs/dsgvo-export.ts + /Users/raffaelsheikh/.../packages/db/src/dsgvo/user-fk-map.ts |
DSGVO-Personal-Data-Export-Job (aggregiert alle User-FK-Rows, JSON-Bundle → S3 → Signed-URL → AuditEvent) | anpassen — neue HR-Modelle in USER_FK_MAP eintragen (Pflicht, sonst CI-Bruch), dann deckt der Job M14 Block P „DSGVO-Auskunftsrecht" + M139 14.16.5 ab |
/Users/raffaelsheikh/Documents/GitHub/boilerplate/packages/imports/ (createImportDryRunPreview, dedupe, Diagnose-Redaction) |
Bulk-Import-Framework mit Dry-Run-Preview + Dedupe + PII-Redaction | als-vorlage — Payslip-Bulk-Upload (Block F): Match-Vorschau (Hard/Soft/No-Match), Doppel-Upload-Erkennung. Dateiname-Pattern-Match ({personal_number}-{yyyy-mm}.pdf) ist HR-spezifisch und neu |
prisma/schema/imports.prisma → ImportJob |
Job-Tracking (accepted/rejected rows, error-report) | anpassen — Bulk-Upload-Status + Aktivitäts-Bericht (Block F Schritt 7) |
/Users/raffaelsheikh/Documents/GitHub/boilerplate/packages/form-widget/ + prisma/schema/formWidget.prisma (Form, FormSubmission) + apps/web/app/modules/formWidget/builder/ |
Form-Definition (Zod), Submission-Routing, Field-Mapping, Form-Builder-UI | anpassen — Urlaubsantrag/Krankmeldung/Request laufen laut Spec (Block E/H, Block N M5) als M5-Forms; form_submission_id-FKs zeigen darauf. Neue Form-Action-Typen (create_hr_vacation_request…) sind HR-spezifisch zu ergänzen |
/Users/raffaelsheikh/Documents/GitHub/boilerplate/packages/db/src/outbox.ts + apps/worker/src/outbox/event-router.ts |
Transaktionaler Outbox-Publisher + Event-Routing (Prefix→Queue) | 1:1 — alle HR-Side-Effects (Activity, Notification, Automation-Trigger hr.*) atomar mit DB-Write. Block M Activity-Typen als Outbox-Events |
/Users/raffaelsheikh/Documents/GitHub/boilerplate/apps/worker/ (Cron-Scheduler, BullMQ-Gruppen, HandlerDependencies) |
Worker-Runtime mit single-instance Cron + Queue-Consumer | anpassen — Reminder-Engine (Block G: täglicher Cron once/yearly/every_n_months/on_expiry), Überfälligkeits-Eskalation, Aufbewahrungs-Hard-Delete-Cron (Block P) als neue Jobs nach Muster von dsgvo-grace-cron.ts/audit-retention.ts |
/Users/raffaelsheikh/Documents/GitHub/boilerplate/packages/feature-flags/ + packages/foundation/src/flags.ts |
Feature-Flag-Engine v2 (Targeting) + leichtgewichtige Gates | 1:1 — AV #7 „Feature-Flag-Hülle" (hr.feature_resturlaub_tracking), Modul ohne Deploy abschaltbar (DoD) |
/Users/raffaelsheikh/Documents/GitHub/boilerplate/packages/view-models/src/index.ts |
VMState, ActionCallbacks, RegistryGate, I18nLabel, SidebarRegistryItem, assertI18nLabel |
1:1 — Loader-baut-VM-Disziplin (DoD „Code-Layer-Disziplin"), Sidebar-Gating per Permission/Flag |
/Users/raffaelsheikh/Documents/GitHub/boilerplate/apps/web/app/components/layouts/sidebars/shadcn/ + app/application/sidebar/AppSidebar.tsx, SidebarItem.ts |
App-Shell (App/Admin/Docs), datengetriebene Sidebar mit Permission-/Feature-Gate, Breadcrumb-Header, Mobile-Sidebar | als-vorlage — HR-Hub-Hauptpunkt + kontextabhängige Sub-Punkte (Block B); HiveGrid registriert real in packages/ui-hivegrid/src/app-shell/sidebar.config.ts (INTEGRATION-CONTRACTS §1) |
/Users/raffaelsheikh/Documents/GitHub/boilerplate/apps/web/app/components/ui/ (table, tabs, dialog, sheet, form, calendar, chart, multi-select, pagination, command, badge, card, drawer, stepper, modals, emptyState, loaders, pdf-viewer, editors) |
shadcn/Radix-Primitives + Tabellen/Forms/Modale/Empty-/Loading-States/PDF-Viewer/Markdown-Editoren | als-vorlage — Feed-Listen, Detail-Views, Reveal-Dialoge, Payslip-PDF-Viewer, Leave-Kalendersicht (calendar.tsx/chart.tsx), Survey-Auswertung (chart.tsx für Bar/NPS) |
/Users/raffaelsheikh/Documents/GitHub/boilerplate/packages/i18n/ + apps/web/app/locale/ |
i18n (de/en), Intl-Formatter (Datum/Zahl), ICU-Plurale, useTranslate |
1:1 — alle Klartext-Hinweise (Block Q) als i18n-Keys (DoD + INTEGRATION-CONTRACTS §10). Locale-File neu: packages/i18n/src/locales/de/hr.json |
/Users/raffaelsheikh/Documents/GitHub/boilerplate/apps/web/app/components/entities/ (Entity-Builder: Properties, Views, RowComment/RowCommentReaction, RowTask, RowTag) |
No-Code-Entity-Engine inkl. Kommentare+Reaktionen+Tags-Muster | als-vorlage — Announcement-Comments/-Reactions und Request-Comments können das RowComment/RowCommentReaction-Muster adaptieren; Phase-2-Custom-Felder pro HrEmployeeProfile (Block R) per Entity-Builder |
/Users/raffaelsheikh/Documents/GitHub/boilerplate/prisma/schema/appsEngine.prisma (App, DataConnection, AppSyncRun, AppSyncRunLog, AppSyncItem) + apps/web/app/modules/onboarding/ |
Integrations-/Sync-Engine (verschlüsselte Credentials, Rollback-fähige Sync-Runs) + Onboarding-Flow-Modelle | anpassen — M138 Onboarding-Drittanbieter (Memberspot/Boobora) via Apps-Engine: Read-Sync Modul-Abschlüsse/Zertifikate/Quiz/Fortschritt = AppSyncRun/AppSyncItem-Muster |
/Users/raffaelsheikh/Documents/GitHub/boilerplate/packages/db/src/client.server.ts + transactions.server.ts |
getDbClient/getReadDbClient/getExtendedDbClient, runDbTransaction |
1:1 — DB-Boundary für alle HR-Repositories; Read-Replica für Hub-/Verzeichnis-Dashboards |
prisma/schema/app.prisma (// custom database models) |
Leerer Platzhalter für projekt-eigene Modelle | 1:1 — vorgesehener Ort für ALLE 21 HR-Modelle (alternativ HiveGrid-eigene Schema-Datei hr.prisma) |
/Users/raffaelsheikh/Documents/GitHub/boilerplate/packages/db/src/search/indexed-entities.ts (per INTEGRATION-CONTRACTS §7) |
Such-Index-Registry | anpassen — MA-Verzeichnis-Suche, Announcement-Volltextsuche registrieren |
Vorhandene Daten-Modelle (konkrete Prisma-Modelle, die M14 nutzt/erweitert)
Wichtig: KEIN HR-Domänen-Modell existiert. Folgende Boilerplate-Modelle sind Anbindungs-/Querschnitt-Modelle, auf die M14 verweist:
| Modell | Pfad | M14-Bezug |
|---|---|---|
TenantUser, User, Tenant |
prisma/schema/accounts.prisma |
HrEmployeeProfile.user_id (1:1 mit TenantUser), manager_user_id; Auto-Seed leeres Profil bei Tenant-User-Anlage (Spec A „Sonderfall", 14.1.5). User.totpSecretEncrypted zeigt das Encrypted-Suffix-Muster für 2FA (Block P 2FA-Empfehlung) |
Role, Permission, RolePermission, UserRole, Group, GroupUser |
prisma/schema/permissions.prisma |
Permission-Bundles Block O; Audience-Auflösung groups |
FileObject |
prisma/schema/core.prisma |
Datei-Backing für file_id/attached_file_ids[]/certificate_file_id/avatar_file_id |
AuditEvent, IdempotencyKey, Event |
prisma/schema/core.prisma |
Audit-Trail; Idempotenz; generischer Event (kein Calendar-Event!) |
NotificationDelivery, UserNotificationPreference, DeviceToken |
prisma/schema/notifications.prisma |
Notifications/Push |
OutboxEvent |
prisma/schema/outbox.prisma |
Activity-/Automation-/Notification-Fanout (hr.*-Events) |
Form, FormSubmission |
prisma/schema/formWidget.prisma |
form_submission_id für Urlaub/Krank/Request |
ImportJob |
prisma/schema/imports.prisma |
Payslip-Bulk-Upload-Tracking |
ExportJob |
prisma/schema/queue.prisma |
Lohn-/Survey-/DSGVO-Export |
App, DataConnection, AppSyncRun, AppSyncItem |
prisma/schema/appsEngine.prisma |
M138 Drittanbieter-Onboarding-Sync |
FeatureFlag, FeatureFlagFilter, FeatureFlagAudit |
prisma/schema/featureFlags.prisma |
AV #7 Feature-Flags |
Onboarding* (7 Modelle) |
prisma/schema/onboarding.prisma |
Produkt-Onboarding-Tour (NICHT MA-Onboarding) — nur als Muster für M138 |
Lücken / komplett neu zu bauen
A. Alle 21 HR-Domänen-Modelle (komplett neu, in app.prisma / hr.prisma)
HrEmployeeProfile, HrAnnouncement, HrAnnouncementRead, HrAnnouncementReaction, HrAnnouncementComment, HrLocation, HrEmployeeDocument, HrResource, HrQuickLink, HrSurvey, HrSurveyItem, HrSurveySubmission, HrSurveySubmissionAnswer, HrRequest, HrRequestTemplate, HrRequestComment, EmployeePayslip, EmployeeUploadReminder, EmployeeUploadReminderDispatch, EmployeeVacationRequest, EmployeeSickLeaveReport, EmployeePasswordSafeVault, EmployeePasswordSafeEntry, EmployeePasswordSafeAccess — kein einziges existiert. Inkl. aller Indizes (Spec A „Indizes") und der zusätzlichen App-Code-Permission-Layer über RLS hinaus (Spec A „RLS / Datenisolation").
Pflicht beim Bau: jedes Modell mit User-FK in
packages/db/src/dsgvo/user-fk-map.tseintragen (Cascade-Strategiehard-delete/pseudonymize/retain-tombstone+includeInExport) — der CI-Test bricht sonst. HR hat gesetzliche Aufbewahrungsfristen (Block P: 10/4 Jahre) → meistretain-tombstone/anonymisieren statt hard-delete.
B. Per-Tenant-KMS / Per-Eintrag-DEK für Password-Safe (Architektur-Lücke)
Die Spec (Block J „Verschlüsselung") fordert Per-Tenant-Master-Key im KMS (Scaleway-KMS) + Per-Eintrag-DEK gewrappt mit Master-Key. Die Boilerplate liefert nur CryptoApi.ts mit einem Env-abgeleiteten Key (CRYPTO_SECRET) und keine KMS-Integration, kein DEK-Wrapping, keine Key-Rotation. → Das KMS-/DEK-Wrapping-Layer ist komplett neu zu bauen (Master-Key-Rotation explizit Phase 2). CryptoApi taugt nur als AES-256-GCM-Primitive darunter.
C. Leave-/Approval-Workflow-Engine (komplett neu)
Genehmigungs-Workflow (submitted→approved/rejected/withdrawn), Default-Approver-Auflösung (manager/fixed_user/role/group), Approver-Rückfrage, working_days_count-Berechnung. Es gibt KEINE generische Approval-Engine in der Boilerplate. Der workflows.prisma-Builder ist node-basierte Automation, kein menschlicher Genehmigungs-Workflow.
D. DE-Feiertagskalender / Bundesland-genaue Arbeitstage-Berechnung (komplett neu)
working_days_count netto ohne Wochenende + Bundesland-Feiertage (aus HrLocation). Keine Feiertags-Library/-Logik in der Boilerplate (offener Detail-Punkt in der Spec).
E. Calendar-Integration (Modell fehlt)
Spec Block N M25: genehmigter Urlaub → Calendar-Event. Es gibt kein Calendar-/CalendarEvent-Modell in der Boilerplate (nur generischer Event in core.prisma = Webhook-Event, kein Kalendereintrag). calendar_event_id-FK zeigt auf ein erst zu bauendes M25.
F. Plantafel-Konflikt-Detection (Modul-übergreifend, neu)
Spec Block N M4: genehmigte Urlaube + aktive Krankmeldungen als Konflikt-Indikatoren in Plantafel/ScheduleEntries. Kein ScheduleEntry-Modell vorhanden — gehört zu M4, ist hier nur Integrationspunkt.
G. Automation-Trigger/-Actions hr.* (neu)
Spec Block N M17: hr.vacation_requested, hr.sick_leave_reported, Actions hr.send_announcement etc. Die Outbox/Workflow-Infra existiert, aber die HR-spezifischen Trigger/Action-Definitionen + Block-Verträge sind neu.
H. Reminder-Engine-Cron-Logik (neu, Muster vorhanden)
Block G: Dispatch-Erzeugung pro Cadence, Überfälligkeits-Eskalation, reminder_count-Wiederholung. Worker-Cron-Muster vorhanden (s.o.), aber die konkrete Reminder-Logik + on_expiry-Lookahead auf valid_until ist neu.
I. SHK-Default-Seeding (neu)
Block H/LP-3: Default Request-Templates (Spesen/Hardware/Schulung/Zeugnis/Sonstiges), Default-Reminder, Default-Announcements. Seeding-Infra vorhanden (packages/db/src/seed), HR-Inhalte neu.
J. HR-spezifische UI-Surfaces (neu, in packages/ui-hivegrid)
Announcement-Feed + Detail (Reaction-Picker, Read-Receipt-Tabelle), Leave-Übersicht (Tabs + Kalendersicht), Password-Safe Reveal-UI (Copy-mit-Auto-Clear-30s), Survey-Editor + Auswertung, MA-Verzeichnis (Karten/Liste + Click-to-Call/Mail/Chat), Bulk-Upload-Match-Vorschau, Hub-Startseite mit Widgets. Primitives vorhanden (Tabelle/Tabs/Chart/Calendar/Dialog), HR-Komposition neu. Subframe-Adapter-Layer ist Boilerplate-seitig leer (@toolctrl/ui-subframe = Stub) — HiveGrid muss diese Grenze selbst füllen (MEMORY: Subframe für alle Routes Pflicht).
K. Permission-IDs hr.* (neu registrieren)
Alle 18 atomaren Permissions + 5 Bundles (Block O) als TypeScript-Konst in packages/entitlements/src/permissions.ts (INTEGRATION-CONTRACTS §8) + Default-Rollen-Zuweisung (SHK-Template).
L. @hivegrid/activity logActivity (HiveGrid-Querschnitt, kein BP-1:1)
INTEGRATION-CONTRACTS §5 verlangt logActivity aus @hivegrid/activity (M045) — das ist ein HiveGrid-eigenes Paket, nicht die Boilerplate-Foundation. Block M Activity-Typen hr.* dort registrieren.
Empfohlenes Vorgehen (Reihenfolge)
Phase 1 — Fundament aus BP einklinken (vor jedem Feature):
- HR-Permission-IDs + Bundles in
packages/entitlements/src/permissions.tsregistrieren (Block O). Voraussetzung für jede Route. - Datenmodelle in
prisma/schema/app.prisma(oder neuehr.prisma) anlegen — gestaffelt pro Milestone, nicht alle 21 auf einmal. M133 zuerst:HrEmployeeProfile,HrLocation. Jeweils sofortUSER_FK_MAPergänzen (CI-Gate). - DB-Repositories über
@toolctrl/db/client.server+runDbTransaction; Side-Effects ausschließlich viapublishOutboxEvent(INTEGRATION-CONTRACTS §6/Outbox). - Sidebar-Eintrag in
packages/ui-hivegrid/src/app-shell/sidebar.config.ts+ Routes unterapp.$tenant/hr/*undadmin/hr/*(Block B), gegated viawithTenantScope+withPermission(404-statt-403).
Phase 2 — Stammdaten/Verzeichnis/Dokumente (M133, M134):
5. HrEmployeeProfile/HrLocation + Verzeichnis-UI (Click-to-Call M12/Mail/Chat M13). i18n-Keys hr.*.
6. HrEmployeeDocument + Upload über @toolctrl/storage (putObject+signed-download) auf FileObject; tenant-isolierte Key-Konvention. Visibility-Gating + Audit auf sensible Reads (withAuditMiddleware).
Phase 3 — Leave + Payslips (M135, M136, M139-Teil):
7. Form-Templates Urlaub/Krank über @toolctrl/form-widget + FormSubmission; neue Form-Actions create_hr_vacation_request/create_hr_sick_leave.
8. Neu bauen: Approval-Workflow-Engine, working_days_count+DE-Feiertage, Calendar-Event-Hook (sobald M25 da).
9. Payslip-Bulk-Upload: @toolctrl/imports Dry-Run/Dedupe als Vorlage + HR-Dateiname-Pattern-Match; ImportJob-Tracking; Lohn-Export-CSV via @toolctrl/exports/csv.
Phase 4 — Kommunikation + Password-Safe (M137):
10. Announcements (Feed/Detail/Reactions/Comments) — RowComment/RowCommentReaction-Muster adaptieren; Read-Receipts neu. Push via notify().
11. Password-Safe: KMS/DEK-Layer komplett neu (Scaleway-KMS + per-Eintrag-DEK über AES-256-GCM-Primitive aus CryptoApi.ts); Reveal-Endpoint mit Audit + Idempotenz; Copy-Auto-Clear-UI. Quick-Links/Resources (Audience-Gating).
Phase 5 — Reminder-Engine + Surveys + Onboarding-Drittanbieter (M138, M139, M140):
12. Reminder-Cron als neuer Worker-Job nach Muster dsgvo-grace-cron.ts/audit-retention.ts.
13. Surveys (Items als Form-Renderer-Wiederverwendung) + Auswertung (chart.tsx) + CSV-Export.
14. M138 Drittanbieter-Onboarding via App/AppSyncRun/AppSyncItem (Apps-Engine).
15. Hub-Startseite (M140) — aggregiert vorhandene Widgets; DSGVO-Export via dsgvo-export.ts (USER_FK_MAP muss vollständig sein).
16. AV #7 Feature-Flag-Hülle + SHK-Default-Seeding.
Querschnitt durchgängig (DoD/INTEGRATION-CONTRACTS): Loader-baut-VM (@toolctrl/view-models), keine Prisma-Imports in packages/ui-hivegrid/**, i18n-Keys (hr.json), logActivity (M045) + auto-Audit (M001), Smoke-Test + Hot-Swap-Drill + Visual-Snapshot.
Anti-Erfindungs-Hinweise (faktische Grenzen)
- Es gibt KEIN HR-Datenmodell und KEIN HR-Modul in der Boilerplate. Verifiziert per Grep gegen
prisma/schema/*.prismaundapps/web/app/**. - CryptoApi nutzt EINEN Env-Key, KEIN KMS/DEK. Die Per-Tenant-KMS-Architektur der Spec ist neu.
- Kein Calendar-/CalendarEvent-Modell.
Eventincore.prismaist ein Webhook-/Domain-Event, kein Kalendereintrag. @toolctrl/ui-subframeist ein leerer Stub — kein gebauter Subframe-Adapter-Layer.- Keine generische Human-Approval-Workflow-Engine (nur node-basierte
workflows.prisma-Automation). packages/ui-hivegrid,@hivegrid/activity,packages/entitlements/src/permissions.ts(HiveGrid-Variante) sind HiveGrid-Repo-Konventionen aus INTEGRATION-CONTRACTS — in der Boilerplate so nicht vorhanden (Boilerplate hat@toolctrl/*).