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

6.6 KiB

BILL-12 · Kundenplan-Namen im Billing konsistent anzeigen

Typ Dev/QA/Docs
Owner Raffael
Phase Billing-Recut nach AD-27
Cycle/Fenster gestartet 2026-07-29
Status Done
Plane HIVEGRID-211

Abhaengigkeiten & Parallelitaet

  • Blocked by: BILL-11 (Done). Der kanonische Katalog Core / Swarm / Colony steht.
  • Blocks: keinen technischen Vertrag. Der Nachzug stabilisiert die Kundenanzeige, die VA-P24a und spaeter VD-P24 konsumieren.
  • Parallelitaet: BILL-08 / EXT-16 bleiben unabhaengige externe Production-Gates.
  • Abhaengigkeitsschutz: Die technischen Codes starter / pro / business, die Sitzpaket-IDs starter / team / business und alle Provider-Referenzen bleiben unveraendert. Insbesondere bleibt das Mapping pro -> team -> Swarm erhalten.

Was wir bauen

Die bestehende Self-Service- und Sitzplatz-UI zeigt die in BILL-11 festgelegten Kundennamen Core, Swarm und Colony. Der Katalog bleibt die fachliche Quelle; ein ausfuehrbarer i18n-Vertrag verhindert, dass deutsche oder englische Anzeigen erneut auf die alten Paketnamen Starter, Team oder Business zurueckfallen.

Der bei leerer Produktdatenbank sichtbare Boilerplate-Demo-Generator wird entfernt. Er darf keine alten Basic-/Starter-/Pro-Tarife in USD/MXN oder Usage-Modelle mehr erzeugen. Ein leerer Admin-Katalog bleibt stattdessen mit Klartext fail-closed; individuelle pauschale oder einmalige Produkte bleiben separat anlegbar.

Zusaetzlich wird der Billing-Track auf den tatsaechlichen Stand bis BILL-12 nachgezogen. Die bereits erfolgreich erzeugte Staging-Rechnung bleibt als Betriebs-Proof dokumentiert.

Nicht im Scope

  • Umbenennung technischer Plan-, Sitzpaket- oder Provider-Codes.
  • Neue Preise, Laufzeiten, Features oder Usage-Metering.
  • Echte Production-Zahlungen vor BILL-08 / EXT-16.
  • Mollie-Live-KYC, Legal-/Steuerfreigabe oder Erhoehung des SEPA-Limits.
  • Finale Subframe-Optik aus VD-P24.

Definition of Done

  • Self-Service-Planwahl und Sitzplatz-Uebersicht zeigen in Deutsch und Englisch Core, Swarm und Colony.
  • Das technische Mapping starter / pro / business zu starter / team / business bleibt unveraendert und ist fuer den mittleren Tarif regressionsgetestet.
  • Ein ausfuehrbarer Vertrag gleicht die kundenpraesenten i18n-Namen mit dem kanonischen Commercial Catalog ab.
  • Billing-Track und betroffene Downstream-Doku bilden BILL-11/BILL-12 sowie die getrennten externen BILL-08-Gates korrekt ab.
  • Der Admin-Billing-Pfad kann keine alten Demo-Tarife oder Usage-Modelle mehr erzeugen und zeigt einen leeren Katalog mit Klartext fail-closed.
  • Fokussierte Billing-/i18n-Tests und passende Verifier sind gruen; der vollstaendige Typecheck und die Gesamtsuite laufen in CI.

Fortschritt: BILL-12: 6/6 DoD = 100 % done. Offen: nichts.

Technische Bausteine

  • Bestehende Keys unter settings.subscription.seats.package.* und settings.subscription.checkout.plans.packages.*.title.
  • Kanonischer Vertrag aus @hivegrid/entitlements (hiveGridBasePlans).
  • Fokussierter i18n-Vertrag fuer de und en.
  • Bestehende Self-Service-Server-Tests fuer das pro-/team-Mapping.
  • Admin-Pricing-Policy ohne Demo-Seed sowie ohne Usage-/Per-Seat-Modell.

Rollback

  • Reiner Anzeige-/Test-/Doku-Nachzug ohne Schema- oder Provider-Mutation.
  • Ein Code-Rollback stellt nur die vorherigen Anzeigenamen wieder her; bestehende Subscriptions, Rechnungen, Zahlungen und Mandate bleiben unveraendert.

Quellen

  • .planning/ticket-docs/BILL-11.md
  • .planning/ticket-docs/BILL-08.md
  • .planning/ticket-docs/VA-P24a.md
  • .planning/ticket-docs/VD-P24.md
  • packages/entitlements/src/commercial-catalog.ts

Umsetzungs-Notiz

2026-07-29 · gestartet

  • Saubere Worktree /tmp/hivegrid-bill-12 auf aktuellem origin/main (ca96e036d) und Branch fix/billing-followup-20260729 angelegt.
  • Audit bestaetigt: Provider-Katalog, Checkout-Success und Rechnungen verwenden bereits Core / Swarm / Colony. Veraltet sind die kundenpraesenten Self-Service-/Sitzpaket-Uebersetzungen.
  • Zweiter Audit-Fund: Die Admin-Tarifseite bietet bei leerer Datenbank noch Boilerplate-Demo-Plaene in USD/MXN und Usage-Modelle aus plans.server.ts an. Dieser nicht-kanonische Schreibpfad wird in BILL-12 entfernt.
  • Externe Gates bleiben ausschliesslich in BILL-08 / EXT-16.
  • Plane-Identitaet als raffael@tool-ctrl.de bestaetigt; HIVEGRID-211 angelegt, Raffael zugewiesen und auf In Progress gesetzt.
  • Kundenanzeige in de und en auf Core / Swarm / Colony gezogen und mit commercial-plan-names.i18n.test.ts an hiveGridBasePlans gebunden.
  • Der mittlere technische Tarif bleibt pro, verwendet weiterhin das Sitzpaket team und wird kundenpraesent als Swarm getestet.
  • plans.server.ts, der zugehoerige Create-all-Schreibpfad und der ungenutzte createPlans-Helper sind entfernt. Die Admin-Policy erlaubt nur noch pauschale wiederkehrende und einmalige Produkte; Usage- und Per-Seat-Modelle sind fail-closed.
  • Lokaler Proof: 32 fokussierte Tests sowie 21 Katalogtests gruen; zielgerichtetes ESLint, verify:i18n, verify:billing-catalog, verify:docs-links, verify:source-health, JSON-Validierung und EU-Provider-Import-Guard gruen. Vollstaendiger Typecheck, Gesamtsuite und der ressourcenintensive Coverage-Vertrag bleiben bewusst dem Gitea-Runner vorbehalten.
  • Der erste PR-CI-Lauf 11521 hat in PricingPlanForm.tsx eine nach der Policy-Verschaerfung unmoegliche TypeScript-Abfrage auf die ausgeschlossenen Usage-Modelle gefunden. Der redundante Portal-Filter ist entfernt; zielgerichtetes ESLint und die betroffenen Policy-/Katalogtests sind erneut gruen. Der vollstaendige CI-Rerun bleibt der letzte offene DoD-Punkt.
  • Im zweiten PR-CI-Lauf 11522 waren 10/11 Jobs gruen. Die Gesamtsuite hat als einzigen Fehler einen veralteten Audit-i18n-Vertrag gefunden, der den entfernten Demo-Seed-Audit admin.pricing.createdPlans noch als aktiven Route-Call verlangte. Der historische Anzeige-Schluessel bleibt fuer alte Logs erhalten; der Source-Vertrag prueft nun explizit, dass kein neuer Demo-Seed-Audit mehr erzeugt wird.
  • Abschluss-Proof: PR #296, Head 012a8d1b1, CI-Lauf 11523 mit 11/11 erfolgreichen Jobs. Vollstaendiger Typecheck, Gesamtsuite, Build/Bundle, Docker-Smoke, Datenbank-Checks und alle Service-Checks sind gruen.