7.7 KiB
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-P12aundAK-P20sind Done. - Blocks:
VR-P32dkonsumiert die stabilen Pipeline-Defaults.R-P12clä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.
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
- Versionierte, schema-validierte SHK-Konfiguration mit stabilem Digest; kein
SEED_*-Runtime-Schalter - RLS-gebundener, atomarer und idempotenter Bootstrap;
Tenant.active=trueerst zuletzt, Marker überIdempotencyKey - Signup, neuer Workspace und Owner-Claim verwenden denselben Service; ownerlose Admin-/Lead-Anlage bleibt inaktive Reservierung
- Owner erhält nur globale
Admin; fünf editierbare Tenant-Rollen werden mit konservativer Rechte-Matrix angelegt - Drei Sales-Pipelines werden angelegt; Wärmepumpe ist Default, bestehende validierte Stage-Baseline wird wiederverwendet
- Vorhandene Custom-Field-, Projekt-, Abnahme-, Formular- und Checklist-Defaults laufen innerhalb derselben Transaktion
- Drei unveröffentlichte Automation-Metadaten-Platzhalter werden ohne unbekannte Nodes oder erfundene Parameter angelegt
- 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 aktivenPrisma.TransactionClientexplizit ansetupweiter.- Marker:
partitionKey=tenant:<id>,scope=tenant-bootstrap,key=shk-v2,requestHash=<config-digest>, permanenter erfolgreicher Response-Body. - Kein
Promise.allinnerhalb 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.mddocs/security/RLS-HARDENING-2026-07-13.mddocs/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 Einladungsmail7f334082e,e8838dc0c,a9c25c1b9,f1d85ccb1; DB-/RLS-/CI-Härtungd041a7d08,3e3b15a20; Replay-, Lockout- und Diagnose-Härtung1dd2325b1,7d77da104,1d4ee37b0,a7e613dcc. - Proof Lieferung: PR
#119, Feature-Head93af473c8, normaler Merge-Commit357d3139e3mit zwei Eltern; kein Squash. Alle 13 PR-Checks sowie Accessibility-Run10162waren 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
10163auf Revision357d3139e3erfolgreich. 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, keinSEED_*im Modul), atomarer RLS-gebundener Bootstrap mitIdempotencyKey-Marker undactive=trueals 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 selbentx-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) undbf318a0083(PR #120) existieren und sind Ancestors vonmain. Migration20260715030000_tenant_bootstrap_shk_v2mit 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. Keindesign-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.