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

129 lines
6.6 KiB
Markdown

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