63 lines
5.6 KiB
Markdown
63 lines
5.6 KiB
Markdown
# 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
|