Files
HiveGrid-Wireframes/03 Quellen und Referenzen/hivegrid-cloud/.planning/ticket-docs/R-P2b.md
T

272 lines
21 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
> **Nachzug 2026-07-15 (R-CR1/R-P20b, AD-29):** Die unten dokumentierte Sechs-Rollen-
> Implementierung bleibt historischer Proof für R-P2b, ist aber kein aktueller Provisionierungsvertrag
> mehr. Der Staging-/Dev-Seed und `shkRoles.server.ts` sind entfernt. Für neue Workspaces gelten fünf
> editierbare Tenant-Rollen (Vertrieb, Marketing, Innendienst, Buchhaltung/Verwaltung, Monteur) und
> ausschließlich die globale `Admin`-Rolle für den Owner; Bestands-Tenants bleiben unverändert.
| | |
| ----------------- | ------------------------------------------------------------------------------ |
| **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** | Done (Plane, seit 2026-07-07) |
**🎨 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)
- [x] **DSGVO-Ausführung zur Laufzeit** _(im Stand-Audit 2026-07-17 als fehlender DoD-Punkt nachgetragen — war bis dahin offen)_: `dsgvoGraceCronService` im Worker-Bootstrap verdrahtet, Lösch-Kaskade läuft RLS-kontext-gebunden im Modus Pseudonymisierung → s. Umsetzungs-Notiz 2026-07-17
## 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 · Milestones: (M019/M023/M024/M025/M026)
- `docs/ARCHITECTURE-DECISIONS.md` → AD-1 (RLS)
- `designer-briefs/P02-identitaet-mandantentrennung.md` · Ticket-Doc `D-P2.md`
## Dev-Nachzug (nach Davids `D-P2`-Delta)
- [ ] Rollen-/Lifecycle-Flows an Davids UI angepasst (Reassign-Panel, Lösch-Wizard)
- [ ] REQUIREMENTS/ROADMAP 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**. _(Korrektur Stand-Audit 2026-07-17: das galt nur für die Job-Kerne — das Laufzeit-Wiring des Grace-Cron-Service fehlte bis dahin vollständig, s. Umsetzungs-Notiz 2026-07-17.)_
- 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.
## Dependency-Nachzug 2026-07-15 · R-P20b
- User-Identitäten sind global über `lower(trim(email))` eindeutig; Resolver brechen bei Alt-Dubletten fail-closed ab.
- Pro Tenant und normalisierter E-Mail existiert höchstens eine lebende Einladung. Accept/Revoke/Owner-Claim sind bedingte, race-sichere Zustandswechsel.
- Der neue ownerlose Reservierungs-Claim gilt nur für `OWNER` und `pending_owner`. Normale Member-Einladungen behalten ihren bisherigen Lifecycle unverändert.
- Öffentliche Invite-Lookups sind rate-limitiert, indexgestützt und geben finalisierte/abgelaufene Capability-Daten nicht an fremde oder anonyme Sessions aus.
## Umsetzungs-Notiz 2026-07-17 (Akeshan) — Stand-Audit + DSGVO-Grace-Cron-Restarbeit
> Drei-Quellen-Audit (Doc vs. Plane vs. Code) via `/audit-ticket`. DoD 1–4 und die Screen-DoD
> waren im Code belegt (Proofs unverändert gültig). **Realer Befund an DoD 5:** Die DSGVO-Löschung
> war nur als Job-Kern + Self-Service-Antrag fertig — **kein Laufzeit-Ausführungspfad existierte**:
> `dsgvoGraceCronService` wurde nirgends konstruiert, der tägliche Cron ackte jeden Tick mit
> `"dsgvoGraceCronService not configured"`, und auch die Operator-CLI plant nur ein (Kommentar dort:
> „the grace-period cron picks it up later"). Ein bestätigter Löschantrag wurde nach Ablauf der
> 30 Tage **nie ausgeführt**. Zusätzlich hätte die Kaskade seit dem RLS-Cutover (13.07.) ohne
> Kontextbindung still 0 Zeilen getroffen (gleiche Klasse wie die notify()-Regression, PR #146).
**Fix (Branch `fix/r-p2b-dsgvo-grace-wiring`):**
- **`apps/worker/src/jobs/dsgvo-grace-bootstrap.ts` (neu):** `createWorkerDsgvoGraceCronService` —
`listOverdueUsers` als Per-Tenant-Sweep (`runActiveTenantSweep`) unter `runWithRlsContext({tenantId})`
(die `User`-Select-Policy zeigt dem Worker einen User nur über den gebundenen Membership-Tenant;
ein globaler Scan liefert unter FORCE RLS still 0 Zeilen), Kandidaten über Tenants dedupliziert.
Die Kaskade läuft inline (Muster AK-P21, serialisiert): jede `USER_FK_MAP`-Operation einmal pro
Membership-Tenant unter `{userId, tenantId}` plus einmal unter `{userId}` (idempotent, Summen korrekt).
- **Modus verbindlich `pseudonymize`** (Ticket-Design: PII-Anonymisierung, kein Hard-Delete, Audit-Kette
intakt; Entscheidung 2026-07-17): Grace-Cron-Kern + Handler-Vertrag von `mode:"delete"` auf
`"pseudonymize"` gezogen; `hardDeleteUser` wirft im Worker bewusst (Grant-Set kann Hard-Delete nicht erfüllen).
- **Bewusste Skips (geloggt + im Audit-Event-Metadata):** `AdminTenantNote`/`AdminUser`/`Feedback`/
`ImpersonationAudit`/`SupportTicket`/`SupportTicketMessage` haben im RLS-Vertrag keine Worker-Write-Grants,
`UserRole` nur SELECT. Die Zeilen behalten die Referenz auf das pseudonymisierte User-Skelett (Identitäts-Link
anonymisiert). **Grant-Erweiterung am generierten RLS-Vertrag = getrackter Folge-Punkt (Raffael, RLS-Territorium).**
- **Wiring** in `apps/worker/src/index.ts` (general-Group, neben AK-P21-Tenant-Delete).
**Proof:** `@hivegrid/worker`-Typecheck grün · ESLint grün · 12 DSGVO-Job-Tests grün (davon 4 neue
Bootstrap-Tests mit RLS-Policy-nachbildendem Fake-Client: unbound ⇒ 0 Zeilen/Reject, gebunden ⇒ trifft;
FK-Map-Vollklassifikations-Guard) · `handlers.test.ts` 110 grün · `index.test.ts` 58 grün ·
`verify:i18n`/`verify:sidebar-routes`/`verify:cross-cutting-models` Exit 0 · kein Schema-Change, keine Migration.
**Korrektur eines Audit-Zwischenbefunds:** `packages/db/src/shk-template-roles-seed.server.ts` ist
**kein** Dead-Code — `shk-v2.config.test.ts` (R-P20b) nutzt `shkTemplateRoleSeeds` als validierte
Provenance-Baseline der fünf AD-29-Rollen. Nur `seedShkTemplateRolesForTenant` ist ungenutzt; Datei bewusst belassen.
**%-Stand: 6/6 DoD (inkl. nachgetragenem Laufzeit-Punkt) = 100 %.** Offen bleibt nur der markierte
`design-nachzug` (Header-Tag) sowie der Folge-Punkt Grant-Erweiterung (außerhalb R-P2b, Owner Raffael).
## Dependency-Hinweis 2026-07-16 · Cutover-Regression bei worker-seitigem notify()
Der app-weite RLS-Cutover (`20260713190000_appwide_rls_cutover`) hat `NotificationDelivery` auf
FORCE RLS gestellt; worker-seitige `notify()`-Aufrufe ohne gebundenen Tenant-Kontext scheitern
seither still (beobachtet: Task-Reminder-Sweep stellt auf Staging nicht mehr zu, 16.07.).
Befund + To-do dokumentiert in `R-P1b.md` §Regressions-Befund (Owner notify()-Kern) und
`AK-P4b.md` (Notiz 16.07. Abend).
## Dependency-Nachzug 2026-07-29 · R-P2a Pflichtfeldvertrag
Der vorgelagerte Signup validiert konfigurierte Pflichtfelder jetzt unabhängig
vom Passwortzweig und lehnt leere Firma sowie leeren Vor- oder Nachnamen vor
der Tenant-Provisionierung ab. Rollen-, Gruppen-, Einladungs- und
DSGVO-Verträge dieses Tickets ändern sich nicht.
**Fortschritt:** R-P2b bleibt bei 6/6 DoD = 100 % done.