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

188 lines
15 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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
- [x] **RLS** `USING`/`WITH CHECK`, `SET LOCAL app.tenant_id`, App-Rolle **ohne BYPASSRLS** (Mechanik gebaut + bewiesen)
- [x] **Cross-Tenant-Zugriff nachweisbar verhindert** (Gate-Beweis, Test belegt Isolation — 6/6 gegen echte PG)
- [x] **6 SHK-Standard-Rollen** geseedet (Partner-Liste; Permission-Bundles vorhanden — der Editor „Advanced-Einzelrechte" ist `D-P2`/David)
- [x] Gruppen-Verwaltung (N:M User) (inkl. idempotenter Bulk-Ops)
- [x] 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-id`s) 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.