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-01laufen, 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,frozenabbilden. - 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.prismaausser noetige Relationen. - Forward-only Migration erst auf main/merge gemaess AD-21.
- Domain-Service fuer
resolveTenantBillingState()undresolveTenantEntitlements().
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 validatepnpm --filter @hivegrid/db typecheckpnpm --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-P1bfuertenantHasModule()- bestehende AK-P20-Billing-Grundlagen