123 lines
6.1 KiB
Markdown
123 lines
6.1 KiB
Markdown
# 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.
|