5.4 KiB
5.4 KiB
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-Routingadmin.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. Eigeneprisma/schema/admin.prisma(AD-21), getrennte Welt, KEINtenant_idauf Admin-Tabellen. Koordination nur am gemeinsamen AdminAuditLog. - Konflikt-Risiko: gering — gemeinsamer AdminAuditLog (Owner = Raffael, Akeshan dockt an); berührt
core.prismanur 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 mitapp.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— KEINtenant_id, getrennte Welt, AD-21):AdminUser([v2]:email,password_hash,totp_secret(Pflicht),status),AdminRole/AdminPermission/AdminSession([v2]: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). - 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) — HauptquelleROADMAP.md→ Phase 28PHASE-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 FundamentENTITY-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-P28aaktualisiert