# 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 - [x] Neue Tenants erhalten vor Marker-Abschluss und Aktivierung idempotent genau einen unveröffentlichten Portal-Scaffold mit Tenant-Slug/-Name. - [x] Ein Scaffold-Fehler verhindert Marker-Abschluss und Tenant-Aktivierung; Bootstrap-Replays überschreiben kein bestehendes Portal. - [x] Die Forward-only-Migration ergänzt nur fehlende Portale, prüft fremde Slug-Belegung fail-closed und enthält guarded Inverse-SQL. - [x] Weder Bootstrap noch Migration erzeugen Billing-, Entitlement-, Checkout-, Domain- oder Veröffentlichungszustand und ändern keine RLS-Policy. - [x] Unit-, Performance-, Migration-, Typecheck-, Lint-, Gesamt- und Release-Verifier sind grün. - [x] 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.