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

5.4 KiB
Raw Blame History

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