Refresh HiveGrid Cloud reference snapshot
This commit is contained in:
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.**
|
||||
Reference in new issue
Block a user