Files
HiveGrid-Wireframes/03 Quellen und Referenzen/hivegrid-cloud/.planning/ticket-docs/R-P2b.md
T
2026-07-08 16:15:37 +02:00

15 KiB
Raw Blame History

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, eigene prisma/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_id pro 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_data auf 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-lifecycle
  • ROADMAP.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-Doc D-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-P2b aktualisiert

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 alten RoleForm — s.u.
  • workspace-roles-Feature-Flag-Gate ENTFERNT (requireWorkspaceRolesBuilderAccess): Tenant-eigene Rollen sind P2-Kernfunktion für alle Tenants → nur noch Permission app.settings.roles.set entscheidet (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 alten RoleForm belassen.
  • 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 (off p2a-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-Rolle hivegrid_app (NOSUPERUSER, NOBYPASSRLS) + ENABLE/FORCE ROW LEVEL SECURITY + tenant_isolation-Policy (USING/WITH CHECK auf current_setting('app.tenant_id', true)) auf TenantUser. 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 über withTenantRLS laufen.
  • withTenantRLS(tenantId, cb) (utils/db/.server/tenantRls.server.ts): setzt den Kontext transaktions-lokal via set_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) als hivegrid_app — Rolle ist non-superuser+non-bypassrls; Kontext A sieht nur A; Cross-Tenant-SELECT=0; ohne Kontext=0; WITH CHECK blockt Fremd-Insert; eigener Insert+Read ok. 6/6 grün bewiesen. Gated auf RLS_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 in createWorkspaceInvite, Caller in members/new.tsx nutzt ihn statt der vorherigen 7 Tage; + Test).
  • DSGVO-Löschung: packages/db/dsgvo/pseudonymize + Worker dsgvo-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): deactivateTenantUser setzt TenantUser auf INACTIVE, blockiert aber das Deaktivieren des letzten aktiven Owner/Admin (Last-Admin-Guard); optionaler Ownership-Reassign (Gruppen) an einen Nachfolger; reactivateTenantUser als 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: withTenantRLS in 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. Branch akeshan/r-p2b-rbac-screens (off main), Commits 22e9923a9…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 bestehenden edit-Intent inkl. SuperUser-Guard), deaktivierte Mitglieder bleiben sichtbar (includeInactive).
  • M03 Deaktivieren + V01 Letzter-Admin-Blocker: deactivateTenantUser/reactivateTenantUser endlich verdrahtet (neue Intents deactivate/reactivate); Last-Admin-Guard kommt als Code last-admin zurü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 ohne members.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änderten new/$id-Action-Contracts. Duplizieren = Create mit vorgeladenem Permission-Set der Quelle (gleicher auditierter createWorkspaceRole-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) an settings/groups, neue idempotente Intents bulk-add/bulk-remove auf addUsersToGroup/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-Kette membersList/rolesList (Adapter + Subframe-/Mock-Renderer, M015/M017) · Smoke tests/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 per SEED_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.