# VR-P28a · AdminUser-Welt + AdminRBAC (M038/039) | | | |---|---| | **Typ** | Dev (Code) | | **Owner** | Raffael | | **Phase** | Phase 28 (v2-P8) — Plattform-Admin-Tiefe | | **Cycle/Fenster** | v2-W3 — Admin/Help/Dashboard/v2-Launch · fällig 2026-07-29 | | **Status** | geplant | ## Abhängigkeiten & Parallelität - **Blocked by:** `AK-P19` (v1-Admin-Welt-Fundament: Host-Routing `admin.hivegrid.de`, Cookie-Trennung, TOTP-Pflicht, AdminAuditLog, Audit-Hash-Kette — die v1-Auflagen-Brücke M034) - **Blocks:** `VR-P31` (DSGVO-Admin-Legal-Verwaltung braucht die AdminUser-Identität/-RBAC + cross-tenant AdminAuditLog), `VA-P28b` (Akeshans Flag-Massen-Statistik/interne Lead-Pipeline läuft in derselben Admin-Welt) - **Läuft parallel zu:** `VA-P28b` (Flag-Massen-Statistik + interne Lead-Pipeline, Akeshan) — gleiche Phase, getrennte Bausteine: Raffael = Identität/RBAC/Audit, Akeshan = Flag-Statistik/Lead-Pipeline. Eigene `prisma/schema/admin.prisma` (AD-21), **getrennte Welt, KEIN `tenant_id`** auf Admin-Tabellen. Koordination nur am gemeinsamen AdminAuditLog. - **Konflikt-Risiko:** gering — gemeinsamer AdminAuditLog (Owner = Raffael, Akeshan dockt an); berührt `core.prisma` nur für die Ablösung der v1-User-Extension. ## Was wir bauen Die **echte getrennte AdminUser-Identität und AdminRBAC** auf `admin.hivegrid.de` (M038/M039) — sie **löst die v1-Auflagen-Brücke** (Boilerplate-User-Extension + `admin-mfa-gate.server.ts`) ab. Eigene `AdminUser`-Klasse, hart getrennt von `User`/`TenantUser` (eigene Cookies SameSite=Strict, kein Cross-Routing, **kein BYPASSRLS** — der Admin liest Tenant-Daten via RLS mit gesetztem `app.tenant_id`). AdminRBAC mit eigenen Bundles + Default-Rollen (super_admin/support/sales/engineering/viewer), **2FA-Pflicht**, 8h-Session, **Self-Permission-Schutz** (letzter super_admin darf sich nicht entrechten). **AdminAuditLog cross-tenant** mit Reason-Pflicht bei sensitiven Aktionen; Impersonate mit Reason + Banner. ## Benötigte Screens (Backend bedient — Design liefert `D-P28`/`D-ADMIN` — interner Polish) | Screen [Route] | Kern-Inhalt | |---|---| | AdminUser-Verwaltung [`admin.hivegrid.de/admin-users`] | Liste AdminUser, Status, Rolle, letzte Aktivität; Anlegen durch super_admin | | AdminUser-Detail [`/admin-users/:id`] | Rollen-Zuweisung, Sessions, Audit-Trail, **Self-Permission-Schutz** | | AdminRole-Editor [`/admin-users/roles`] | Permission-Bundles je Rolle, Default-Rollen, Bundle-Zuweisung | | Admin-Security-Settings [`/settings/security`] | Aktive Sessions + individueller Revoke, 2FA-Pflicht, 8h-Session-Policy | | Cross-Tenant-Audit-View [`/audit`] | `AdminAuditLog` über alle Tenants, Reason-Pflicht-Einträge, Impersonate-Records, Filter | *(Feature-Flag-Massen-Statistik + interne Lead-Pipeline = Akeshans `VA-P28b`.)* ## Definition of Done - [ ] Eigene `AdminUser`-Klasse, **kein BYPASSRLS** (Admin liest Tenant-Daten via RLS mit `app.tenant_id`), eigene Cookies **SameSite=Strict**, kein Cross-Routing - [ ] **AdminRBAC** + eigene Bundles + Default-Rollen (super_admin/support/sales/engineering/viewer) + **2FA-Pflicht** + 8h-Session + **Self-Permission-Schutz** (letzter super_admin) - [ ] **AdminAuditLog cross-tenant** mit **Reason-Pflicht** bei sensitiven Aktionen - [ ] **Impersonate** mit Reason + Klartext-Banner im Tenant (kein BYPASSRLS, temporäre Tenant-Session) - [ ] v1-Boilerplate-User-Extension (`admin-mfa-gate.server.ts`) durch die echte getrennte Identität abgelöst ## Technische Bausteine - **Entities** (eigene `prisma/schema/admin.prisma` — **KEIN `tenant_id`**, getrennte Welt, AD-21): `AdminUser` ([v2]: `email`, `password_hash`, `totp_secret` (Pflicht), `status`), `AdminRole`/`AdminPermission`/`AdminSession` ([v2]: `name` super_admin/support/sales/…, `permission_id`, `expires_at` (8h), `ip`), `AdminAuditLog` (`admin_user_id`, `action_type`, `target_kind`/`id`, `summary_text`, `metadata` Diff — cross-tenant, tenant_id=null, über Audit-Hash-Kette aus AK-P3). - **Wiederverwendung:** v1-Auth-Bausteine (TOTP/Bcrypt/Session) — wiederverwendet, **eigene Tabellen**; nicht das TenantUser-Modell teilen. - **Kein BYPASSRLS (Hardgrenze):** Admin-Datenzugriff auf Tenant-Daten läuft über RLS mit gesetztem `app.tenant_id` — bewusste Härtegrenze (konsistent mit VR-P32b Admin-View). - **Impersonate:** generiert temporäre Tenant-User-Session mit Banner + Audit-Spur + Reason-Pflicht; kein BYPASSRLS. - **Konnektor:** AdminRBAC-Bundles (keine `tenantHasModule`-Logik — Admin-Welt ist tenant-los). - **`is_demo_data`:** nicht relevant (Admin-Welt, keine Tenant-Seed-Daten). ## Quellen (granular) - `ROADMAP-V2.md` → §v2-P8 (Success-Criteria 1/2/3, AdminUser/RBAC/Audit-Screens) — **Hauptquelle** - `ROADMAP.md` → Phase 28 - `PHASE-SOURCES.md` → Phase 28 (M038/M039); Scope-Schnitt 12.06.: M038/M039 → v2; bindende v1-M034-Auflagen (TOTP/kein Workspace/Host-Routing/Cookie-Trennung) als Fundament - `ENTITY-MODEL.md` → Domäne 11 Plattform-Admin (`AdminUser`/`AdminRole`/`AdminSession` [v2], `AdminAuditLog`, eigene Welt ohne tenant_id) - `designer-briefs/P28-plattform-admin-tiefe.md` (Admin-Screens, Hardgrenze Admin-Welt, kein BYPASSRLS) - `_bmad-output/specs/M37-plattform-admin.md` (Block A–D) - Querverweis: `ticket-docs/AK-P19.md` (v1-Admin-Welt-Fundament, v1-Cuts → v2) ## Dev-Nachzug (nach Davids `D-P28`-Delta) - [ ] Spec/ENTITY-MODEL an Davids UI-Entscheidungen angepasst - [ ] REQUIREMENTS/PHASE-SOURCES nachgezogen - [ ] Plane-Ticket `VR-P28a` aktualisiert