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

178 lines
9.1 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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.**