79 lines
2.9 KiB
Markdown
79 lines
2.9 KiB
Markdown
# 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
|