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,208 @@
|
||||
# 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.**
|
||||
Reference in new issue
Block a user