15 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 |
🎨 design-nachzug: offen (seit 2026-07-07) — RBAC-Screens nach Davids D-P2-Review-Stand (2026-06-26) umgesetzt; offen: Gruppen-Bulk-Optik (Interim aus ~/ui, David-Backlog RBAC V2), Abteilung-Spalte (S01) und Bereich/Kategorie-Feld (M04, keine Modell-Felder) sowie evtl. Deltas aus Davids D-P2-Review.
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+).
Umsetzungs-Notiz 2026-07-07 (Akeshan, Zulieferung) — D-P2-Screens eingebaut, Screen-DoD geschlossen
Davids
D-P2-Handoff (2026-06-26,WF-P2 Admin RBAC„In Subframe/Review") hat die Screen-Blockade aufgelöst. Branchakeshan/r-p2b-rbac-screens(off main), Commits22e9923a9…3fcbbfb6e. Ich habe die offenen UI-Teile nach Davids Wireframes/Design-Standards gebaut; Backend blieb unverändert (einzige Ergänzung: Bulk-Intents an der bestehenden Gruppen-Action).
Gebaut (David-Optik, WF-P2 Admin RBAC):
- S01 Mitarbeiterliste (
components/screens/users/MembersPage.tsx): Suche + Rolle/Status/2FA-Filter, Eingeladene inline mit Status „Eingeladen", D01 Inline-Rollen-Dropdown (nutzt den bestehendenedit-Intent inkl. SuperUser-Guard), deaktivierte Mitglieder bleiben sichtbar (includeInactive). - M03 Deaktivieren + V01 Letzter-Admin-Blocker:
deactivateTenantUser/reactivateTenantUserendlich verdrahtet (neue Intentsdeactivate/reactivate); Last-Admin-Guard kommt als Codelast-adminzurück und öffnet den V01-Dialog (Copy wörtlich aus dem Wireframe). Ohne Reassign — Davids v1-Entscheidung; das Backend-Reassign bleibt als API bestehen. - M01 Einladen als echter Dialog (S 560) statt Slide-Over (
InviteMemberForm), Invite-Contract (Felder/CSRF/48h/data-ui-ids) unverändert. Rolle-bei-Einladung NICHT gebaut (Invitation speichert keine Rolle — Rollen kommen nach Annahme via D01). - S02 Rollen und Berechtigungen (
RolesPage.tsx): zusammengelegter Tab (alte/users-Matrix → Redirect auf Mitarbeiter,/permissions→ Redirect auf Rollen), Typ-Spalte (System/Eigene), Mitglieder-/Berechtigungs-Zähler; Settings-Icon-Tab „Rollen" nur noch als Fallback ohnemembers.view(sonst Tab-Leiste in S01/S02). - M04A Rolle anlegen / M04B Rolle duplizieren → M02 Rollen-Editor (L 1200): Sidebar-Sections aus
reiner Scope→Section-Map (
role-editor.vm.ts, KEINE neuen Permission-Keys), Suche, Toggle-Zeilen; speichert über die unverändertennew/$id-Action-Contracts. Duplizieren = Create mit vorgeladenem Permission-Set der Quelle (gleicher auditiertercreateWorkspaceRole-Pfad, kein neues Backend). Löschen mit D03-Blocker bei Mitgliedern > 0. Damit ist der Nachtrag vom 2026-06-22 (Editor deferred bis P6–P9) durch Davids geliefertes M02-Design überholt — bitte im Review bestätigen. - Gruppen Bulk-Add/Remove (Interim, AD-28 — David-Backlog):
GroupMembersDialog(M 720) ansettings/groups, neue idempotente Intentsbulk-add/bulk-removeaufaddUsersToGroup/removeUsersFromGroup(Tenant-Membership validiert,createLog-Audit). - VMs
packages/view-models/src/users/(members-list/roles-list/role-editor/groups-detail, pure, 27 Unit-Tests) · Hot-Swap-KettemembersList/rolesList(Adapter + Subframe-/Mock-Renderer, M015/M017) · Smoketests/e2e/members-roles.spec.ts(nicht-mutierend) · a11y-Specs (tenant-members,tenant-roles-permissions.*) auf die neue Struktur nachgezogen · i18n de/en.
Proof: Typecheck (web/view-models/ui-app/ui-mock/ui-subframe) grün · verify:i18n/verify:sidebar-routes/
verify:cross-cutting-models Exit 0 · 376 Tests grün über die betroffenen Suiten (members-Route 13/13 neu;
roles.test.tsx-Restfehler = bekannter Node-22.15-undici-Umgebungsfehler, identisch auf main) ·
KEIN Prisma-Schema-Change (Abteilung/Kategorie/Rollen-Status bewusst weggelassen statt Spalten zu erfinden).
Offen / geflaggt:
- Bewusst NICHT gebaut: Konto-Lösch-Wizard (Davids jüngere Entscheidung 2026-06-26: Backlog bis
Workspace-Settings; DSGVO-Self-Service existiert unter
/settings/privacy) · Reassign-Panel (V2) · „Einladung erneut senden" (kein Backend) · Rolle-bei-Einladung (kein Invitation-Feld). - Produkt-Widerspruch SHK-Seeds vs. „nur Admin" — ENTSCHIEDEN 2026-07-07 (Akeshan, → AD-29): Die 6
SHK-Seed-Rollen bleiben auf Staging/Dev als Test-Komfort; auf Produktion startet ein frischer
Tenant nur mit der Admin-Systemrolle (Davids validierte D-P2-Entscheidung). Umgesetzt als Gate in
seedShkRolesForTenant(shouldSeedShkRoles):SENTRY_ENVIRONMENT=production⇒ kein Seed (NODE_ENV ist auf Staging-Containern auch „production", daher entscheidet die deploy-scoped Variable); Override perSEED_SHK_ROLES=true|false, falls der Partner die Seeds produktiv doch will. 8 Tests. - Alt-Komponenten (
MembersListView,RolesListView,NewMember,RolesAndPermissionsMatrix,MemberInvitationsListAndTable) sind jetzt verwaist — Aufräumen als Folge-Cleanup.
%-Stand: fachliche DoD 5/5 = 100 % · screen-abhängige generische DoD (B6–10, D18–21) jetzt erfüllt
(Visual über die deterministischen Renderer-/Hot-Swap-Snapshots wie bei AK-P3; Gruppen-Optik als
design-nachzug markiert, s. Header-Tag). Done-Status nur mit Freigabe/Review durch Raffael.