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

4.2 KiB

VA-P24a · P24 Self-Service-Abo-Baukasten-UI (M28-Delta)

⚠️ Billing-Recut 2026-07-04 (AD-27): Self-Service-Billing baut auf Lago + Mollie + HiveGrid-Entitlements auf. Payment-Checkout, Legacy-Provider-Webhooks und Legacy-Provider-Customer-Portal werden nicht wiederverwendet. v1 bleibt Plans + Seats; die funktionale Self-Service-Checkout-Basis wurde am 2026-07-05 in BILL-10 vorgezogen. Dieses Ticket bleibt fuer finale Screens, Preisvorschau-UX und Produkt-/Wizard-Delta.

⚠️ KI→MCP-Pivot (AD-26): Das „AI-Credits"-Add-On entfällt. Kein LLM-Gateway/AiCredits in v1.

Typ Dev (Code)
Owner Akeshan
Phase P24 — Self-Service-Billing & Onboarding-Wizard · v2-P3
Cycle/Fenster v2-W1 — Public-API/Postfach/Abo/KI-Start · fällig 2026-07-15
Status geplant / nach Billing-Recut neu bewerten

Abhängigkeiten & Parallelität

  • Blocked by: BILL-02 bis BILL-07 plus BILL-09/BILL-10 (Plans/Seats-Domain, Lago-Gateway, Mollie-Gateway, Sync/Entitlements, Admin-Basis, Sandbox-E2E, Kunden-Rechnungszugriff, Self-Service-Checkout-Basis)
  • Blocks: VA-P24b nur fuer gemeinsame Onboarding-/Plan-Kontexte, nicht fuer den Wizard-Kern
  • Läuft parallel zu: VA-P23 im selben v2-Fenster, sofern Billing-Interfaces stabil sind
  • Konflikt-Risiko: mittel — Self-Service berührt Billing-State, Payment-Callbacks und Entitlements; keine Legacy-Provider-Altpfade erweitern

Was wir bauen

Das Self-Service-Delta auf dem v1-Billing: Die Basis fuer Plan-/Seat-Auswahl, Mollie-Zahlungsstart und Return/Webhook-Sync existiert in BILL-10. Dieses Ticket klaert/ergaenzt darauf aufbauend finale Screens, Preisvorschau-UX, Wizard-/Onboarding-Kontext und noch fehlende Produktentscheidungen. Lago bleibt Billing-Source-of-Truth fuer Subscription und Invoice, HiveGrid bleibt Entitlement-Source fuer Feature-Gates.

Nicht im Scope dieses Recut-Standes:

  • Usage-Billing
  • Credits
  • Add-on-Metering
  • Legacy-Provider-Kompatibilitaet
  • finale Rechnungssteller-/Steuerfreigabe

Benötigte Screens (Backend bedient — Design liefert D-P24)

Screen [Route] Kern-Inhalt
Self-Service-Plan-Wechsel [/admin/subscription] Aktueller Plan, Seats, verfügbare Pläne, Preis-Vorschau, Mollie-Zahlungsstart, Checkout-Return-/Payment-Status
Seat-Verwaltung [/admin/subscription] Seat-Anzahl erhöhen/reduzieren, sofortige Vorschau, serverseitige Validierung, Audit/Reason bei Sonderfällen
Billing-Status [/admin/billing] Lago-Invoice-Status, Mollie-Payment-Status, Fehlzahlung/Expired/Refund-Klartext

Definition of Done

  • Self-Service-Trial ohne Vertriebs-Freigabe ist fachlich entschieden und serverseitig modelliert.
  • Basis-Plan-Wechsel und Seat-Auswahl nutzen Lago-Subscription-State, nicht Legacy-Provider-Checkout. (BILL-10)
  • Zahlung wird ueber Mollie erzeugt und nach Return/Webhook idempotent verarbeitet. (BILL-10)
  • Preis-Vorschau ist serverseitig validiert und nutzt keine oeffentlich hartkodierten Preisversprechen.
  • tenantHasModule()/Entitlements reagieren auf den lokalen Billing-State.
  • RLS/Tenant-Scope auf allen Tenant-Tabellen, globale Produkt-/Preisdefinitionen bewusst getrennt.

Technische Bausteine

  • Delta auf BILL-02 bis BILL-05 und Rechnungsanzeige aus BILL-09, keine neue Legacy-Provider-Domain.
  • Funktionale Self-Service-Checkout-Basis aus BILL-10.
  • BillingGateway/LagoBillingGateway fuer Plans, Seats, Subscriptions, Invoices.
  • PaymentGateway/MolliePaymentGateway fuer Zahlungsstart und Payment-Status.
  • Checkout-Return-Handler aktualisiert lokalen Billing-State nur ueber idempotente Sync-Events.
  • PWA-only: reiner Web-Flow, kein App-Store-Billing.

Quellen (granular)

  • docs/ARCHITECTURE-DECISIONS.md → AD-27
  • BILL-README.md, BILL-02 bis BILL-07, BILL-09
  • ROADMAP-V2.md → v2-P3 Self-Service-Billing
  • ENTITY-MODEL.md → Domäne 12, nach AD-27 zu recutten
  • designer-briefs/P24-self-service-billing-wizard.md muss nach AD-27 aktualisiert werden

Dev-Nachzug (nach Davids D-P24-Delta)

  • Spec/ENTITY-MODEL an Davids UI-Entscheidungen angepasst
  • REQUIREMENTS/PHASE-SOURCES nachgezogen
  • Plane-Ticket VA-P24a aktualisiert