Files
HiveGrid-Wireframes/hivegrid-cloud/.planning/ticket-docs/VR-P28a.md
T

59 lines
5.4 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.
# 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