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

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