Files
HiveGrid-Wireframes/03 Quellen und Referenzen/hivegrid-cloud/.planning/ticket-docs/VD-P24.md
T

81 lines
4.7 KiB
Markdown

# 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: