Files
HiveGrid-Wireframes/03 Quellen und Referenzen/hivegrid-cloud/.planning/ticket-docs/BILL-17.md
T

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-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

  • 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-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.