Refresh HiveGrid Cloud reference snapshot

This commit is contained in:
david committed 2026-08-03 15:31:14 +02:00
1 parent 5e99e14772
commit 7f88026f79
5955 files changed
+1177325 -188362

No files matched your search

@@ -0,0 +1,116 @@
# BILL-17 · Storage-Limit im Billing-Usage-Tab konsistent anzeigen
| | |
| ----------------- | ------------------------------------------------------ |
| **Typ** | Launch-Fix · Billing Usage / RLS |
| **Owner** | Raffael |
| **Phase** | Pilot-Härtung |
| **Cycle/Fenster** | gestartet 2026-08-01 |
| **Status** | Done |
| **Plane** | HIVEGRID-236 |
## Abhängigkeiten & Parallelität
- **Blocked by:** kein technischer Blocker. `BILL-11` liefert den kanonischen
Plan-/Speicherkatalog; `BILL-13` liefert Usage-UI und Storage-Resolver.
- **Blocks:** erneuter Abschluss des wieder geöffneten `BILL-13`-DoD-Punkts
für RLS-gebundene Speichertransparenz.
- **Abhängigkeitsschutz:** Checkout, Mollie/Lago-Sync, Tarif- und Add-on-Codes,
Upload-Grenze sowie Automation-Usage bleiben unverändert.
## Was / Warum
Der finale Staging-UAT zeigte auf demselben aktiven Swarm-Workspace mit
`storage_100gb` zwei widersprüchliche Aussagen: Die Billing-Hauptseite zeigte
korrekt 350 GB, der separate Tab „Nutzung“ dagegen „0 BYTES“ und
„Kein Limit konfiguriert“.
Der große Wert „0 BYTES“ ist für einen frischen Workspace als aktueller
Verbrauch korrekt. Falsch ist die unbegrenzte Kapazität: Die alte Usage-Route
las Limits nur aus `SubscriptionFeature` und band ihre eigenen Queries nach dem
Modul-Gate nicht an den Tenant-RLS-Kontext. Sie verwendet künftig die bereits
kanonische Storage-Projektion aus Basistarif, Rollen-Sitzen, festen Add-ons,
gespeicherten Bytes und laufenden Upload-Reservierungen.
## Nicht im Scope
- Keine Preis-, Tarif-, Add-on-, Checkout-, Mollie- oder Lago-Änderung.
- Keine Migration, kein Backfill und kein neues Usage-Metering.
- Keine automatische Zusatzabrechnung oder Änderung an Upload-Schreibgrenzen.
- Keine neue Usage-UI oder finale Subframe-Optik.
## Definition of Done
- [x] Der Usage-Tab verwendet für Speicher die kanonische kommerzielle
Kapazitätsprojektion aus Plan, Rollen-Sitzen und aktiven Speicher-Add-ons.
- [x] Angezeigt werden gespeicherte plus laufend reservierte Bytes; Restmenge,
Prozentwert und Erschöpfung werden gegen exakt dieselbe Kapazität berechnet.
- [x] Der gesamte Tenant-Read ist RLS-gebunden; ein fehlender oder unbekannter
Speichervertrag wird nicht als unbegrenzte Kapazität dargestellt.
- [x] Service- und Route-Tests decken 350 GB, gespeicherte plus reservierte
Bytes, RLS-Bindung und den fail-closed Fehlerzustand ab; Texte sind de/en.
- [x] Typecheck, Lint, vollständige Testsuite und passende Source-/i18n-/RLS-
Gates sind grün.
- [x] PR-CI, normaler Merge und Staging-Deploy sind grün; der frische
Swarm-Workspace zeigt im Usage-Tab „Limit: 350 GB“ per Screenshot.
**BILL-17: 6/6 DoD = 100 % done. Kein selbst machbarer Punkt offen.**
2026-08-02 · Abhängigkeitsschutz für `BILL-23`:
- Der RLS-gebundene Usage-/Upload-Vertrag bleibt unverändert und konsumiert
weiterhin ausschließlich `calculateStorageCapacity`. `BILL-23` ändert die
versionierten Eingabewerte dieser einen Quelle, nicht den Read- oder
Locking-Pfad. Usage und Upload-Grenze werden zusammen regressionsgeprüft.
- `BILL-17` bleibt 6/6 DoD = 100 % done.
## Technische Bausteine
- `apps/web/app/utils/services/.server/billingStatusService.ts`
- `apps/web/app/services/billing/storage-capacity.server.ts`
- `apps/web/app/routes/app.$tenant/settings/billing/usage.tsx`
- bestehende `BillingUsageVM` und `BillingUsagePage`
- CR-014 in `docs/CHANGE-REQUESTS.md`
## Rollback
Reiner Code-Rollback der Read-Projektion und ihrer Klartext-Diagnostik. Es gibt
keine Datenmigration und keine Provider-Mutation. Bereits gebuchte Tarife,
Speicher-Add-ons, Zahlungen und Rechnungen bleiben unverändert. Ein Rollback
ändert weder die kanonische Upload-Grenze noch persistierte Usage-Daten.
## Umsetzungs-Notiz
2026-08-01 · Live-Fund, Scope und Implementierung
- Frischer Staging-Proof auf Revision `137358736`: Swarm mit 5 Büro-/15
Monteur-Sitzen plus `storage_100gb`, 350 GB auf der Billing-Hauptseite, aber
„Kein Limit konfiguriert“ im dedizierten Usage-Tab.
- Abhängigkeiten beidseitig geprüft: `BILL-11` und `BILL-13` liefern Katalog
und Resolver; `BILL-17` ändert keinen Konsumentenvertrag und blockiert nur die
erneute Abnahme des wieder geöffneten `BILL-13`-DoD-Punkts.
- Der Usage-Service bindet seinen vollständigen Read mit `runWithRlsContext`
und ersetzt ausschließlich die Storage-Metrik durch
`resolveTenantStorageUsage`. Gespeicherte und reservierte Bytes werden
addiert; ein nicht sicher bestimmbarer Vertrag erzeugt einen klaren
Fehlerzustand statt „unbegrenzt“.
- Fokussierter Zwischenproof: 9/9 Service-/Route-Regressionstests grün.
**BILL-17: 4/6 DoD = ~67 % done. Offen: vollständiges lokales Release-Gate,
PR-CI, normaler Merge, Staging-Deploy und Live-Screenshot.**
2026-08-01 · Release und Live-Abnahme
- Implementierung `d33080b17`, Main-Nachzug `cf373626a` und PR `#331`
bestanden CI-Run `11690` mit 11/11 Jobs einschließlich vollständigem
Typecheck/Test, Docker-Smoke und Datenbank-/RLS-Gates.
- PR `#331` wurde als normaler Merge-Commit `a47d6e13e` übernommen; die
ursprünglichen Feature-Commits bleiben als Main-Ancestors erhalten.
- Staging-Deploy `11691` war vollständig grün. Web, Admin, Portal, API und MCP
meldeten vor der Browser-Abnahme exakt Revision `a47d6e13e`.
- Der bezahlte frische Swarm-Tenant mit 100-GB-Add-on zeigt im dedizierten
Usage-Tab `0 BYTES`, `Limit: 350 GB` und `350 GB remaining`. Der gezielte
Chromium-UAT bestand 1/1; Screenshot
`59-final-usage-tab-350gb.png` liegt im finalen Desktop-UAT-Ordner.
**BILL-17: 6/6 DoD = 100 % done. Kein selbst machbarer Punkt offen.**