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-P24aund spaeterVD-P24konsumieren. - Parallelitaet:
BILL-08/EXT-16bleiben unabhaengige externe Production-Gates. - Abhaengigkeitsschutz: Die technischen Codes
starter/pro/business, die Sitzpaket-IDsstarter/team/businessund alle Provider-Referenzen bleiben unveraendert. Insbesondere bleibt das Mappingpro->team->Swarmerhalten.
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/businesszustarter/team/businessbleibt 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.*undsettings.subscription.checkout.plans.packages.*.title. - Kanonischer Vertrag aus
@hivegrid/entitlements(hiveGridBasePlans). - Fokussierter i18n-Vertrag fuer
deunden. - 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.mdpackages/entitlements/src/commercial-catalog.ts
Umsetzungs-Notiz
2026-07-29 · gestartet
- Saubere Worktree
/tmp/hivegrid-bill-12auf aktuellemorigin/main(ca96e036d) und Branchfix/billing-followup-20260729angelegt. - 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.tsan. Dieser nicht-kanonische Schreibpfad wird in BILL-12 entfernt. - Externe Gates bleiben ausschliesslich in
BILL-08/EXT-16. - Plane-Identitaet als
raffael@tool-ctrl.debestaetigt;HIVEGRID-211angelegt, Raffael zugewiesen und auf In Progress gesetzt. - Kundenanzeige in
deundenauf Core / Swarm / Colony gezogen und mitcommercial-plan-names.i18n.test.tsanhiveGridBasePlansgebunden. - Der mittlere technische Tarif bleibt
pro, verwendet weiterhin das Sitzpaketteamund wird kundenpraesent als Swarm getestet. plans.server.ts, der zugehoerige Create-all-Schreibpfad und der ungenutztecreatePlans-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
11521hat inPricingPlanForm.tsxeine 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
11522waren 10/11 Jobs gruen. Die Gesamtsuite hat als einzigen Fehler einen veralteten Audit-i18n-Vertrag gefunden, der den entfernten Demo-Seed-Auditadmin.pricing.createdPlansnoch 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, Head012a8d1b1, CI-Lauf11523mit 11/11 erfolgreichen Jobs. Vollstaendiger Typecheck, Gesamtsuite, Build/Bundle, Docker-Smoke, Datenbank-Checks und alle Service-Checks sind gruen.