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-14hat nach erfolgreicher Basis- und E-Mail-Marketing-Testzahlung einen 500er auf der Customer-Portal-Verwaltung nachgewiesen: Der Tenant-Bootstrap erzeugte keinenPortal-Datensatz. - Erfüllte Grundlagen:
VA-P26a,VA-P26c,BILL-11,BILL-13und 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.mdCR-010.planning/ticket-docs/VA-P26a.md.planning/ticket-docs/VA-P26c.md.planning/ticket-docs/BILL-14.mddocs/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.debestätigt;HIVEGRID-216angelegt, Raffael zugewiesen und auf In Progress gesetzt.
BILL-15: 5/6 DoD = ~83 % done. 1 Punkt selbst machbar.
2026-08-01 · Live-Abschluss
- PR
#318wurde normal gemergt (c585ae27e); PR-CI#11631und Staging-Deploy#11633waren 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
22bis25liegen im Desktop-OrdnerHiveGrid-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-20macht 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.