5.4 KiB
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-TicketVD-1(„Abo-Baukasten-UI + Wizard + Postfach-Inbox"). VD-P24 = der Abo-Baukasten-/Onboarding-Wizard-Anteil.
Abhängigkeiten & Parallelität
- Blocked by: D0-Baseline (
D-D0aApp-Shell,D-D0bArchetypen 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 ( |
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; bedientVA-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: