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

9.1 KiB
Raw Blame History

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

  • 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.
  • Alle sichtbaren Speicherpreise enden auf ,99; automatisierte Kalkulation belegt weniger als 50 Prozent direkte Rohmarge.
  • storage_100gb ist unsichtbar und wird bei manipulierten Neuabschluss- oder Checkout-Requests serverseitig fail-closed abgewiesen.
  • Bestehende storage_100gb-Verträge bleiben für Preis-, Rechnungs- und Kapazitätsauflösung kompatibel.
  • Self-Service-VM, Checkout und Lago-Sync beziehen Preis und Kaufstatus aus genau einem versionierten Katalog.
  • Typecheck, Lint, vollständige Testsuite sowie Billing-, i18n-, Source-, Hot-Swap- und Visual-Verifier sind grün; Review-Screenshots sind geprüft.
  • 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.