# 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`; generische Checkout-Zustände auch für `VA-P26c` | | **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-P23` das alte Sammel-Ticket `VD-1`. ## Abhängigkeiten & Parallelität - **Blocked by:** D0-Baseline (`D-D0a`, `D-D0b`) und fuer Self-Service-Billing `BILL-02` bis `BILL-07` sowie der stabile Pricing-/Namensvertrag aus `BILL-11` / `BILL-12` - **Bedient (Dev):** `VA-P24a` (Self-Service-Abo-Baukasten-UI), `VA-P24b` (Onboarding-Wizard-UI) und die generischen Add-on-/Einmalzahlungs-Zustände für `VA-P26c` - **Läuft parallel zu:** `VD-P22`, `VD-P23`, sofern Billing-Screens nicht vor `BILL-*` finalisiert werden - **Subframe:** Pflicht je Route (A2, A3, A5, A6 + Vollbild-Flow fuer den Wizard) ## Was wir bauen Zwei Flächen: 1. **Self-Service-Billing:** Tenants sehen Plan/Seats, starten Plan-/Seat-Aenderungen sowie pauschale Add-on-/Einmalpositions-Käufe ueber einen Web-Flow, zahlen ueber Mollie und sehen Return-/Payment-/Invoice-Status. Lago bleibt Billing-Engine, HiveGrid zeigt Entitlements. Usage-Metering bleibt ausgeschlossen. 2. **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; pauschale Monats-Add-ons und einmalige Einrichtungspositionen besitzen dagegen klare Checkout-/Payment-Zustände (AD-30). - [ ] 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-26` - `docs/ARCHITECTURE-DECISIONS.md` → `AD-30` · portalspezifische Domain-UI bleibt in `VD-P26` - `BILL-README.md`, `BILL-02` bis `BILL-07` - `BILL-11` / `BILL-12` fuer Core / Swarm / Colony bei stabilen technischen Codes - `designer-briefs/P24-self-service-billing-wizard.md` muss nach AD-27 aktualisiert werden - `ROADMAP-V2.md` §v2-P3 · `ENTITY-MODEL.md` Domä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: