81 lines
4.7 KiB
Markdown
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:
|