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

56 lines
5.4 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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: