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

8.4 KiB

VR-P28a · AdminUser-Welt + AdminRBAC (M038/039)

Plane HIVEGRID-111
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 Ready for Review

🎨 design-nachzug: offen · Die produktiv verdrahtete Interim-UI ist die aktuelle Visual-Baseline; Davids späteres Subframe-Delta wird separat nachgezogen.

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, VA-P28b (CRM Core/M040b), VA-P28c (persönliche Admin-Mailboxen) und VR-P28a-RBAC (vorbereitete Mitarbeiter, Rollenpakete und Own-/All-Scope); die übrigen Admin-Sales-Tickets konsumieren diese Identity-/Permission-Verträge transitiv.
  • Läuft parallel zu: VA-P28b nur in dessen unabhängigem M033-Anteil. Eigene prisma/schema/admin.prisma (AD-21), getrennte Welt, KEIN tenant_id auf Admin-Tabellen.
  • Konflikt-Risiko: gering — gemeinsamer AdminAuditLog (Owner = Raffael, Akeshan dockt an); berührt core.prisma nur für die Ablösung der v1-User-Extension.

M040a-/Sales-Kompatibilitätsvertrag (2026-07-24): R-LEADS darf vor diesem Ticket gegen die bestehende AdminUser/User-Brücke bauen. Beim Wechsel auf die getrennte AdminUser-Welt müssen assignedToAdminUserId, Source-Defaults, Notification-Empfänger, Activities sowie später angelegte Sales-Ownership-Felder verlustfrei migriert werden.

Delivery-Owner-Update 2026-07-24: Raffael übernimmt VA-P28c bis VA-P28i. Der von VR-P28a bereitgestellte Identity-/RBAC-Vertrag sowie Scope, Termine und Abhängigkeiten bleiben unverändert.

Fortschritt: 6/6 DoD = 100 % done.

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. Authentik bleibt gemäß Estate-Standard der einzige produktive Admin-Login und liefert die geprüfte MFA-Assurance. Eigene AdminUser-Klasse und AdminSession, 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), erzwungener MFA-Assurance, 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. Es entsteht kein zweiter produktiver Passwort-/TOTP-Stack.

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

(M040a Intake/AdminLead-Inbox = R-LEADS; Feature-Flag-Massenstatistik, M040b und CRM Core = VA-P28b; weitere Sales-Kanäle = VA-P28c bis VA-P28i.)

Definition of Done

  • Eigene AdminUser-/AdminSession-Welt, Authentik als einziger produktiver Login, 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) + erzwungene Authentik-MFA-Assurance + 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) aus produktiven Auth-/MFA-Pfaden entfernt; ausschließlich der fail-closed gegatete lokale Admin-Fallback bleibt
  • Granulare Admin-Sales-Permissions und Rollen-Mapping für CRM, E-Mail, Telefonie, Sequenzen, Booking, Quote/Signatur, Reporting, Automation und Integrationen stehen; bestehende R-LEADS-Assignments sind verlustfrei übernommen

Technische Bausteine

  • Entities (eigene prisma/schema/admin.prisma — KEIN tenant_id, getrennte Welt, AD-21): AdminUser (email, Authentik-Subject, Status und Assurance-Metadaten, keine produktiven lokalen Credentials), AdminRole/AdminPermission/AdminSession (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).
  • Authentifizierung: Authentik-OIDC wird serverseitig validiert und an eine eigene AdminSession gebunden. Der lokale Credential-Fallback bleibt ausschließlich unter den fail-closed Dev-Guards aus AGENTS.md; er ist kein produktiver Auth-Vertrag.
  • 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).
  • Sales-Permission-Bundles: admin_sales.crm.*, admin_sales.email.*, admin_sales.phone.*, admin_sales.sequence.*, admin_sales.booking.*, admin_sales.quote.*, admin_sales.signature.*, admin_sales.reporting.*, admin_sales.automation.* und admin_sales.integrations.*; konkrete Actions verwenden nur die kleinste nötige Permission.
  • 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
  • Historische Milestone-Zuordnung: 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)
  • Querverweis: ticket-docs/AK-P19.md (v1-Admin-Welt-Fundament, v1-Cuts → v2)

Dev-Nachzug (nach Davids D-P28-Delta)

  • Interim-UI aus bestehenden ~/ui-Komponenten mit VM-/Action-Grenze für /admin-users, /admin-users/:id, /admin-users/roles und /settings/security produktiv verdrahtet
  • Interim-Visual-Baseline unter tests/component/__screenshots__/vr-p28a-admin-security.png erfasst
  • Spec/ENTITY-MODEL an Davids UI-Entscheidungen angepasst
  • REQUIREMENTS/ROADMAP nachgezogen
  • Plane-Ticket VR-P28a für den Code-Review vorbereitet

Umsetzungs-Notiz

2026-07-24 · 6/6 DoD = 100 % done

  • Authentik-gebundene, tenant-lose AdminIdentity, eigene gehashte 8h-AdminSession, AdminRBAC/Sales-Permissions, letzter-Superadmin-Schutz, Reason-Audit und begrenzte Tenant-Impersonation: 6c9acd9e9
  • Erreichbare Interim-UI, reine View-Models, Sidebar-/Permission-Gates, i18n, Route-/Component-/Visual-/E2E-Proofs: 30685cc2e
  • Proofs: pnpm typecheck, pnpm lint, pnpm test (1.030 Testdateien, 7.380 Tests bestanden), pnpm build, RLS-Live-Integration (45/45), Component-/Visual-Test (2/2), Admin-Identity-Browser-Smoke (1/1), i18n-, Sidebar-, Boundary-, Tenant-Policy-, Cross-Cutting-, A11y-, Hot-Swap-, Source-Health- und CI-Baseline-Verifier grün.
  • Entsprechend dem gemeinsamen P28-Protokoll wurde im Feature-Block ausschließlich prisma db push verwendet. Die gemeinsame forward-only P28-Merge-Migration mit Inverse-SQL entsteht nach Abschluss aller Admin-Sales-Schemas.