178 lines
9.1 KiB
Markdown
178 lines
9.1 KiB
Markdown
# 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.**
|