# 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.**