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

5.6 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 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