Files

44 lines
3.0 KiB
Markdown

# Designer-Brief · P34 — HR-Drittanbieter-Onboarding (Memberspot/Boobora)
**Phase:** 34/34 · **Modul:** M138 · **Owner-Dev:** Akeshan (VA-P34) · **Designer:** David (D-HR-Drittanbieter)
**Aktive Quellen:** zugehörige Ticket-Docs · `ROADMAP.md`/`ROADMAP-V2.md` · `REQUIREMENTS.md` · `ENTITY-MODEL.md`.
**Subframe:** Pflicht je Route. Onboarding-Checklisten + Drittanbieter-Setup.
> 🔴 **Block 2, Spec offen (⚠ Vorlauf VEXT-3):** Memberspot/Boobora kommen in **keiner Spec** vor — M14 nennt nur generisch „HR-Onboarding + externe Systeme via Apps-Engine". Anbindung erfolgt über die **Apps-Engine (M33a)** mit demselben Adapter-Mechanismus wie KWP (gleiche „Partner-API-Vertrag offen"-Abhängigkeit). **Vor Bau:** eigene Drittanbieter-Spec (API-Vertrag) erheben. Agil vorziehbar, sobald spezifiziert. In ROADMAP-V2 ist M138 Teil der Phase v2-P10 (Komfort & Querschnitt) — hier als eigene Phase P34 ausgeführt; **nur der HR-Drittanbieter-Teil**, nicht Dashboard/Notifications/i18n (die liegen in P30).
## Was dieses Modul tut (Kurzfassung)
Standardisiert das Onboarding neuer Mitarbeitender und dockt externe HR-Onboarding-/Lohn-Drittanbieter an. Pro neuem MA wird eine Onboarding-Checkliste erzeugt (verlinkte Forms/Tasks/Reminders). Drittanbieter wie Memberspot oder Boobora werden als `DataConnection` über die Apps-Engine angebunden — identischer Adapter-Mechanismus wie bei KWP, nur eine andere Gegenstelle.
## Benötigte Screens
| Screen [Route] | Kern-Inhalt | Archetyp |
|---|---|---|
| HR-Onboarding-Checklisten [`/hr/onboarding`] | Liste laufender Onboardings pro MA, Fortschritt, verlinkte Forms/Tasks/Reminders | A2 |
| Onboarding-Detail [`/hr/onboarding/:id`] | Checklisten-Schritte je MA, Status, zugeordnete Forms/Tasks, Reminder-Status | A3 |
| Drittanbieter-Setup [`/hr/integrations`] | Verbindung zu Memberspot/Boobora/Lohn-Anbieter (DataConnection via Apps-Engine), Credentials, Status | A6 + Connect |
## Geplante Features (muss abgedeckt sein)
- [ ] 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 (Memberspot/Boobora-API-Vertrag) vor Bau erheben
## Benötigte UI-Elemente (Liste, KEIN Layout — Anordnung = Davids freie Hand)
Onboarding-Liste (pro MA, mit Fortschritts-Indikator), Checklisten-Schritt-Ansicht (Status je Schritt), Verknüpfungen zu Forms/Tasks/Reminders, Reminder-Status-Anzeige, Drittanbieter-Connect-Karte (Memberspot/Boobora/Lohn), Credential-/OAuth-Eingabe (maskiert), Verbindungs-Status-Anzeige (Ampel), Empty-/Loading-/Permission-Denied-States (Klartext).
## Davids Delta (David füllt aus)
- [ ] Überschriebene/geänderte Spec-Punkte:
- [ ] Neue UI/UX-Entscheidungen:
- [ ] Subframe-Screen-Link(s):
- [ ] Offene Fragen an Dev:
## Dev-Nachzug (wir nach Davids Delta)
- [ ] Spec/ENTITY-MODEL an Davids Entscheidungen angepasst:
- [ ] REQUIREMENTS/ROADMAP nachgezogen:
- [ ] Plane-Ticket (VA-P34) aktualisiert: