Files
HiveGrid-Wireframes/03 Quellen und Referenzen/hivegrid-cloud/.planning/ticket-docs/VD-P24.md
T
2026-07-08 16:15:37 +02:00

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-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
  • Bedient (Dev): VA-P24a (Self-Service-Abo-Baukasten-UI) und VA-P24b (Onboarding-Wizard-UI)
  • 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 ueber einen Web-Flow, zahlen ueber Mollie und sehen Return-/Payment-/Invoice-Status. Lago bleibt Billing-Engine, HiveGrid zeigt Entitlements.
  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.
  • 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
  • BILL-README.md, BILL-02 bis BILL-07
  • 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: