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

209 lines
11 KiB
Markdown

# 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.**