# R-P20b · Zentraler Tenant-Bootstrap + SHK-Defaults v2 | | | | ----------------- | --------------------------------------- | | **Typ** | Dev (Code) | | **Owner** | Raffael | | **Phase** | P20 — Onboarding-Nachzug / M158 | | **Cycle/Fenster** | v2-W1 · 2026-07-15 → 2026-07-17 | | **Status** | In Review · umgesetzt · 8/8 DoD = 100 % | ## Abhängigkeiten & Parallelität - **Blocked by:** keine offenen Blocker. `R-CR1`, `R-P2a`, `R-P2b`, `R-P8a`, `R-P12a` und `AK-P20` sind Done. - **Blocks:** `VR-P32d` konsumiert die stabilen Pipeline-Defaults. `R-P12c` läuft unabhängig und materialisiert später die Automation-Platzhalter. - **Betroffene Contracts:** Tenant-/User-Erzeugung, RLS-Kontext, globale `Admin`-Rolle, typisierte Pipeline-/Onboarding-/Automation-Tabellen. - **Migration:** kein neues Prisma-Modell. Der dauerhafte Versionsmarker nutzt `IdempotencyKey`. Forward-only-Migrationen materialisieren den globalen Checklist-Katalog und härten die bereits vorhandenen Registration-/User-/Invitation-Invarianten sowie den öffentlichen Invite-Resolver. ## Was wir bauen Einen zentralen Lifecycle für neue Workspaces. Tenant, Owner-Mitgliedschaft, exakt eine Owner-Rolle und alle SHK-Defaults werden unter gebundenem Tenant-/User-RLS-Kontext in **einer** Transaktion angelegt. Der Tenant wird erst im letzten Transaktionsschritt aktiv. Fehler rollen alles zurück; Mail, Billing, Cache, Events und Plugin-Hooks laufen erst nach Commit. ```text Signup / Neuer Workspace ─┐ ├─> atomarer Bootstrap ─> Tenant aktiv ─> Post-Commit-Sideeffects Owner-Claim Reservierung ─┘ Admin-/Lead-Reservierung ohne Owner ─> Tenant bleibt inaktiv ─> späterer Owner-Claim ``` Einladungen legen keinen Tenant an. Normale Member-Einladungen starten den Bootstrap nie; ausschließlich ein verifizierter `OWNER`-Claim darf eine bereits vorhandene inaktive `pending_owner`-Reservierung atomar provisionieren und aktivieren. Bereits bestehende aktive Tenants werden nicht nachträglich migriert. ## Definition of Done - [x] Versionierte, schema-validierte SHK-Konfiguration mit stabilem Digest; kein `SEED_*`-Runtime-Schalter - [x] RLS-gebundener, atomarer und idempotenter Bootstrap; `Tenant.active=true` erst zuletzt, Marker über `IdempotencyKey` - [x] Signup, neuer Workspace und Owner-Claim verwenden denselben Service; ownerlose Admin-/Lead-Anlage bleibt inaktive Reservierung - [x] Owner erhält nur globale `Admin`; fünf editierbare Tenant-Rollen werden mit konservativer Rechte-Matrix angelegt - [x] Drei Sales-Pipelines werden angelegt; Wärmepumpe ist Default, bestehende validierte Stage-Baseline wird wiederverwendet - [x] Vorhandene Custom-Field-, Projekt-, Abnahme-, Formular- und Checklist-Defaults laufen innerhalb derselben Transaktion - [x] Drei unveröffentlichte Automation-Metadaten-Platzhalter werden ohne unbekannte Nodes oder erfundene Parameter angelegt - [x] Rollback-, Replay-, RLS-Isolation-, Entry-Point- und Performance-Tests grün; kein Bestands-Tenant wird verändert ## Technische Bausteine - Pure Config + Zod-Schema unter `apps/web/app/domain/tenant-bootstrap/`. - Zentraler Server-Service mit vorbereiteter User-ID/Passworthash außerhalb der DB-Transaktion. - `createTenant()` reicht den aktiven `Prisma.TransactionClient` explizit an `setup` weiter. - Marker: `partitionKey=tenant:`, `scope=tenant-bootstrap`, `key=shk-v2`, `requestHash=`, permanenter erfolgreicher Response-Body. - Kein `Promise.all` innerhalb der interaktiven Prisma-Transaktion. - Globale Checklist-Definition ist Deploy-/Migrationskatalog; Runtime erzeugt nur Tenant-/User-Sessions. - Keine neue Route oder UI: bestehende Signup-/Workspace-/Admin-Flächen bleiben die Reachability-Grenze; kein Sidebar-/Mobile-/Portal-Eintrag nötig. ## Quellen - `.planning/ticket-docs/R-CR1.md` - `.planning/ticket-docs/R-P2a.md`, `R-P2b.md`, `R-P8a.md`, `R-P12a.md`, `AK-P20.md` - `docs/security/RLS-HARDENING-2026-07-13.md` - `docs/ARCHITECTURE-DECISIONS.md` → AD-1, AD-12, AD-21 ## Rollback-Pfad Code-Rollback entfernt die neuen Entry-Point-Aufrufe; unvollständige Transaktionen hinterlassen keine Teilzustände. Die Forward-only-Migrationen bleiben bestehen und haben jeweils Inverse-SQL als Kommentar. Nach erfolgreichem Bootstrap werden Defaults nicht automatisch rückwärts gelöscht, weil Tenant-Änderungen erhalten bleiben müssen. ## Umsetzungs-Notiz **2026-07-15 · In Review · R-P20b: 8/8 DoD = 100 % done · 0 offen · 0 blockiert.** - Proof Code: SHK-Konfiguration und atomare Provisionierung `e8db1ac6d`, `b01dee994`, `b4c531c48`; Entry-Points, Owner-Claims und Einladungsmail `7f334082e`, `e8838dc0c`, `a9c25c1b9`, `f1d85ccb1`; DB-/RLS-/CI-Härtung `d041a7d08`, `3e3b15a20`; Replay-, Lockout- und Diagnose-Härtung `1dd2325b1`, `7d77da104`, `1d4ee37b0`, `a7e613dcc`. - Proof Lieferung: PR `#119`, Feature-Head `93af473c8`, normaler Merge-Commit `357d3139e3` mit zwei Eltern; kein Squash. Alle 13 PR-Checks sowie Accessibility-Run `10162` waren grün. - Proof Tests: `pnpm typecheck`, `pnpm lint`, `pnpm test` (5.418 grün, 53 übersprungen), Tenant-Coverage 99,43 % Statements/96,66 % Branches, `pnpm run verify:tenant-policy-contract` (268/268), `pnpm run verify:rls-release-readiness` (225/225 Modelle), Live-RLS (39 + 7 Bootstrap-Fälle), Migrations-Parität, Identity-/Invite-Migration (13/13), SHK-Migration (9/9), `prisma validate`, Builds und Runtime-Closures grün. - Proof Staging: Deploy-Run `10163` auf Revision `357d3139e3` erfolgreich. One-shot-Migration, Core-Health, abhängige Services, Sentry-Markierung und CDN-Purge waren grün; kein Produktions-Deploy wurde ausgelöst. - Der vollständige Bootstrap läuft für Self-Service, neue Workspaces und verifizierte Owner-Claims über denselben atomaren Service. Ownerlose Reservierungen bleiben bis zum Claim inaktiv; Bestands-Tenants werden nicht verändert. **2026-07-20 · Stand-Audit (Akeshan) · R-P20b: 8/8 DoD = 100 % bestätigt · 0 offen · 0 blockiert.** - Alle 8 DoD-Punkte gegen den realen Code verifiziert, nicht nur gegen die Haken: SHK-v2-Config mit Zod-Schema und stabilem Digest (`apps/web/app/domain/tenant-bootstrap/shk-v2.config.ts`, kein `SEED_*` im Modul), atomarer RLS-gebundener Bootstrap mit `IdempotencyKey`-Marker und `active=true` als explizit letztem Write (`tenantBootstrapService.server.ts` §`bootstrapShkV2TenantWithTx`), gemeinsamer Service für Signup (`authService.ts`), Workspace-Anlage (`TenantsApi.ts`) und ownerlose Reservierung (`admin/accounts/new`), Admin + 5 Tenant-Rollen, 3 Pipelines mit Wärmepumpe-Default, alle Default-Provisioner am selben `tx`-Client, 3 Automation-Platzhalter (`.length(3)`-Schema), Test-Suite inkl. Live-RLS-Integration und Performance-Contract. - Alle 13 Proof-Commits sowie Merge-Commits `357d3139e3` (PR #119) und `bf318a0083` (PR #120) existieren und sind Ancestors von `main`. Migration `20260715030000_tenant_bootstrap_shk_v2` mit Inverse-SQL-Kommentaren und RLS-bewusstem ACL-Guard vorhanden. - Post-RLS-Cutover-Check: Umsetzung erfolgte nach dem 14.07.-Cutover, Kontextbindung durchgängig via `runWithRlsContext`; kein Regressions-Risiko gefunden. Kein Drift zwischen Doc, Plane und Code. Kein `design-nachzug` (kein UI-Ticket). Status In Review bleibt bewusst bis zum Sign-off. **2026-07-29 · Dependency-Nachzug aus R-P2a.** Konfigurierte Pflichtfelder werden im Signup jetzt vor dem gemeinsamen Tenant-Bootstrap unabhängig vom Passwortzweig geprüft. Leere Firma oder leerer Vor-/Nachname können den atomaren SHK-Provisionierungsservice damit nicht mehr erreichen. Bootstrap-, Replay-, RLS- und Default-Verträge bleiben unverändert. **Fortschritt:** R-P20b bleibt bei 8/8 DoD = 100 % done.