56 lines
5.4 KiB
Markdown
56 lines
5.4 KiB
Markdown
# VD-P24 · Screens P24 — Abo-Baukasten-UI + Onboarding-Wizard
|
||
|
||
> ⚠️ **KI→MCP-Pivot ([[AD-26]]):** Der **KI-Coach-Slot entfällt** (war weiche Kopplung an das zurückgestellte VR-P25/VD-P25; v2-P4 ist jetzt der MCP-Server, [[VR-MCP]]/[[VD-MCP]]). Wizard- und Billing-Flächen bleiben unverändert; KI-Coach-Stellen unten durchgestrichen.
|
||
|
||
| | |
|
||
|---|---|
|
||
| **Typ** | Screen (Design) |
|
||
| **Owner** | David |
|
||
| **Phase** | P24 — Self-Service-Billing & Onboarding-Wizard (v2-P3) · bedient `VA-P24a`/`VA-P24b` |
|
||
| **Cycle/Fenster** | v2-W1 — Public-API/Postfach/Abo/KI-Start · Abo-UI 13.–17., Wizard 18.–20.07. → fällig 2026-07-20 |
|
||
| **Status** | geplant (NEU — Phasen-Ticket) |
|
||
|
||
> ♻️ **Löst Sammel-Ticket auf:** Dieses Phasen-Ticket ersetzt — zusammen mit `VD-P23` — das alte Sammel-Ticket **`VD-1`** („Abo-Baukasten-UI + Wizard + Postfach-Inbox"). VD-P24 = der Abo-Baukasten-/Onboarding-Wizard-Anteil.
|
||
|
||
## Abhängigkeiten & Parallelität
|
||
- **Blocked by:** D0-Baseline (`D-D0a` App-Shell, `D-D0b` Archetypen A2/A3/A5/A6 + Vollbild-Flow) — Wizard und Plan-Wechsel komponieren aus den D0-Archetypen; Stripe-Checkout-Flächen aus v1 wiederverwenden
|
||
- **Bedient (Dev):** `VA-P24a` (Self-Service-Abo-Baukasten-UI, M28-Delta, 13.–15.07.), `VA-P24b` (Onboarding-Wizard-UI, M157, 18.–20.07.)
|
||
- **Läuft parallel zu:** `VD-P22`, `VD-P23` — gleiche v2-W1
|
||
- **Subframe:** Pflicht je Route (A2, A3, A5, A6 + Vollbild-Flow für den Wizard)
|
||
|
||
## Was wir bauen
|
||
Zwei Flächen: (1) **Self-Service-Billing** — Tenants buchen/wechseln Pläne über **Web-Checkout** (v1-Stripe wiederverwenden), kaufen Add-Ons, sehen Usage/Quota. **PWA-only (AD-17)** → keine App-Store-Billing-Auflage, Plan-Wechsel direkt im Web. (2) **Onboarding-Wizard** — resumebarer, branchen-getriebener 10-Step-Vollbild-Flow (State-Machine), der das SHK-Branchen-Template deklarativ aus YAML seedet, plus Erste-Schritte-Checkliste (Detection-Rules) und Demo-Daten-Bulk-Löschung. ~~KI-Coach-Andockpunkt (von P25 rückwirkend befüllt).~~ → **KI-Coach entfällt ([[AD-26]]).**
|
||
|
||
## Benötigte Screens
|
||
| Screen [Route] | Kern-Inhalt | Archetyp |
|
||
|---|---|---|
|
||
| Onboarding-Wizard [`/onboarding/setup/step/:n`] | 10-Step-Vollbild-Flow (Branchen-Wahl, Pipelines/Rollen/Felder, Forms, Demo-Daten, Team-Einladung etc.); Step-Validierung; Rückwärts-Block nach irreversiblen Actions; resumebar | Vollbild-Flow |
|
||
| Erste-Schritte-Checkliste [`/onboarding/checklist`] | Checklisten-Widget (Detection-Rules: erledigt/offen) + Detail-Sicht mit Deep-Links zu den Aufgaben | A2/Widget |
|
||
| Demo-Daten-Verwaltung [`/admin/onboarding/demo-data`] | Übersicht geseedete Demo-Daten + Bulk-Löschung (Bestätigung) | A6 |
|
||
| Self-Service-Plan-Wechsel [`/admin/subscription`] | Aktueller Plan, verfügbare Pläne (Web-Checkout), Plan-Wechsel/Upgrade/Downgrade, Zahlungsmethoden-Pflicht, Checkout-Return | A6 + Web-Checkout |
|
||
| Add-On-Kauf-Flächen [`/admin/subscription` · `/admin/usage`] | Add-On-Katalog (~~AI-Credits~~ (entfällt [[AD-26]]), Seats), Kauf via Web-Checkout, Usage-/Quota-Anzeige | A6 |
|
||
|
||
## Features (muss abgedeckt sein)
|
||
- [ ] Self-Service-Trial ohne Vertriebs-Freigabe (`requires_manual_activation=false`) mit Zahlungsmethoden-Pflicht
|
||
- [ ] Plan-Wechsel + Add-On-Käufe über Web-Checkout (PWA-only → kein App-Store, keine Store-Billing-Auflage)
|
||
- [ ] Onboarding-Wizard resumebar nach Signup, Step-Validierung, Block der Rückwärts-Navigation nach irreversiblen Actions
|
||
- [ ] SHK-Branchen-Template (Pipelines/Rollen/Custom-Felder/Forms/Demo/Checkliste) deklarativ aus YAML geseedet; weitere Branchen „coming soon"
|
||
- [ ] Erste-Schritte-Checkliste mit Detection-Rules + Demo-Daten-Bulk-Löschung
|
||
- [ ] ~~KI-Walkthrough-Coach-Andockpunkt (Slot — von P25 rückwirkend eingehängt, kein harter Forward-Dep)~~ → **entfällt ([[AD-26]])**
|
||
- [ ] Wiederverwendung v1: Stripe-Checkout + Webhook-Handler, SubscriptionFeature/ProductFeature (Feature-Gate), Read-Only-Middleware, TenantUserInvitation
|
||
|
||
## UI-Elemente (Liste, KEIN Layout — Anordnung = Davids freie Hand)
|
||
Step-Progress-Indikator (10 Steps, Vollbild); Step-Inhalts-Container mit Validierungs-Feedback; „Zurück gesperrt"-Hinweis nach irreversiblen Actions; Branchen-Auswahl-Karten (SHK aktiv, andere „coming soon"-disabled); Plan-Vergleichs-Karten/Tabelle (Features pro Plan, aktueller Plan markiert); Web-Checkout-Trigger-Button + Checkout-Return-Status; Zahlungsmethoden-Pflicht-Hinweis; Add-On-Katalog-Karten mit Preis + Kauf-Button; Usage-/Quota-Auslastungs-Anzeige (Balken); Erste-Schritte-Checklisten-Widget (abhakbare Items mit Deep-Link); Demo-Daten-Lösch-Bestätigung (mit Folgen-Hinweis); Resume-Banner („Onboarding fortsetzen"); ~~KI-Coach-Slot/Platzhalter (von P25 befüllt)~~ (entfällt [[AD-26]]); Empty-/Loading-/Permission-Denied-States (Klartext).
|
||
|
||
## Quellen (granular)
|
||
- `designer-briefs/P24-self-service-billing-wizard.md` (vollständiger Brief — diese Doc ist sein Ticket-Destillat)
|
||
- `ENTITY-MODEL.md` → **Domäne 12: Billing & Abo-Baukasten (M28, Recut-Modell)** + **Domäne 13: Onboarding (M29)**
|
||
- `ROADMAP-V2.md` §v2-P3 (Screens/Features = Hauptquelle) · `ROADMAP.md` §Phase 24 · `_bmad-output/specs/M28-subscriptions-billing.md` (Block P) · `_bmad-output/specs/M29-onboarding.md`
|
||
- Plane-Snapshot: ersetzt Teil von `VD-1`; bedient `VA-P24a`/`VA-P24b` (v2-W1, 13.–20.07.)
|
||
|
||
## Davids Delta (David füllt aus)
|
||
- [ ] Überschriebene/geänderte Spec-Punkte:
|
||
- [ ] Neue UI/UX-Entscheidungen:
|
||
- [ ] Subframe-Screen-Link(s):
|
||
- [ ] Offene Fragen an Dev:
|