5.1 KiB
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 | geplant |
Abhängigkeiten & Parallelität
- Blocked by:
VA-P24a(Self-Service-Abo-Baukasten + Branchen-Template-Mechanismus),→ entfällt (AD-26: KI-Coach gestrichen, VR-P25 zurückgestellt)VR-P25(KI-Coach — der Walkthrough-Coach wird retro eingehängt, kein harter Forward-Dep) - 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. Erweitertprisma/schema/onboarding.prisma(additiv, AD-21). - Konflikt-Risiko: gering — additiver Wizard auf v1-Auto-Provisionierung; Branchen-Template-Seeding ist geteilter Mechanismus (P24/P26/P30).
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→ entfällt (AD-26)VR-P25rückwirkend befüllt)- Wiederverwendung v1: Auto-SHK-Provisionierung (Seeds),
TenantUserInvitation, Form-Builder - Konnektor
tenantHasModule('onboarding'); RLS aufOnboardingSession
Technische Bausteine
- Entities (eigene
prisma/schema/onboarding.prisma, AD-21):Onboarding(codeshk_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 viais_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 ·PHASE-SOURCES.md→ Phase 24 (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)_bmad-output/specs/M29-onboarding.md(Wizard)- 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/PHASE-SOURCES nachgezogen
- Plane-Ticket
VA-P24baktualisiert