4.1 KiB
VD-P24 · Screens P24 — Abo-Baukasten-UI + Onboarding-Wizard
⚠️ Billing-Recut 2026-07-04 (AD-27): Self-Service-Billing-Screens muessen auf Lago + Mollie + HiveGrid-Entitlements neu geschnitten werden. Payment-Checkout-/Customer-Portal-Flächen werden nicht wiederverwendet.
⚠️ KI→MCP-Pivot (AD-26): Der KI-Coach-Slot entfällt. Wizard- und Billing-Flächen bleiben, aber ohne KI-Credits-/LLM-Gateway-Bezug.
| 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 · fällig 2026-07-20 |
| Status | geplant / nach Billing-Recut neu bewerten |
♻️ Löst Sammel-Ticket auf: Dieses Phasen-Ticket ersetzt zusammen mit
VD-P23das alte Sammel-TicketVD-1.
Abhängigkeiten & Parallelität
- Blocked by: D0-Baseline (
D-D0a,D-D0b) und fuer Self-Service-BillingBILL-02bisBILL-07 - Bedient (Dev):
VA-P24a(Self-Service-Abo-Baukasten-UI) undVA-P24b(Onboarding-Wizard-UI) - Läuft parallel zu:
VD-P22,VD-P23, sofern Billing-Screens nicht vorBILL-*finalisiert werden - Subframe: Pflicht je Route (A2, A3, A5, A6 + Vollbild-Flow fuer den Wizard)
Was wir bauen
Zwei Flächen:
- Self-Service-Billing: Tenants sehen Plan/Seats, starten Plan-/Seat-Aenderungen ueber einen Web-Flow, zahlen ueber Mollie und sehen Return-/Payment-/Invoice-Status. Lago bleibt Billing-Engine, HiveGrid zeigt Entitlements.
- Onboarding-Wizard: resumebarer, branchen-getriebener 10-Step-Vollbild-Flow, der das SHK-Branchen-Template deklarativ seedet, plus Erste-Schritte-Checkliste und Demo-Daten-Bulk-Löschung.
Benötigte Screens
| Screen [Route] | Kern-Inhalt | Archetyp |
|---|---|---|
Onboarding-Wizard [/onboarding/setup/step/:n] |
10-Step-Vollbild-Flow, Step-Validierung, Rückwärts-Block nach irreversiblen Actions, resumebar | Vollbild-Flow |
Erste-Schritte-Checkliste [/onboarding/checklist] |
Checklisten-Widget + Detail-Sicht mit Deep-Links zu Aufgaben | A2/Widget |
Demo-Daten-Verwaltung [/admin/onboarding/demo-data] |
Übersicht geseedete Demo-Daten + Bulk-Löschung | A6 |
Self-Service-Plan-/Seat-Wechsel [/admin/subscription] |
Aktueller Plan, Seats, verfügbare Pläne, Preis-Vorschau, Mollie-Zahlungsstart, Return-/Payment-Status | A6 + Web-Flow |
Billing-Status [/admin/billing] |
Lago-Invoices, Mollie-Payments, Fehlzahlung/Expired/Refund-Klartext | A6 |
Features (muss abgedeckt sein)
- Plan-/Seat-Wechsel ueber Lago/Mollie-Web-Flow, nicht Legacy-Provider.
- Zahlungspflicht/Payment-Status klar sichtbar, inklusive Return- und Fehlerzustand.
- Keine Usage-/AI-Credits-/Add-on-Metering-Fläche.
- Onboarding-Wizard resumebar nach Signup, Step-Validierung, Block der Rückwärts-Navigation nach irreversiblen Actions.
- SHK-Branchen-Template aus YAML geseedet; weitere Branchen „coming soon".
- Erste-Schritte-Checkliste mit Detection-Rules + Demo-Daten-Bulk-Löschung.
- Wiederverwendung aus v1 nur fuer Entitlements, Read-only/Frozen-State, TenantUserInvitation und Onboarding-Grundlagen.
UI-Elemente (Liste, KEIN Layout — Anordnung = Davids freie Hand)
Step-Progress-Indikator; Step-Inhalts-Container mit Validierungs-Feedback; „Zurück gesperrt"-Hinweis; Branchen- Auswahl-Karten; Plan-Vergleichs-Karten/Tabelle; Seat-Stepper; Preis-Vorschau; Mollie-Zahlungsstart-Button; Return-/ Payment-Status; Billing-Status-Badges; Usage-/Quota-Auslastung nur fuer nicht abrechenbare Limits; Erste-Schritte- Checklisten-Widget; Demo-Daten-Lösch-Bestätigung; Resume-Banner; Empty-/Loading-/Permission-Denied-States.
Quellen (granular)
docs/ARCHITECTURE-DECISIONS.md→AD-27,AD-26BILL-README.md,BILL-02bisBILL-07designer-briefs/P24-self-service-billing-wizard.mdmuss nach AD-27 aktualisiert werdenROADMAP-V2.md§v2-P3 ·ENTITY-MODEL.mdDomäne 12/13 nach AD-27 recutten
Davids Delta (David füllt aus)
- Überschriebene/geänderte Spec-Punkte:
- Neue UI/UX-Entscheidungen:
- Subframe-Screen-Link(s):
- Offene Fragen an Dev: