# 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 - [x] Billing-Schema ist auf AD-27 ausgerichtet: Lago-/Mollie-Referenzen statt Legacy-Provider-IDs als Default. - [x] Bestehende `SubscriptionFeature`-/`tenantHasModule()`-Logik bleibt nutzbar. - [x] Seat-Anzahl und Plan-Code sind sauber modelliert. - [x] Lokaler Subscription-Status kann `trial`, `active`, `past_due`, `cancelled`, `frozen` abbilden. - [x] RLS/Tenant-Scope fuer alle neuen/angepassten Tabellen. - [x] Unit-Tests fuer Plan-/Seat-/Entitlement-Resolver. - [x] 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