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

2.9 KiB

BILL-02 · HiveGrid Billing-Domain fuer Plans und Seats

Typ Dev (Code)
Owner Raffael
Phase Billing-Recut nach AD-27
Cycle/Fenster nach BILL-00
Status Umgesetzt / bereit fuer Review

Abhaengigkeiten & Parallelitaet

  • Blocked by: BILL-00
  • Blocks: BILL-03, BILL-05, BILL-06
  • Parallelitaet: kann parallel zu BILL-01 laufen, solange Lago-API noch gemockt wird.

Was wir bauen

Die lokale HiveGrid-Billing-Domain fuer Plans, Seats, Subscription-State und Entitlements. Ziel ist ein stabiler lokaler Zustand fuer Feature-Gates und UI, ohne dass jede Request-Entscheidung live gegen Lago geht.

Scope

  • Plans
  • Seats
  • Subscription-Status
  • Invoice-/Payment-Referenzen
  • Feature-Entitlements
  • Trial/Frozen/Read-only-State

Nicht im Scope:

  • Usage-Billing
  • Credits
  • Add-on-Metering
  • oeffentliche Preislogik
  • Steuer-/Rechnungssteller-Finalisierung

Definition of Done

  • Billing-Schema ist auf AD-27 ausgerichtet: Lago-/Mollie-Referenzen statt Legacy-Provider-IDs als Default.
  • Bestehende SubscriptionFeature-/tenantHasModule()-Logik bleibt nutzbar.
  • Seat-Anzahl und Plan-Code sind sauber modelliert.
  • Lokaler Subscription-Status kann trial, active, past_due, cancelled, frozen abbilden.
  • RLS/Tenant-Scope fuer alle neuen/angepassten Tabellen.
  • Unit-Tests fuer Plan-/Seat-/Entitlement-Resolver.
  • Kein neuer Entity-Builder-Konsument.

Fortschritt: BILL-02: 7/7 DoD = 100 % done.

Technische Bausteine

  • Eigenes Prisma-Schema im Billing-Bereich, keine neuen Modelle in core.prisma ausser noetige Relationen.
  • Forward-only Migration erst auf main/merge gemaess AD-21.
  • Domain-Service fuer resolveTenantBillingState() und resolveTenantEntitlements().

Umsetzungsnotiz

2026-07-04: Lokale Billing-Domain umgesetzt. prisma/schema/subscriptions.prisma enthaelt jetzt neutrale Lago-/Mollie-Referenzen, lokale planCode-/seatQuantity-Felder und Invoice-/Payment-Referenzen, ohne die bestehenden Legacy-Provider-Legacy-Felder zu entfernen. Standard-Entitlement-Plans seedet jetzt code und lagoPlanCode. Der neue DB-Service @hivegrid/db/billing-domain.server stellt resolveTenantBillingState() und resolveTenantEntitlements() bereit und liest ausschliesslich tenantgescoped per tenantId.

RLS/Tenant-Scope: Es wurden keine neuen Tabellen angelegt. Die angepassten Tenant-Billing-Tabellen bleiben ueber TenantSubscription.tenantId bzw. TenantSubscriptionProduct -> TenantSubscription.tenantId scoped; der neue Resolver akzeptiert nur tenantId und laedt keine globale Billing-Sicht.

Proof:

  • pnpm exec prisma validate
  • pnpm --filter @hivegrid/db typecheck
  • pnpm --filter @hivegrid/db exec vitest run src/billing-domain.server.test.ts src/subscriptions.server.test.ts src/entitlements-seed.server.test.ts

Quellen

  • AD-1, AD-2, AD-21, AD-27
  • R-P1b fuer tenantHasModule()
  • bestehende AK-P20-Billing-Grundlagen