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

11 KiB

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

  • 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.
  • 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.
  • Kapazitätsresolver, Upload-Reservierung und Usage-Projektion verwenden exakt denselben gemeinsamen Pool und bleiben RLS-/fail-closed-sicher.
  • Registrierung und Tarifkarten erklären Inklusivpool plus Wachstum je Zusatznutzer; die Aktivierung zeigt den serverseitig berechneten Gesamtpool vor dem optionalen Cloud-Speicher Plus-Upsell.
  • Billing-Verwaltung, Checkout-Vorschau, Lago-Managed-Plan und Rechnung verwenden die neuen Preise ohne zweite clientseitige Preisquelle; technische Codes und bestehende Providerreferenzen bleiben stabil.
  • Alle neuen UI-Texte sind in den sechs Katalogsprachen vorhanden; Component-/VM-/Service-/Katalog-/Capacity-/Sync-Tests decken den Vertrag.
  • CR-023, Preisentwurf und die abhängigen Ticket-Docs dokumentieren Produktentscheidung, Auswirkung und Rollback.
  • Typecheck, Lint, vollständige Testsuite sowie Billing-, i18n-, Source-, Hot-Swap-, Visual- und relevante Security-Verifier sind grün.
  • 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

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.