Update hivegrid-cloud reference to latest main
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
This commit is contained in:
1 parent
e98d38e716
commit
7b21524c86
3781 files changed
+373484
-225607
No files matched your search
@@ -0,0 +1,78 @@
|
||||
# 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
|
||||
Reference in new issue
Block a user