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

6.1 KiB

BILL-15 · Customer-Portal-Scaffold für neue und bestehende Tenants

Typ Pilot-Bugfix · Tenant-Bootstrap
Owner Raffael
Phase Billing-/Customer-Portal-Pilot-Readiness
Cycle/Fenster gestartet 2026-08-01
Status Complete · Plane-Sync pending
Plane HIVEGRID-216

Abhängigkeiten & Parallelität

  • Auslöser: Der Live-UAT von BILL-14 hat nach erfolgreicher Basis- und E-Mail-Marketing-Testzahlung einen 500er auf der Customer-Portal-Verwaltung nachgewiesen: Der Tenant-Bootstrap erzeugte keinen Portal-Datensatz.
  • Erfüllte Grundlagen: VA-P26a, VA-P26c, BILL-11, BILL-13 und die aktiven Customer-Portal-Produkte bleiben unverändert.
  • Blocks: Abschluss des BILL-14-Live-UAT und Pilot-Nutzung des Customer-Portal-Add-ons durch frisch registrierte Tenants.
  • Abhängigkeitsschutz: Der Scaffold ist reine, unveröffentlichte Konfiguration. Entitlement, Checkout, Freischaltung und öffentliche Portalauflösung bleiben an die bestehenden kommerziellen Gates gebunden.

Was wir bauen

Der bestehende Tenant-Bootstrap erzeugt innerhalb derselben Transaktion genau einen unveröffentlichten Customer-Portal-Scaffold. Er verwendet den kanonischen Tenant-Slug, den Tenant-Namen und den Owner als Ersteller. Ein Fehler rollt den gesamten Bootstrap zurück; ein Replay verändert ein bestehendes Portal nicht.

Eine Forward-only-Migration legt denselben Scaffold für bestehende Tenants ohne Portal an. Fremd belegte Slugs brechen vor jeder Mutation fail-closed ab.

Nicht im Scope

  • Portal veröffentlichen, PortalUser oder Projekte anlegen.
  • Preise, Pläne, Add-ons, Entitlements, Rechnungen oder Checkout ändern.
  • Custom-Domain-Claims oder DNS-/TLS-Zustände erzeugen.
  • Bestehende Portal-Konfigurationen überschreiben.

Definition of Done

  • Neue Tenants erhalten vor Marker-Abschluss und Aktivierung idempotent genau einen unveröffentlichten Portal-Scaffold mit Tenant-Slug/-Name.
  • Ein Scaffold-Fehler verhindert Marker-Abschluss und Tenant-Aktivierung; Bootstrap-Replays überschreiben kein bestehendes Portal.
  • Die Forward-only-Migration ergänzt nur fehlende Portale, prüft fremde Slug-Belegung fail-closed und enthält guarded Inverse-SQL.
  • Weder Bootstrap noch Migration erzeugen Billing-, Entitlement-, Checkout-, Domain- oder Veröffentlichungszustand und ändern keine RLS-Policy.
  • Unit-, Performance-, Migration-, Typecheck-, Lint-, Gesamt- und Release-Verifier sind grün.
  • PR-CI, Staging-Deploy und der Customer-Portal-Add-on-UAT mit Mollie-Testzahlung sind grün und per Screenshots belegt.

Fortschritt: BILL-15: 6/6 DoD = 100 % done. Plane-Abschluss steht nach Wiederverfügbarkeit des Trackers aus; 0 Punkte selbst machbar offen.

Rollback

  • Der Code-Commit ist atomar revertierbar. Bereits angelegte unveröffentlichte Scaffolds sind mit dem alten Code kompatibel.
  • Die Migration dokumentiert ausführbare, streng begrenzte Inverse-SQL. Sie entfernt ausschließlich von dieser Migration markierte, weiterhin unveröffentlichte und unkonfigurierte Scaffolds; konfigurierte Daten bleiben.
  • Entitlements, Zahlungen, Rechnungen und Domain-Zustände werden nie verändert.

Quellen

  • docs/CHANGE-REQUESTS.md CR-010
  • .planning/ticket-docs/VA-P26a.md
  • .planning/ticket-docs/VA-P26c.md
  • .planning/ticket-docs/BILL-14.md
  • docs/AGENT-CHECKLIST.md

Umsetzungs-Notiz

2026-08-01 · gestartet

  • Fehler im echten Staging-Registrierungs-/Billing-UAT reproduziert: Basisplan und E-Mail-Marketing wurden bezahlt und aktiviert; die Portal-Domain-Route scheiterte vor Darstellung des Kaufen-Gates an PORTAL_NOT_FOUND.
  • Kleinsten sicheren Fix gegen Loader-Mutation, Bezahl-Settlement und nachträgliches Lazy-Provisioning geprüft: Der unveröffentlichte Scaffold gehört in den Tenant-Bootstrap; bestehende Tenants brauchen einen einmaligen Backfill.
  • Bootstrap-, Performance- und Migrationsverträge ergänzt; 44 fokussierte Tests sind grün.
  • Lokaler Abschluss-Proof grün: Workspace-Typecheck, Web-Typecheck, Lint, 1.160 Testdateien mit 8.184 bestandenen Tests, Migration-/Schema-Parität, CI-Baseline und Source-Health. Die vollständige frische RLS-Migrationskette lief als Nicht-Superuser einschließlich 47 App-/Worker-RLS-Tests, 39 Portal-RLS-Tests und 7 echter Produkt-Tenant-Bootstrap-Tests grün. Das Bootstrap-Query-Budget bleibt mit maximal 26 Abfragen explizit begrenzt.
  • Plane-Identität als raffael@tool-ctrl.de bestätigt; HIVEGRID-216 angelegt, Raffael zugewiesen und auf In Progress gesetzt.

BILL-15: 5/6 DoD = ~83 % done. 1 Punkt selbst machbar.

2026-08-01 · Live-Abschluss

  • PR #318 wurde normal gemergt (c585ae27e); PR-CI #11631 und Staging-Deploy #11633 waren grün.
  • Der synthetische Staging-UAT belegt das Entitlement-Gate, den ausschließlich in Mollie-Testmode ausgeführten Customer-Portal-Checkout, die bestätigte Freischaltung und den danach zugänglichen Domain-Admin-Screen. Screenshots 22 bis 25 liegen im Desktop-Ordner HiveGrid-BILL-14-UAT-2026-07-31/final-live-verified-2026-08-01.
  • Die dabei sichtbar gebliebene ausstehende Lago-Erstrechnung ist fachlich BILL-16; Scaffold, Zahlung und Portal-Entitlement aus diesem Ticket sind korrekt und bleiben durch dessen Settlement-Nachzug unverändert.

BILL-15: 6/6 DoD = 100 % done. Plane-Sync ausstehend; 0 Punkte selbst machbar offen.

2026-08-02 · Abhaengiger Billing-IA-Nachzug

  • BILL-20 macht den bestehenden Customer-Portal-Kauf-/Domain-Flow als Zusatzmodul-Aufgabe aus der Billing-Uebersicht erreichbar. Scaffold, Produktcodes, 19,99-EUR-Checkout, Entitlement und Domain-Setup aus diesem Ticket bleiben unveraendert.