117 lines
5.9 KiB
Markdown
117 lines
5.9 KiB
Markdown
# 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.**
|