Files
HiveGrid-Wireframes/hivegrid-cloud/.planning/ticket-docs/R-P2b.md
T

128 lines
9.8 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 |
## 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+).