3.6 KiB
3.6 KiB
BILL-10 · Self-Service-Checkout fuer Planwechsel
| Typ | Dev ohne finale Screens |
| Owner | Raffael |
| Phase | Billing-Recut nach AD-27 |
| Cycle/Fenster | vorgezogen aus VA-P24a |
| Status | Done |
Abhaengigkeiten & Parallelitaet
- Blocked by:
BILL-03,BILL-04,BILL-05,BILL-07,BILL-09 - Blocks: finale Self-Service-Billing-Screens (
VA-P24a/VD-P24) - Screen-Status: finale Designs offen; bestehende Tenant-Subscription-Settings werden als funktionale Basis genutzt.
Was wir bauen
Kunden koennen in /:tenant/settings/subscription einen oeffentlichen Plan und eine Seat-Anzahl auswaehlen.
HiveGrid erstellt serverseitig einen Lago-Customer, eine Lago-Subscription und eine Mollie-Zahlung. Mollie bleibt nur
Payment-Processor; Lago/HiveGrid bilden den lokalen Subscription-/Entitlement-State. Rueckkehr aus Mollie und Webhook
sind idempotent, damit der Tenant auch dann aktiviert wird, wenn der Browser nicht sauber zurueckkehrt.
Definition of Done
- Subscription-Settings zeigen oeffentliche Plaene und erlauben Plan-/Seat-Auswahl mit vorhandenen Plan-Karten.
- Checkout-Action validiert Tenant, Permission, CSRF, Produkt, Preis, Billing-Period, Currency und Quantity.
- Lago-Customer und Lago-Subscription werden vor der Zahlung erzeugt.
- Mollie-Zahlung enthaelt nur Billing-Minimum plus technische Checkout-Metadaten fuer Tenant, Invoice, Plan und Seats.
- CheckoutSessionStatus speichert Provider-Payment-ID, Lago-Subscription-ID, Plan-Code, Preis, Menge und Status.
- Mollie-Webhook aktiviert bei bezahlten Self-Service-Zahlungen den lokalen Lago-/HiveGrid-Billing-State.
- Checkout-Success-Route prueft die Zahlung erneut und kann den Sync nachziehen, falls der Webhook noch nicht lief.
- Tests fuer Billing-Metadaten, Webhook, DB-Checkout-Status, Subscription-Route und Success-Route.
Umsetzungs-Notiz
2026-07-05 · Raffael
- Neuer Service
apps/web/app/services/billing/self-service-checkout.server.tskapselt den Checkout:LagoBillingGatewayfuer Customer/Subscription,MolliePaymentGatewayfuer Checkout-Link, lokaleCheckoutSessionStatus-Persistenz. /:tenant/settings/subscriptionrendert wieder Plan-Karten (PlansGrouped) und leitet nachaction=subscribeauf Mollie weiter.POST /v1/billing/mollie/webhooksspiegelt bezahlte Checkout-Metadaten zusaetzlich ueberapplyLagoSubscriptionSync, nicht nur ueberapplyMolliePaymentSync.subscribe.$tenant.$session.successnutzt den neuen Self-Service-Checkout-Status und zieht den idempotenten Sync bei Rueckkehr aus Mollie nach.- Prisma-Migration
20260705123000_billing_self_service_checkouterweitertCheckoutSessionStatus.
Proof:
pnpm --dir apps/web typecheckpnpm --filter @hivegrid/api typecheckpnpm --filter @hivegrid/billing typecheckpnpm --filter @hivegrid/api exec vitest run src/billing/mollie-webhook-route.test.ts src/app.test.tspnpm --filter @hivegrid/db exec vitest run src/subscriptions.server.test.ts src/billing-sync.server.test.tspnpm --dir apps/web exec vitest run app/routes/app.\\$tenant/settings/subscription.test.tsx app/routes/subscribe.\\$tenant.\\$session.success.test.tsxpnpm --filter @hivegrid/billing test -- --run src/mollie.test.ts src/sync-outbox.test.ts
BILL-10: 8/8 DoD = 100 % done.
Nicht im Scope
- Finale Subframe-Screens fuer Billing.
- Vollautomatischer Staging-E2E gegen echte Lago-/Mollie-Testdaten.
- Production-Billing-Livegang.
- Steuer-/Rechnungssteller-Freigabe.
- Usage-Billing, Credits oder Add-on-Metering.
Quellen
- AD-27
BILL-03BILL-04BILL-05BILL-07BILL-09VA-P24a