# 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 - [x] Self-Service-Planwahl und Sitzplatz-Uebersicht zeigen in Deutsch und Englisch Core, Swarm und Colony. - [x] Das technische Mapping `starter` / `pro` / `business` zu `starter` / `team` / `business` bleibt unveraendert und ist fuer den mittleren Tarif regressionsgetestet. - [x] Ein ausfuehrbarer Vertrag gleicht die kundenpraesenten i18n-Namen mit dem kanonischen Commercial Catalog ab. - [x] Billing-Track und betroffene Downstream-Doku bilden BILL-11/BILL-12 sowie die getrennten externen `BILL-08`-Gates korrekt ab. - [x] Der Admin-Billing-Pfad kann keine alten Demo-Tarife oder Usage-Modelle mehr erzeugen und zeigt einen leeren Katalog mit Klartext fail-closed. - [x] 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.