9.8 KiB
R-P2b · P2 RLS-Härtung (Gate-Beweis) + RBAC + User-Lifecycle
| Typ | Dev (Code) |
| Owner | Raffael |
| Phase | P2 — Identität & Mandantentrennung |
| Cycle/Fenster | W1 — Fundament & Identität · fällig 2026-06-19 · Gate W1 (RLS-Gate-Beweis) |
| Status | geplant |
Abhängigkeiten & Parallelität
- Blocked by:
R-P2a(Auth/Tenant/Sessions) - Blocks: Gate W1 + alle Tenant-Daten-Module (ohne nachgewiesene RLS-Isolation darf kein Fach-Modul tenant-bezogen ausliefern)
- Läuft parallel zu: Akeshans
AK-P4a/AK-P4b(Files/Tasks, P2‖P4-Paar) — disjunkte Domänen, eigeneprisma/schema/*.prisma→ kein Schema-Konflikt (AD-21). - Konflikt-Risiko: gering — RLS-Policies sind DB-Migrations auf den Identitäts-Tabellen; additiv. db push auf Branch.
Was wir bauen
Die RLS-Härtung als Gate-Beweis (AD-1): Postgres-Row-Level-Security mit USING/WITH CHECK, SET LOCAL app.tenant_id pro Transaktion, App-Rolle ohne BYPASSRLS — mandantenübergreifender Zugriff nachweisbar verhindert. Dazu das RBAC (6 SHK-Standard-Rollen geseedet, Permission-Bundles + Advanced-Einzelrechte, Gruppen) und der User-Lifecycle: Einladung (48h-Token), Soft-Deaktivierung mit Reassign-Workflow, DSGVO-Löschung via PII-Anonymisierung ohne Audit-Trail-Verlust.
Benötigte Screens (Backend bedient — Design liefert D-P2)
| Screen [Route] | Kern-Inhalt | Liefert (Design) |
|---|---|---|
Rollen-Editor [/admin/roles] |
Rollen-Liste + Editor (Bundles + Advanced), 6 SHK-Rollen geseedet, Löschen mit Reassign | D-P2 (A2+A6) |
Gruppen [/admin/groups] |
Gruppen-Liste, Bulk-Add/Remove | D-P2 (A2) |
Mitarbeiter [/admin/users] |
User-Liste + Einladungs-Modal + Deaktivieren mit Reassign-Workflow | D-P2 (A2+A5) |
Konto löschen [/settings/account] |
Multi-Step: Erklärung → Export → PW+2FA → Countdown · Block bei einzigem Admin | D-P2 (A5) |
(RLS prägt zusätzlich die „keine-Berechtigung"-Empty/Denied-States aller Screens.)
Definition of Done
- RLS
USING/WITH CHECK,SET LOCAL app.tenant_id, App-Rolle ohne BYPASSRLS (Mechanik gebaut + bewiesen) - Cross-Tenant-Zugriff nachweisbar verhindert (Gate-Beweis, Test belegt Isolation — 6/6 gegen echte PG)
- 6 SHK-Standard-Rollen geseedet (Partner-Liste; Permission-Bundles vorhanden — der Editor „Advanced-Einzelrechte" ist
D-P2/David) - Gruppen-Verwaltung (N:M User) (inkl. idempotenter Bulk-Ops)
- User-Lifecycle: Einladung 48h (Default in
createWorkspaceInvite), Soft-Deaktivierung + Reassign-Workflow, DSGVO-PII-Löschung (Audit-Trail erhalten)
Technische Bausteine
- Entities (eigene
prisma/schema/auth.prisma/accounts.prisma):TenantRole(is_template_origin, 6 SHK-Rollen),Permission(role_id, permission_key),Group(N:M User),RoleAssignment. RLS-Policies als DB-Migration auf allen tenant-bezogenen Tabellen. - RLS-Kern (Eigenbau, AD-1): PgBouncer-kompatibles
SET LOCAL app.tenant_idpro Transaktion; App-DB-Rolle ohne BYPASSRLS. - Konnektor
tenantHasModule()greift bereits an Admin-Routen (Rollen/Gruppen/User). - DSGVO-Löschung = PII-Anonymisierung (kein Hard-Delete) → Audit-Hash-Kette (R-P1b) bleibt intakt.
is_demo_dataauf SHK-Rollen-Seed.
Quellen (granular)
ENTITY-MODEL.md→ Domäne 1 (TenantRole/Permission/Group/RoleAssignment) + 3 Architektur-Grundregeln (RLS AD-1)REQUIREMENTS.md→REQ-auth-rbac,REQ-auth-user-lifecycleROADMAP.md→ Phase 2 ·PHASE-SOURCES.md→ Phase 2 (M019/M023/M024/M025/M026)docs/ARCHITECTURE-DECISIONS.md→ AD-1 (RLS)designer-briefs/P02-identitaet-mandantentrennung.md· Ticket-DocD-P2.md_bmad-output/specs/M27-auth-multi-tenancy.md
Dev-Nachzug (nach Davids D-P2-Delta)
- Rollen-/Lifecycle-Flows an Davids UI angepasst (Reassign-Panel, Lösch-Wizard)
- REQUIREMENTS/PHASE-SOURCES nachgezogen
- Plane-Ticket
R-P2baktualisiert
Nachtrag 2026-06-22 (Claude) — Rollen-Liste übernommen, Relevanz-/Flag-Klärung
- Davids Rollen-LISTE übernommen (
RolesListView.tsx←settings/roles-and-permissions/roles.tsx): David-Tabelle (Rolle/Beschreibung/Mitglieder/Aktionen) + „Rolle erstellen", pixel+wiring-auditiert grün. Der Rollen-EDITOR (Bundles + „Erweiterte Einzelrechte") bleibt bewusst beim altenRoleForm— s.u. workspace-roles-Feature-Flag-Gate ENTFERNT (requireWorkspaceRolesBuilderAccess): Tenant-eigene Rollen sind P2-Kernfunktion für alle Tenants → nur noch Permissionapp.settings.roles.setentscheidet (kein Kill-Switch mehr). Tests (workspaceRoles.server.test.ts) nachgezogen, Suite grün.- ⚠️ Rollen werden erst SPÄTER wirklich relevant: Das System (anlegen/zuweisen, 6 SHK-Rollen) läuft, aber
der Rechte-Katalog hat heute fast nur
app.settings.*/app.dashboard.*. Die eigentlichen Fach-Rechte (Projekte/Aufträge/Rechnungen sehen/bearbeiten) entstehen erst mit den Modulen ab P6–P9. Custom-Rollen sind bis dahin „hohl" → Davids Bundle-/Advanced-Editor lohnt erst, wenn es Rechte zum Bündeln gibt. Deshalb Editor bis P6–P9 beim altenRoleFormbelassen. - Delete-mit-Reassign: kein Backend → UI-Guard (blockt bei Mitgliedern > 0). Reassign-Backend bleibt offen.
- Konto-Löschen-Wizard: David hat dafür (noch) KEIN Subframe-Design → wartet auf Davids Delta.
Umsetzungsstand (Claude, 2026-06-18 — RLS-Gate-Beweis erbracht; Rest screen-unabhängig offen)
Branch
p2b-rls(offp2a-auth-tenant). Bestandsaufnahme: RBAC, App-Level-Scoping, Einladungen, DSGVO-Löschung (deterministische Pseudonymisierung + Grace-Period + Audit-Hash-Kette), Admin-Panel und Gruppen liegen bereits vor. Der echte Gap war der RLS-Gate-Beweis (0 Policies, 0 SET-LOCAL-Mechanik).
Gebaut — RLS-Gate-Beweis (DoD-Punkte 1+2), Commit 22d7bead:
prisma/rls/tenant-isolation.sql: restricted App-Rollehivegrid_app(NOSUPERUSER, NOBYPASSRLS) +ENABLE/FORCE ROW LEVEL SECURITY+tenant_isolation-Policy (USING/WITH CHECKaufcurrent_setting('app.tenant_id', true)) aufTenantUser. Deliberates Rollout-Artefakt (NICHT im Auto-Migrations-Pfad): RLS scharf zu schalten macht ungeschützte Queries ergebnislos → Tabellen ziehen pro Modul nach, sobald ihre Zugriffe überwithTenantRLSlaufen.withTenantRLS(tenantId, cb)(utils/db/.server/tenantRls.server.ts): setzt den Kontext transaktions-lokal viaset_config(..., true)(==SET LOCAL, PgBouncer-Transaction-Pooling- kompatibel) und führt die Queries in derselben Transaktion → Policies greifen. + Unit-Test.- Isolations-Test (Gate-Beweis)
rls-tenant-isolation.integration.test.ts: 6 Assertions gegen eine echte Postgres (pgvector pg16) alshivegrid_app— Rolle ist non-superuser+non-bypassrls; Kontext A sieht nur A; Cross-Tenant-SELECT=0; ohne Kontext=0;WITH CHECKblockt Fremd-Insert; eigener Insert+Read ok. 6/6 grün bewiesen. Gated aufRLS_TEST_DATABASE_URL(skip ohne DB).
Befund — schon vorhanden (verifizieren/erweitern):
- RBAC:
Role/Permission/RolePermission/UserRole+seedRolesAndPermissions(generische Rollen Admin/SuperUser/User; 6 SHK-spezifische Rollen (Partner-Liste) per Tenant-Seed geliefert, s.u.). - Einladungen:
TenantUserInvitation+ Flow (workspace-invites.server, Token-Hash, accept/revoke; 48h-TTL erledigt 2026-06-19:WORKSPACE_INVITE_TTL_MS-Default increateWorkspaceInvite, Caller inmembers/new.tsxnutzt ihn statt der vorherigen 7 Tage; + Test). - DSGVO-Löschung:
packages/db/dsgvo/pseudonymize+ Workerdsgvo-deletion/dsgvo-grace-cron+ Audit-Hash-Kette — komplett. - Gruppen:
Group/GroupUser+ Basic-UI (Bulk-Ops noch dünn).
Gebaut — Nicht-RLS-Rest (DoD 4+5), Commit dcf2ae53:
- Soft-Deaktivierung (
tenantUserLifecycle.server.ts):deactivateTenantUsersetztTenantUserauf INACTIVE, blockiert aber das Deaktivieren des letzten aktiven Owner/Admin (Last-Admin-Guard); optionaler Ownership-Reassign (Gruppen) an einen Nachfolger;reactivateTenantUserals Gegenstück. - Gruppen-Bulk-Ops (
groups.db.server.ts):addUsersToGroup/removeUsersFromGroup, idempotent (createMany skipDuplicates). + 15 Tests.
Geklärt — SHK-Rollen (19.06., Owner-Entscheidung Raffael): Der Partner hat die Liste auf 6 Rollen
festgelegt (vorher spekulativ 10): Geschäftsführer, Projektleiter, Verwaltung, Vertriebler,
Kundensupporter, Monteur. Datengetrieben per Tenant-Seed (shkRoles.server.ts, upsert/idempotent,
is_demo_data). Die fachspezifischen Permission-Bundles wachsen pro Phase mit (CRM/Leads/Projekte ab
P6); bei P2 differenzieren nur die bestehenden App-/Settings-Rechte. DoD-Scope damit von 10 auf 6 gezogen
(alle Planungs-Docs nachgezogen, dependency-aware).
Offen / geflaggt:
- App-weiter RLS-Rollout:
withTenantRLSin die Fach-Modul-Queries + RLS pro Tabelle scharf (inkrementell, pro Modul) — nicht R-P2b-Scope, läuft mit P5+. - Davids
D-P2-Screens: Rollen-Editor (Bundles + Advanced-Einzelrechte), Gruppen, Mitarbeiter, Lösch-Wizard.
Proof: voller Typecheck grün · ESLint grün · volle Suite 3754 grün (+ 6 RLS-Integrationstests, die
gegen Docker-Postgres bewiesen wurden, in der CI/ohne DB sauber skippen) · Node 22.12.0. Branch
p2b-rls, noch nicht nach main gemergt.
Status (Stand 2026-06-19)
DoD 5/5 = 100 % · Ticket-Abschluss wartet auf D-P2 (David). Alle DoD-Punkte sind code-seitig erfüllt:
RLS-Gate-Beweis, 6 SHK-Rollen (Partner-final, geseedet), Gruppen+Bulk, Lifecycle inkl. 48h-Einladung
(2026-06-19). Selbst machbar offen: 0. Blockiert: Davids D-P2-Screens (Rollen-Editor mit
Advanced-Einzelrechte, Gruppen, Mitarbeiter, Lösch-Wizard) + screen-abhängige generische DoD
(Reachability/Visual-Regression/Smoke). Nicht R-P2b-Scope: app-weiter RLS-Rollout (P5+).