# VA-P24b · P24 Onboarding-Wizard-UI (M157) > ⚠️ **KI→MCP-Pivot ([[AD-26]]):** Der **KI-Coach-Slot entfällt** (war weiche Kopplung an das zurückgestellte VR-P25; v2-P4 ist jetzt der MCP-Server, [[VR-MCP]] — kein eigenes LLM/Coach). Wizard-State-Machine + Branchen-Seeds + Checkliste bleiben unverändert. Alle KI-Coach-Stellen unten sind durchgestrichen. | | | |---|---| | **Typ** | Dev (Code) | | **Owner** | Akeshan | | **Phase** | P24 — Self-Service-Billing & Onboarding-Wizard · v2-P3 | | **Cycle/Fenster** | v2-W1 — Public-API/Postfach/Abo/KI-Start · fällig 2026-07-20 | | **Status** | Cancelled in Plane (Stand 2026-07-15) | ## Abhängigkeiten & Parallelität - **Blocked by:** `VA-P24a` (Self-Service-Abo-Baukasten + Branchen-Template-Mechanismus) ~~, alter VR-P25-Scope (KI-Coach — der Walkthrough-Coach wird retro eingehängt, **kein harter Forward-Dep**)~~ → **entfällt ([[AD-26]]: KI-Coach gestrichen, alter VR-P25-Scope zurückgestellt)** - **Blocks:** — - **Läuft parallel zu:** Raffaels ~~`VR-P25` (KI-Tiefe)~~ **`VR-MCP` (MCP-Server)** — ~~der KI-Coach-Andockpunkt ist nur ein Slot/Platzhalter, keine harte Kopplung.~~ → **KI-Coach-Slot entfällt ([[AD-26]]); keine Kopplung mehr.** Erweitert `prisma/schema/onboarding.prisma` (additiv, AD-21). - **Konflikt-Risiko:** gering — additiver Wizard auf v1-Auto-Provisionierung; Branchen-Template-Seeding ist **geteilter Mechanismus** (P24/P26/P30). **Dependency-Auswirkung 2026-07-15:** `VA-P24a` wurde von Raffael uebernommen. Da `VA-P24b` in Plane Cancelled ist, entstehen daraus aktuell keine aktiven Termin-, Scope- oder Contract-Auswirkungen fuer dieses Ticket. **Dependency-Auswirkung 2026-08-02:** `BILL-20` baut fuer den Piloten eine fokussierte Welcome-/Setup-Surface auf der vorhandenen AK-P20-Session. Der hier beschriebene 10-Schritt-Wizard, YAML-Branchen-Template, irreversible Step-Cursor und Demo-Orchestrierung werden dadurch weder vorgezogen noch reaktiviert. ## Was wir bauen Den **resumebaren, branchen-getriebenen Onboarding-Wizard** (State-Machine, M157): nach dem Signup führt ein 10-Step-Vollbild-Flow durch Branchen-Wahl, Pipelines/Rollen/Custom-Felder, Forms, Demo-Daten und Team-Einladung. Das **SHK-Branchen-Template** wird **deklarativ aus YAML** geseedet (weitere Branchen „coming soon"). Eine **Erste-Schritte-Checkliste** (Detection-Rules) führt weiter; Demo-Daten lassen sich gebündelt löschen. Das Wizard-Framework ist großteils v1-fähig — v2-Delta = weitere Branchen ~~+ KI-Coach-Andockpunkt~~ (KI-Coach entfällt — [[AD-26]]). ## Benötigte Screens (Backend bedient — Design liefert `D-P24`) | Screen [Route] | Kern-Inhalt | |---|---| | Onboarding-Wizard [`/onboarding/setup/step/:n`] | 10-Step-Vollbild-Flow (Branchen-Wahl, Pipelines/Rollen/Felder, Forms, Demo-Daten, Team-Einladung) · Step-Validierung · **Rückwärts-Block nach irreversiblen Actions** · resumebar | | Erste-Schritte-Checkliste [`/onboarding/checklist`] | Checklisten-Widget (Detection-Rules: erledigt/offen) + Detail mit Deep-Links zu den Aufgaben | | Demo-Daten-Verwaltung [`/admin/onboarding/demo-data`] | Übersicht geseedeter Demo-Daten + **Bulk-Löschung** (Bestätigung) | ## Definition of Done - [ ] Wizard **resumebar**, Step-Validierung, **Rückwärts-Block nach irreversiblen Actions** - [ ] **SHK-Branchen-Template deklarativ aus YAML geseedet** (Pipelines/Rollen/Custom-Felder/Forms/Demo/Checkliste); weitere Branchen „coming soon" - [ ] **Erste-Schritte-Checkliste** (Detection-Rules) + **Demo-Daten-Bulk-Löschung** - [ ] ~~KI-Walkthrough-Coach-Andockpunkt (Slot/Platzhalter, wird von `VR-P25` rückwirkend befüllt)~~ → **entfällt ([[AD-26]])** - [ ] Wiederverwendung v1: Auto-SHK-Provisionierung (Seeds), `TenantUserInvitation`, Form-Builder - [ ] Konnektor `tenantHasModule('onboarding')`; **RLS** auf `OnboardingSession` ## Technische Bausteine - **Entities** (eigene `prisma/schema/onboarding.prisma`, AD-21): `Onboarding` (code `shk_standard`, industry, template_directory — **global, ohne RLS**), `OnboardingSession` (onboarding_id, current_step, status, payload — **[RLS]**), `OnboardingDemoProvisioning` (template_code, entities_created JSON, removable_until +30d, `is_demo_data`-Flag in Listen), `OnboardingInvitationDispatch`. `core.prisma` (Tenant) nur über Relation. - **State-Machine:** resumebarer Step-Cursor in `OnboardingSession.current_step`; Rückwärts-Navigation nach irreversiblen Actions serverseitig blockiert. - **Branchen-Template aus YAML** (deklaratives `template_directory`, **geteilter Mechanismus** mit P24a/P26/P30): orchestriert die Self-Seeds aller Module (AD-12); Demo-Seed via `is_demo_data`. - **Erste-Schritte-Checkliste:** Detection-Rules werten Tenant-Zustand aus (erledigt/offen); Demo-Bulk-Löschung über `is_demo_data`-Flag. - ~~**KI-Coach-Slot:** Andockpunkt-Komponente ohne harte Dependency auf P25.~~ → **entfällt ([[AD-26]]).** ## Quellen (granular) - `ROADMAP-V2.md` → **§v2-P3** (Wizard-State-Machine, Branchen-Template, Checkliste = Hauptquelle) - `ENTITY-MODEL.md` → **Domäne 13: Onboarding** (Onboarding/OnboardingSession/OnboardingDemoProvisioning/OnboardingInvitationDispatch) - `ROADMAP.md` → Phase 24 · Milestones: (M157 Wizard-Framework + State-Machine) - `designer-briefs/P24-self-service-billing-wizard.md` (10-Step-Flow, Resume-Banner, ~~KI-Coach-Slot~~ → entfällt [[AD-26]]) - Querverweis: `ticket-docs/VA-P24a.md` (Branchen-Template-Mechanismus), `ticket-docs/AK-P20.md` (Auto-SHK-Provisionierung v1) ## Dev-Nachzug (nach Davids `D-P24`-Delta) - [ ] Spec/ENTITY-MODEL an Davids UI-Entscheidungen angepasst - [ ] REQUIREMENTS/ROADMAP nachgezogen - [ ] Plane-Ticket `VA-P24b` aktualisiert