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-10vorgezogen. 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-02bisBILL-07plusBILL-09/BILL-10(Plans/Seats-Domain, Lago-Gateway, Mollie-Gateway, Sync/Entitlements, Admin-Basis, Sandbox-E2E, Kunden-Rechnungszugriff, Self-Service-Checkout-Basis) - Blocks:
VA-P24bnur fuer gemeinsame Onboarding-/Plan-Kontexte, nicht fuer den Wizard-Kern - Läuft parallel zu:
VA-P23im 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-02bisBILL-05und Rechnungsanzeige ausBILL-09, keine neue Legacy-Provider-Domain. - Funktionale Self-Service-Checkout-Basis aus
BILL-10. BillingGateway/LagoBillingGatewayfuer Plans, Seats, Subscriptions, Invoices.PaymentGateway/MolliePaymentGatewayfuer 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-27BILL-README.md,BILL-02bisBILL-07,BILL-09ROADMAP-V2.md→ v2-P3 Self-Service-BillingENTITY-MODEL.md→ Domäne 12, nach AD-27 zu recuttendesigner-briefs/P24-self-service-billing-wizard.mdmuss 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-P24aaktualisiert