129 lines
6.6 KiB
Markdown
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.
|