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-Routingadmin.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) undVR-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-P28bnur in dessen unabhängigem M033-Anteil. Eigeneprisma/schema/admin.prisma(AD-21), getrennte Welt, KEINtenant_idauf Admin-Tabellen. - Konflikt-Risiko: gering — gemeinsamer AdminAuditLog (Owner = Raffael, Akeshan dockt an); berührt
core.prismanur für die Ablösung der v1-User-Extension.
M040a-/Sales-Kompatibilitätsvertrag (2026-07-24):
R-LEADSdarf vor diesem Ticket gegen die bestehende AdminUser/User-Brücke bauen. Beim Wechsel auf die getrennte AdminUser-Welt müssenassignedToAdminUserId, 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-P28cbisVA-P28i. Der vonVR-P28abereitgestellte 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 mitapp.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— KEINtenant_id, getrennte Welt, AD-21):AdminUser(email, Authentik-Subject, Status und Assurance-Metadaten, keine produktiven lokalen Credentials),AdminRole/AdminPermission/AdminSession(namesuper_admin/support/sales/…,permission_id,expires_at(8h),ip),AdminAuditLog(admin_user_id,action_type,target_kind/id,summary_text,metadataDiff — cross-tenant, tenant_id=null, über Audit-Hash-Kette aus AK-P3). - Authentifizierung: Authentik-OIDC wird serverseitig validiert und an eine eigene
AdminSessiongebunden. Der lokale Credential-Fallback bleibt ausschließlich unter den fail-closed Dev-Guards ausAGENTS.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.*undadmin_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) — HauptquelleROADMAP.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/rolesund/settings/securityproduktiv verdrahtet - Interim-Visual-Baseline unter
tests/component/__screenshots__/vr-p28a-admin-security.pngerfasst - Spec/ENTITY-MODEL an Davids UI-Entscheidungen angepasst
- REQUIREMENTS/ROADMAP nachgezogen
- Plane-Ticket
VR-P28afü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 pushverwendet. Die gemeinsame forward-only P28-Merge-Migration mit Inverse-SQL entsteht nach Abschluss aller Admin-Sales-Schemas.