# 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.**