# VA-P34 · P34 HR-Drittanbieter-Onboarding (Memberspot/Boobora, M138) | | | |---|---| | **Typ** | Dev (Code) | | **Owner** | Akeshan | | **Phase** | P34 — HR-Drittanbieter-Onboarding · v2-P10 (HR-Teil) | | **Cycle/Fenster** | Backlog/agil (Trigger) · Label `block-2` · Ziel 2026-07-31 | | **Status** | geplant | ## Abhängigkeiten & Parallelität - **Blocked by:** `R-P5` (Apps-Engine — DataConnection-Adapter-Mechanismus, gleich wie KWP), `AK-P17a` (HR-Hub — HrEmployeeProfile/Onboarding-Fundament), `VEXT-3` (⚠ **Vorlauf-Spec** Memberspot/Boobora-API-Vertrag — in **keiner** Spec vorhanden) - **Blocks:** — - **Läuft parallel zu:** Restliche W3-Tickets — disjunkte HR-Domäne. **`block-2`/Backlog:** agil vorziehbar, **sobald VEXT-3 die Spec geliefert hat**. - **Konflikt-Risiko:** gering — additiver Adapter über die Apps-Engine + HR-Onboarding-Checklisten auf HR-Hub. ## Was wir bauen Standardisiertes **Onboarding neuer Mitarbeitender** + Andockung externer HR-/Lohn-Drittanbieter (M138): pro neuem MA eine **Onboarding-Checkliste** (verlinkte Forms/Tasks/Reminders). Drittanbieter wie **Memberspot/Boobora/Lohn** werden als **`DataConnection` über die Apps-Engine** angebunden — **identischer Adapter-Mechanismus wie bei KWP** (M33a), nur eine andere Gegenstelle. **⚠ Block 2, Spec offen:** Vor Bau muss VEXT-3 den API-Vertrag erheben (gleiche „Partner-API-Vertrag offen"-Abhängigkeit wie KWP). ## Benötigte Screens (Backend bedient — Design liefert `D-P34`) | Screen [Route] | Kern-Inhalt | |---|---| | HR-Onboarding-Checklisten [`/hr/onboarding`] | Liste laufender Onboardings pro MA, Fortschritt, verlinkte Forms/Tasks/Reminders | | Onboarding-Detail [`/hr/onboarding/:id`] | Checklisten-Schritte je MA, Status, zugeordnete Forms/Tasks, Reminder-Status | | Drittanbieter-Setup [`/hr/integrations`] | Verbindung zu Memberspot/Boobora/Lohn (**DataConnection** via Apps-Engine), Credentials (maskiert), Status/Health | ## Definition of Done - [ ] **HR-Onboarding-Checklisten pro neuem MA** (verlinkte Forms/Tasks/Reminders) - [ ] **Drittanbieter** (Memberspot/Boobora/Lohn) als **`DataConnection`** über die Apps-Engine (**gleicher Adapter-Mechanismus wie KWP**) - [ ] **Verbindungs-Status/-Health** je Drittanbieter - [ ] ⚠ **Vorlauf-Spec VEXT-3** (Memberspot/Boobora-API-Vertrag) **vor Bau** erhoben - [ ] Konnektor `tenantHasModule('hr')`; **RLS** auf HR-Tabellen (HR-Domäne stark verschlüsselt) ## Technische Bausteine - **Entities:** Onboarding-Checklisten über v1-HR-Hub (`HrEmployeeProfile`, Forms/Tasks/Reminders via `EmployeeUploadReminder`/FormSubmission); Drittanbieter über `DataConnection` (tenant_id, app_id, **credentials verschlüsselt [DEK]**, connection_status, last_health_check) — **kein eigenes Drittanbieter-Modell**, identisch zum KWP-Pattern. `hr.prisma`/`apps.prisma` nur über FK (AD-21). - **Adapter über Apps-Engine (M33a/R-P5):** Memberspot/Boobora/Lohn als konkrete Adapter hinterm Apps-Engine-Interface (gleicher Mechanismus wie KWP); Credentials per-Tenant-DEK in `DataConnection.config`. **Sync-Richtung/Datenkategorien aus VEXT-3.** - **Connection-Health:** periodischer Health-Check je Drittanbieter (Ampel-Status). - **RLS** auf allen Tenant-HR-Tabellen; `is_demo_data` auf seedbaren Onboarding-Demos. - ⚠ **Spec-Gap:** Memberspot/Boobora in keiner Spec — Adapter-Vertrag erst nach **VEXT-3** finalisierbar (Auth/Sync-Richtung/Datenkategorien/Webhook). ## Quellen (granular) - `ROADMAP-V2.md` → **§v2-P10** (NUR HR-Drittanbieter-Teil, M138; Recut „Gap M138 — eigene Drittanbieter-Spec wie KWP") - `ENTITY-MODEL.md` → **Domäne 10: HR-Hub** (HrEmployeeProfile/EmployeeUploadReminder) + **`DataConnection`** (Apps-Engine, credentials verschlüsselt) - `ROADMAP.md` → Phase 34 · Milestones: (M138 HR-Onboarding-Drittanbieter) - `designer-briefs/P34-hr-drittanbieter-onboarding.md` (Block 2, Spec offen, Apps-Engine-Anbindung, Vorlauf VEXT-3) - Querverweis: `ticket-docs/VEXT-3.md` (Vorlauf-Spec, blockiert dieses Ticket), AK-P17a (HR-Hub-Fundament) ## Dev-Nachzug (nach Davids `D-P34`-Delta) - [ ] Spec/ENTITY-MODEL an Davids UI-Entscheidungen angepasst - [ ] REQUIREMENTS/ROADMAP nachgezogen - [ ] Plane-Ticket `VA-P34` aktualisiert