5.9 KiB
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-11liefert den kanonischen Plan-/Speicherkatalog;BILL-13liefert 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
- Der Usage-Tab verwendet für Speicher die kanonische kommerzielle Kapazitätsprojektion aus Plan, Rollen-Sitzen und aktiven Speicher-Add-ons.
- Angezeigt werden gespeicherte plus laufend reservierte Bytes; Restmenge, Prozentwert und Erschöpfung werden gegen exakt dieselbe Kapazität berechnet.
- Der gesamte Tenant-Read ist RLS-gebunden; ein fehlender oder unbekannter Speichervertrag wird nicht als unbegrenzte Kapazität dargestellt.
- Service- und Route-Tests decken 350 GB, gespeicherte plus reservierte Bytes, RLS-Bindung und den fail-closed Fehlerzustand ab; Texte sind de/en.
- Typecheck, Lint, vollständige Testsuite und passende Source-/i18n-/RLS- Gates sind grün.
- 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-17bleibt 6/6 DoD = 100 % done.
Technische Bausteine
apps/web/app/utils/services/.server/billingStatusService.tsapps/web/app/services/billing/storage-capacity.server.tsapps/web/app/routes/app.$tenant/settings/billing/usage.tsx- bestehende
BillingUsageVMundBillingUsagePage - 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 plusstorage_100gb, 350 GB auf der Billing-Hauptseite, aber „Kein Limit konfiguriert“ im dedizierten Usage-Tab. - Abhängigkeiten beidseitig geprüft:
BILL-11undBILL-13liefern Katalog und Resolver;BILL-17ändert keinen Konsumentenvertrag und blockiert nur die erneute Abnahme des wieder geöffnetenBILL-13-DoD-Punkts. - Der Usage-Service bindet seinen vollständigen Read mit
runWithRlsContextund ersetzt ausschließlich die Storage-Metrik durchresolveTenantStorageUsage. 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-Nachzugcf373626aund PR#331bestanden CI-Run11690mit 11/11 Jobs einschließlich vollständigem Typecheck/Test, Docker-Smoke und Datenbank-/RLS-Gates. - PR
#331wurde als normaler Merge-Commita47d6e13eübernommen; die ursprünglichen Feature-Commits bleiben als Main-Ancestors erhalten. - Staging-Deploy
11691war vollständig grün. Web, Admin, Portal, API und MCP meldeten vor der Browser-Abnahme exakt Revisiona47d6e13e. - Der bezahlte frische Swarm-Tenant mit 100-GB-Add-on zeigt im dedizierten
Usage-Tab
0 BYTES,Limit: 350 GBund350 GB remaining. Der gezielte Chromium-UAT bestand 1/1; Screenshot59-final-usage-tab-350gb.pngliegt im finalen Desktop-UAT-Ordner.
BILL-17: 6/6 DoD = 100 % done. Kein selbst machbarer Punkt offen.