Refresh HiveGrid Cloud reference snapshot

This commit is contained in:
david committed 2026-08-03 15:31:14 +02:00
1 parent 5e99e14772
commit 7f88026f79
5955 files changed
+1177325 -188362

No files matched your search

@@ -0,0 +1,122 @@
# 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.