Files
HiveGrid-Wireframes/03 Quellen und Referenzen/hivegrid-cloud/.planning/ticket-docs/VA-P34.md
T

4.1 KiB

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