Files
HiveGrid-Wireframes/hivegrid-cloud/.planning/ticket-docs/VD-P24.md
T

5.4 KiB
Raw Blame History

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: