Refresh HiveGrid Cloud reference snapshot

This commit is contained in:
david committed 2026-08-03 15:31:14 +02:00
1 parent 5e99e14772
commit 7f88026f79
5955 files changed
+1177325 -188362

No files matched your search

@@ -0,0 +1,177 @@
# BILL-24 · Wertige ,99-Speicherpakete mit Legacy-Kompatibilität
| | |
| ----------------- | --------------------------------------------------- |
| **Typ** | Produktentscheidung · Billing-/Storage-Preisnachzug |
| **Owner** | Raffael |
| **Phase** | Pilot-Härtung |
| **Cycle/Fenster** | gestartet 2026-08-03 |
| **Status** | Done · Staging und Live-UAT verifiziert |
| **Plane** | HIVEGRID-247 |
**🎨 design-nachzug: offen** (seit 2026-08-03) — der Pilot-Slice verwendet
die bestehende Billing-UI aus `~/ui`; ein finales Subframe-Delta bleibt ein
getrackter Nachzug gemäß AD-28.
## Abhängigkeiten & Parallelität
- **Blocked by:** `BILL-23` liefert den gemeinsamen Workspace-Pool, die
stabilen technischen Add-on-Codes und den versionierten Lago-Vertrag.
- **Blocks:** `BILL-08` darf den Production-Katalog erst nach dem neuen
Katalog-/Staging-Proof freigeben; dessen Mollie-/Legal-Gates bleiben extern.
- **Abhängigkeitsschutz:** Basisplan, Inklusivspeicher, Speicherwachstum je
Zusatznutzer, technische Codes und Bestandsverträge bleiben unverändert.
Nur das neu buchbare Add-on-Angebot und dessen Preise werden nachgezogen.
## Was / Warum
Die in `BILL-23` eingeführten fairen Speicherpreise erfüllen die
50-Prozent-Margengrenze, wirken mit `1,25`, `6,25`, `12,50` und `62,50` EUR
aber wie interne Kalkulationswerte. Besonders `1,25 EUR` für 100 GB setzt
einen zu billigen Preisanker und erzeugt unnötig viele Kleinstpakete.
Neu buchbar sind deshalb drei klare, wertigere Stufen:
| Zusatzpool | Preis netto/Monat | direkte Hetzner-Kosten | Rohmarge vor Egress |
| ---------- | ----------------: | ---------------------: | ------------------: |
| +500 GB | 4,99 EUR | 3,13 EUR | 37,3 % |
| +1 TB | 9,99 EUR | 6,26 EUR | 37,3 % |
| +5 TB | 49,99 EUR | 31,30 EUR | 37,4 % |
Das bisherige `storage_100gb` bleibt mit seinem historischen Preis technisch
auflösbar, damit aktive Verträge, Rechnungen und Kapazitätsberechnungen nicht
brechen. Es wird im Self-Service weder angezeigt noch für einen neuen
Checkout akzeptiert.
## Nicht im Scope
- Keine Änderung an Basisplan-, Sitz-, E-Mail-Marketing- oder Portalpreisen.
- Keine Änderung am gemeinsamen Pool oder am Speicherwachstum je Nutzer.
- Keine Umbenennung oder Löschung technischer Codes und keine rückwirkende
Preisänderung bestehender Verträge.
- Keine Production-Provider-Mutation vor den Gates aus `BILL-08`.
- Kein verbrauchsabhängiges GB-Metering, Overage-Billing oder neue
Storage-Infrastruktur.
## Definition of Done
- [x] Im Self-Service sind ausschließlich 500 GB / 1 TB / 5 TB zu
4,99 / 9,99 / 49,99 EUR netto pro Monat neu buchbar.
- [x] Alle sichtbaren Speicherpreise enden auf `,99`; automatisierte
Kalkulation belegt weniger als 50 Prozent direkte Rohmarge.
- [x] `storage_100gb` ist unsichtbar und wird bei manipulierten Neuabschluss-
oder Checkout-Requests serverseitig fail-closed abgewiesen.
- [x] Bestehende `storage_100gb`-Verträge bleiben für Preis-, Rechnungs- und
Kapazitätsauflösung kompatibel.
- [x] Self-Service-VM, Checkout und Lago-Sync beziehen Preis und Kaufstatus
aus genau einem versionierten Katalog.
- [x] Typecheck, Lint, vollständige Testsuite sowie Billing-, i18n-, Source-,
Hot-Swap- und Visual-Verifier sind grün; Review-Screenshots sind geprüft.
- [x] PR-CI, normaler Merge, Staging-Katalog-Sync, Deploy und Live-UAT sind
grün; kein Production-Provider wird verändert.
**BILL-24: 7/7 DoD = 100 % done. Offen: 0 Punkte.**
2026-08-03 · Abhängigkeitsschutz für `BILL-25`
- `BILL-25` ersetzt ausschließlich die Neukaufpreise durch eine konservative
5×-Egress-Kalkulation und ergänzt beobachtende Download-Telemetrie. Technische
Codes, Kaufbarkeit, gemeinsamer Pool, Bestandsauflösung und historische
Rechnungen aus `BILL-24` bleiben unverändert.
- `BILL-24` bleibt 7/7 DoD = 100 % done. Die neue Katalogversion und ihr
Staging-/Production-Proof werden ausschließlich in `BILL-25` getrackt.
## Technische Bausteine
- `packages/entitlements/src/commercial-catalog.ts`
- `apps/web/app/services/billing/self-service-subscription.server.ts`
- `apps/web/app/services/billing/self-service-checkout.server.ts`
- `packages/view-models/src/billing/self-service-subscription.vm.ts`
- kontrollierter `scripts/billing-catalog`-Sync
- bestehende Billing-Verwaltung und Speicher-Upsell-Seite
## Rollback
- Katalog und Self-Service können gemeinsam auf Version `2026-08-02.2`
zurückgesetzt werden. Historische Rechnungen und Zahlungen werden nicht
gelöscht oder umgeschrieben.
- Technische Add-on-Codes bleiben identisch. Ein Rollback macht die alten
Stufen nur wieder für neue Vorschauen sichtbar; Bestandsverträge bleiben in
beiden Richtungen auflösbar.
- Staging wird ausschließlich über den kontrollierten Katalog-Sync geändert;
Production bleibt bis zur separaten Freigabe aus `BILL-08` unangetastet.
## Quellen
- `docs/CHANGE-REQUESTS.md` · CR-024
- `.planning/ticket-docs/BILL-23.md`
- `.planning/ticket-docs/BILL-08.md`
- `docs/pricing-draft.md`
## Umsetzungs-Notiz
2026-08-03 · gestartet
- Explizite Produktentscheidung im Chat: sichtbare Speicherpreise sollen
konsistent auf `,99` enden, wertiger wirken und nicht mit `1,99 EUR` oder
einem noch kleineren Preisanker beginnen.
- Entscheidung innerhalb der bestehenden Margengrenze: 500 GB für 4,99 EUR,
1 TB für 9,99 EUR und 5 TB für 49,99 EUR netto pro Monat. Die direkte
Rohmarge liegt bei rund 37 Prozent vor Egress und damit klar unter 50 Prozent.
- Plane-Identität als `raffael@tool-ctrl.de` bestätigt; `HIVEGRID-247`
angelegt, Raffael zugewiesen und auf In Progress gesetzt.
- Neuer Worktree auf `origin/main` (`1c8d8ad5e`). Workspace-Shape und
EU-Provider-Guard sind sauber; Typecheck und vollständige Baseline mit 1.194
Testdateien / 8.323 Tests grün (60 bewusst übersprungen).
2026-08-03 · lokale Umsetzung abgeschlossen
- Katalogversion `2026-08-03.1` trennt Bestandsauflösung und Neukauf: Alle vier
stabilen Providercodes bleiben auflösbar; neu kaufbar sind ausschließlich
`storage_500gb`, `storage_1tb` und `storage_5tb` zu 499/999/4.999 Cent.
- Self-Service veröffentlicht nur die drei kaufbaren Pakete. Die serverseitige
Vorschau lehnt unbekannte oder historische Pakete für neue Verträge ab, lässt
ein bereits aktives `storage_100gb` aber bei Plan-/Platzänderungen bestehen.
Checkout und Kapazitätsresolver verwenden dieselbe validierte Auswahl.
- Der Lago-Manifest-Sync führt den Kaufstatus als Metadatum mit. Der
Bestandsplan bleibt für bestehende Rechnungen erhalten; Production wurde
nicht verändert.
- Der visuelle Review fand zusätzlich widersprüchliche alte Tariftexte. Swarm
nennt jetzt in allen sechs Katalogsprachen durchgehend 500 GB und Colony 2
TB; Quellhashes und Browser-Baselines wurden kontrolliert nachgezogen.
- Typecheck, Lint, Billing-Boundary, 1.194 Core-Testdateien mit 8.324 grünen
Tests (60 bewusst übersprungen), 13 Chromium-Komponententests, i18n,
Source-Health, Hot-Swap, UI-Visual und CI-Baseline sind grün.
- Die drei selbst visuell geprüften Screens liegen unter
`~/Desktop/HiveGrid-BILL-24-Speicherpreise-Review-2026-08-03/`.
**BILL-24: 6/7 DoD = ~86 % done. Offen: PR-CI, normaler Merge,
Staging-Katalog-Sync, Deploy und Live-UAT; 0 weitere lokale
Implementierungspunkte.**
2026-08-03 · abgeschlossen
- Die drei atomaren Commits `5f25f258f`, `b2d970c60` und `6aac9c2d4` wurden
über PR #367 normal gemergt. Merge-Commit `5fba54e72`; die Feature-Commit-
Ancestry ist auf `main` erhalten.
- Alle 13 PR-Checks waren grün. Der Main-Lauf war mit 4/4 Checks grün; der
16:38 Minuten lange Stage-/Promote-Lauf hat Staging und die vorgesehenen
Production-Images ausgerollt und alle Web-/Service-Healthchecks bestanden.
- Web und API meldeten auf Staging jeweils `healthz` und `readyz` mit HTTP 200
und exakt Revision `5fba54e72c8b351a37c158ce5be27aba65db1f4d`.
- Der kontrollierte Staging-Lago-Plan wurde auf Version `2026-08-03.1` mit
Digest `e400ac119050602009c7a27bd51e4d17aa92e003de3fcd4d9852b09a8cd934c9`
angewandt. Die anschließende Verifikation lieferte alle 16 Ressourcen als
No-op. Redaktierter Snapshot:
`tmp/billing-catalog-snapshots/staging-2026-08-02T23-35-27-833Z.json`.
- Die echte Staging-Registrierung wurde ohne Versand, Account-Anlage oder
Zahlung bis zur Tarifempfehlung durchlaufen. Für 10 Büro- und 20
Baustellen-Nutzer wurde genau einmal Swarm empfohlen; Core, Swarm und Colony
zeigten konsistent 100 GB, 500 GB und 2.000 GB Inklusivspeicher.
- Zwei zusätzliche Live-Screenshots wurden visuell geprüft und zusammen mit
den drei Implementierungs-Screens unter
`~/Desktop/HiveGrid-BILL-24-Speicherpreise-Review-2026-08-03/` abgelegt.
- Der Production-Lago-Provider wurde weder geplant noch angewandt oder
verändert. Dessen Freigabe bleibt bei `BILL-08`.
**BILL-24: 7/7 DoD = 100 % done. Offen: 0 Punkte.**