# BILL-23 · Lizenzbasierter Workspace-Speicherpool und faire Add-on-Preise | | | | ----------------- | -------------------------------------------- | | **Typ** | Produktentscheidung · Billing-/Storage-Recut | | **Owner** | Raffael | | **Phase** | Pilot-Härtung | | **Cycle/Fenster** | gestartet 2026-08-02 | | **Status** | Done | | **Plane** | HIVEGRID-246 | **🎨 design-nachzug: offen** (seit 2026-08-02) — der Pilot-Slice verwendet vorhandene `~/ui`-Bausteine; ein finales Subframe-Delta bleibt ein getrackter Nachzug gemäß AD-28. ## Abhängigkeiten & Parallelität - **Blocked by:** `BILL-11` liefert den versionierten Katalog und Lago-Sync, `BILL-17` den RLS-gebundenen Kapazitäts-/Usage-Vertrag und `BILL-22` die getrennte Speicher-Upsell-Seite. Alle drei technischen Grundlagen sind Done. - **Blocks:** `BILL-08` darf den Production-Katalog erst nach dem neuen Katalog-/Staging-Proof freigeben; dessen Mollie-/Legal-Gates bleiben extern. - **Abhängigkeitsschutz:** Technische Plan-, Add-on- und Provider-Codes bleiben stabil. Checkout, Upload-Grenze, Usage-Tab, Lago-Rechnung und Mollie-Betrag verwenden weiterhin dieselbe serverautoritative Katalogquelle. ## Was / Warum Der bisherige Vertrag nennt pro Tarif einen pauschalen Workspace-Speicher und gibt zusätzlichen Büro-/Baustellen-Nutzern unterschiedliche Kontingente. Das ist schwer erklärbar, obwohl Projektdateien dem Workspace und nicht einer Person gehören. Gleichzeitig liegen die Add-on-Preise bei 84 bis 93 Prozent Rohmarge gegenüber den direkten Hetzner-Speicherkosten. Der neue Vertrag kombiniert eine verständliche Nutzerlogik mit einem technisch gemeinsamen Workspace-Pool: | Tarif | Inklusiver gemeinsamer Pool | Wachstum je zusätzlichem bezahlten Nutzer | | ------ | --------------------------: | ----------------------------------------: | | Core | 100 GB | +10 GB | | Swarm | 500 GB | +20 GB | | Colony | 2 TB | +40 GB | Büro- und Baustellen-Nutzer erweitern den Pool gleich. Es entstehen keine persönlichen Speicher-Silos; Dateien bleiben bei Austritt eines Nutzers im Projekt/Workspace. Der Pool kann über feste, vorhersehbare `Cloud-Speicher Plus`-Pakete erweitert werden: | Zusatzpool | Preis netto/Monat | direkte Hetzner-Speicherkosten | Rohmarge vor Egress | | ---------- | ----------------: | -----------------------------: | ------------------: | | +100 GB | 1,25 EUR | 0,626 EUR | 49,9 % | | +500 GB | 6,25 EUR | 3,13 EUR | 49,9 % | | +1 TB | 12,50 EUR | 6,26 EUR | 49,9 % | | +5 TB | 62,50 EUR | 31,30 EUR | 49,9 % | Der Preisdeckel verwendet bewusst nur die direkten zusätzlichen Speicherkosten von 6,26 EUR/TB/Monat als COGS. Ausgehender Traffic senkt die tatsächliche Rohmarge weiter. Es gibt keine überraschende Einzel-GB- oder Overage-Abrechnung. ## Nicht im Scope - Keine harten Speicher-Silos oder Eigentumswechsel pro Nutzer. - Kein verbrauchsabhängiges GB-Metering, keine automatische Overage-Rechnung und keine rückwirkende Rechnungsänderung. - Keine Änderung an Basisplan-, Sitz-, E-Mail-Marketing- oder Portalpreisen. - Keine Umbenennung technischer Codes und keine Production-Provider-Mutation vor den Gates aus `BILL-08`. - Keine Archiv-/Cold-Storage-Funktion oder neue Storage-Infrastruktur. ## Definition of Done - [x] Der kanonische Katalog modelliert 100/500/2.000 GB gemeinsamen Basisspeicher sowie 10/20/40 GB je zusätzlichem Nutzer; Büro und Baustelle sind für Speicher gleichwertig. - [x] Die vier stabilen Speicher-Add-on-Codes kosten 1,25/6,25/12,50/62,50 EUR netto pro Monat; automatisierte Kalkulation beweist maximal 50 Prozent Rohmarge gegen 6,26 EUR/TB direkte Speicherkosten. - [x] Kapazitätsresolver, Upload-Reservierung und Usage-Projektion verwenden exakt denselben gemeinsamen Pool und bleiben RLS-/fail-closed-sicher. - [x] Registrierung und Tarifkarten erklären Inklusivpool plus Wachstum je Zusatznutzer; die Aktivierung zeigt den serverseitig berechneten Gesamtpool vor dem optionalen `Cloud-Speicher Plus`-Upsell. - [x] Billing-Verwaltung, Checkout-Vorschau, Lago-Managed-Plan und Rechnung verwenden die neuen Preise ohne zweite clientseitige Preisquelle; technische Codes und bestehende Providerreferenzen bleiben stabil. - [x] Alle neuen UI-Texte sind in den sechs Katalogsprachen vorhanden; Component-/VM-/Service-/Katalog-/Capacity-/Sync-Tests decken den Vertrag. - [x] CR-023, Preisentwurf und die abhängigen Ticket-Docs dokumentieren Produktentscheidung, Auswirkung und Rollback. - [x] Typecheck, Lint, vollständige Testsuite sowie Billing-, i18n-, Source-, Hot-Swap-, Visual- und relevante Security-Verifier sind grün. - [x] PR-CI, normaler Merge, Staging-Katalog-Sync, Deploy und Live-UAT sind grün; kein Production-Provider wird verändert. **BILL-23: 9/9 DoD = 100 % done. Offen: nichts.** 2026-08-03 · Abhängigkeitsschutz für `BILL-24` - `BILL-24` ersetzt ausschließlich die sichtbaren Speicher-Add-on-Stufen und ihre Neukaufpreise. Gemeinsamer Workspace-Pool, Wachstum je Zusatznutzer, technische Codes sowie Bestandsauflösung aus `BILL-23` bleiben unverändert. - Das bisherige 100-GB-Paket bleibt für aktive Verträge auflösbar, ist aber kein neues Self-Service-Angebot mehr. `BILL-23` bleibt 9/9 DoD = 100 % done. ## Technische Bausteine - `packages/entitlements/src/seat-packages.ts` - `packages/entitlements/src/commercial-catalog.ts` - `packages/entitlements/src/storage-capacity.ts` - `packages/view-models/src/billing/self-service-subscription.vm.ts` - `apps/web/app/services/billing/{registration-plan-selection,self-service-subscription,storage-capacity}.server.ts` - `apps/web/app/modules/users/components/RegistrationPlanStep.tsx` - `apps/web/app/components/screens/billing/SelfServiceSubscriptionPage.tsx` - kontrollierter `scripts/billing-catalog`-Sync und bestehende Usage-/Upload-Gates ## Rollback - Katalog und UI können gemeinsam auf Version `2026-08-02.1` zurückgesetzt werden. Bereits ausgestellte Rechnungen, Zahlungen und historische Provider-Managed-Pläne werden nicht gelöscht oder umgeschrieben. - Technische Plan-/Add-on-Codes bleiben identisch. Ein Rollback verändert nur neue Preisvorschauen und zukünftige Managed-Pläne; aktive Providerobjekte werden ausschließlich über den kontrollierten Katalog-Sync behandelt. - Die Upload-Grenze bleibt zu jedem Zeitpunkt aus genau einer versionierten Kapazitätsfunktion abgeleitet und fällt bei unbekanntem Vertrag geschlossen. ## Quellen - `docs/CHANGE-REQUESTS.md` · CR-023 - `.planning/ticket-docs/BILL-11.md` - `.planning/ticket-docs/BILL-17.md` - `.planning/ticket-docs/BILL-22.md` - https://support.google.com/a/answer/9214707 - https://learn.microsoft.com/en-us/office365/servicedescriptions/sharepoint-online-service-description/sharepoint-online-limits - https://www.hetzner.com/storage/object-storage/ ## Umsetzungs-Notiz 2026-08-02 · gestartet - Explizite Produktentscheidung im Chat: Speicherabrechnung vollständig neu denken, pro Tarif verständlich mit Nutzern wachsen lassen, in den vorhandenen geführten Billing-Flow integrieren und Add-on-Rohmarge auf maximal 50 Prozent begrenzen. - Plane-Identität als `raffael@tool-ctrl.de` bestätigt; `HIVEGRID-246` angelegt, Raffael zugewiesen und auf In Progress gesetzt. - Neuer Worktree auf `origin/main` (`eab504cff`). EU-Provider-Guard leer; Typecheck und vollständige Baseline mit 1.193 Testdateien / 8.320 Tests grün (60 bewusst übersprungen). - Marktvertrag geprüft: Google Workspace poolt pro Endnutzerlizenz gewährten Speicher organisationsweit; Microsoft 365 kombiniert einen gemeinsamen Organisationssockel mit zusätzlichem Speicher je Lizenz. HiveGrid übernimmt dieses verständliche Pool-Prinzip, nicht deren absolute Kontingentgrößen. 2026-08-02 · lokale Umsetzung abgeschlossen - `fd812a1de` dokumentiert `CR-023`, Preis-/Margenmodell, Abhängigkeiten und Rollback. Der Speicherkatalog verwendet stabile technische Codes. - `2730cc308` macht den serverautoritativen Pool zur einzigen Quelle für Registrierung, Vorschau, Checkout, Usage-/Upload-Kapazität und Lago-Sync. Automatisierte Tests beweisen 100/500/2.000 GB Basis, 10/20/40 GB je Zusatzlizenz sowie 4.992 Basispunkte Rohmarge für alle vier Add-ons. - `7cd38a025` erklärt den gemeinsamen Pool und dessen Lizenzwachstum in Registrierung, Aktivierung und Billing-Verwaltung in allen sechs Katalogsprachen. `90be6c0d5` pinnt die Visual-Fixture auf den VM-Vertrag; `c01d52332` aktualisiert ausschließlich die beabsichtigten Plan- und Speicher-Screens. - Typecheck, Lint, CI-Baseline, Billing-Katalog/-Boundary, i18n, Source-Health, Hot-Swap und Chromium-Component-Test sind grün. Die vollständige Suite hat 1.194 Testdateien und 8.323 Tests bestanden; 60 Live-/Integrationstests blieben wie vorgesehen umgebungsbedingt übersprungen. - Die sieben geprüften Journey-Screens liegen zusätzlich unter `~/Desktop/HiveGrid-BILL-23-Speicher-Review-2026-08-02/`. **BILL-23: 8/9 DoD = ~89 % done. Offen: PR-CI, normaler Merge, Staging-Katalog-Sync, Deploy und Live-UAT; 0 weitere lokale Implementierungspunkte.** 2026-08-02 · Staging-Proof und Abschluss - Pull Request `#365` lief mit den CI-Runs `11895`, `11896` und `11897` vollständig grün und wurde normal gemergt. Merge-Revision: `5b5c961105eb9c599089321d1bffc7624c16f728`; der Feature-Head `7e4983f608e4401874067be5d7854aa9294bcf21` ist nachweislich Vorfahr des Merge-Commits. - Der kontrollierte Lago-Staging-Sync hat Katalogversion `2026-08-02.2` mit Digest `492992bcefd923d35c94f84b564372b7cfd89c08a9ecb9439f25d9b6becc5977` angewendet. Der anschließende Verify-Lauf meldete alle 16 Steuer-/Planobjekte als No-op. Redaktierter Snapshot: `tmp/billing-catalog-snapshots/staging-2026-08-02T21-20-18-902Z.json`. Der Production-Provider blieb unangetastet. - Die vier Main-Runs `11898`, `11899`, `11900` und `11901` sind grün. Der Deploy-Job `50139` schloss erfolgreich ab. `/healthz`, `/readyz` und `/register` antworteten live mit HTTP 200; Health und Readiness lieferten exakt Revision `5b5c961105eb9c599089321d1bffc7624c16f728`. - Die Live-Planberatung empfahl auf Staging für 1/0 Nutzer Core, für 5/15 und 10/20 Nutzer Swarm sowie für 20/50 Nutzer Colony. Die Antworten enthielten die neuen serverautoritativen Speicherwerte 100/500/2.000 GB und 10/20/40 GB je Zusatzlizenz. Der visuelle Journey-Proof bleibt unter `~/Desktop/HiveGrid-BILL-23-Speicher-Review-2026-08-02/`. - Ein erneuter interaktiver Mollie-Checkout war für diesen reinen Speichervertrag nicht erforderlich: Zahlungsmethoden, Mandat und Provider-Codes wurden nicht geändert; deren echte Testzahlungs-UAT bleibt im eigenen Checkout-Ticket `BILL-22` getrackt. **BILL-23: 9/9 DoD = 100 % done. Offen: nichts.**