209 lines
11 KiB
Markdown
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.**
|