4.6 KiB
Designer-Brief · P28 — Plattform-Admin-Tiefe
Phase: 28/34 · Module: M37/M32 (M038/M039/M033/M040a/b) · Owner-Dev: Raffael (R-LEADS, VR-P28a, VA-P28b) · Designer: David (D-Admin-Tiefe)
Aktive Quellen: zugehörige Ticket-Docs · ROADMAP.md/ROADMAP-V2.md · REQUIREMENTS.md · ENTITY-MODEL.md.
Subframe: Pflicht je Route. Interner Polish (Admin-Welt), nicht extern sichtbar.
🔴 Hardgrenze Admin-Welt: Läuft auf Sub-Domain
admin.hivegrid.de, nicht unter/{tenant}/...erreichbar. EigeneAdminUser-Klasse parallel zuUser/TenantUser, eigene Cookies (SameSite=Strict), kein Cross-Routing. Kein BYPASSRLS — der Admin liest Tenant-Daten via RLS mit gesetztemapp.tenant_id. Authentik ist der einzige produktive Admin-Login und liefert die MFA-Assurance; P28 löst die v1-User-/UserSession-Brücke vollständig ab.
Was dieses Modul tut (Kurzfassung)
Macht die Plattform-Admin-Welt zur vollwertigen, getrennten Identitäts- und Rechte-Schicht für uns als Software-Betreiber: eigene AdminUser-Konten mit Authentik-MFA-Assurance und AdminRBAC (Default-Rollen super_admin/support/sales/engineering/viewer), 8h-Session, Self-Permission-Schutz und cross-tenant AdminAuditLog mit Reason-Pflicht. Dazu die Feature-Flag-Massen-Statistik und die interne Vertriebswelt in zwei klaren Ebenen: M040a als native Plattform-Lead-Inbox/Source-Verwaltung (R-LEADS) und M040b als Deal-Kanban/Forecast/Promotion (VA-P28b).
Benötigte Screens
| Screen [Route] | Kern-Inhalt | Archetyp |
|---|---|---|
AdminUser-Verwaltung [admin.hivegrid.de/admin-users] |
Liste AdminUser, Status, Rolle, letzte Aktivität; Anlegen durch super_admin | A2 |
AdminUser-Detail [/admin-users/:id] |
Rollen-Zuweisung, Sessions, Audit-Trail, Self-Permission-Schutz | A3 |
AdminRole-Editor [/admin-users/roles] |
Permission-Bundles je Rolle, Default-Rollen, Bundle-Zuweisung | A6 |
Admin-Security-Settings [/settings/security] |
Aktive Sessions + individueller Revoke, 2FA-Pflicht, 8h-Session-Policy | A6 |
Feature-Flag Effektiv-Statistik [/feature-flags] |
Pro Flag: X aktiv / Y nicht aktiv über alle Tenants, deterministische Auswertung (Override > Filter > Default) | A2 |
Filter-Editor (Live-Match) [/feature-flags/:key] |
Filter-Regeln definieren, Live-Vorschau der getroffenen Tenants (Read-Replica) | A6 + Live-Preview |
Bulk-Override [/feature-flags/:key/bulk] |
Massen-Setzen von Overrides auf gefilterte Tenant-Menge, mit Audit | A5 |
Plattform-Lead-Inbox [/leads, /leads/:id] |
M040a: Lead-Liste/-Detail, Quelle, Status, Assignment, Activity/Notizen, Archiv | A2 + A3 |
Lead-Quellen [/leads/sources] |
M040a: Source-Status, Default-Assignee/Empfänger, Credential erstellen/rotieren/revoken | A2 + A6 |
Deal-Pipeline [/leads/pipeline, /deals/:id] |
M040b: Deal-Kanban, Stage, Forecast/ARR, Promote-to-Tenant | A2 + A3 |
Cross-Tenant-Audit-View [/audit] |
AdminAuditLog über alle Tenants, Reason-Pflicht-Einträge, Impersonate-Records, Filter | A2 |
Geplante Features (muss abgedeckt sein)
- Eigene
AdminUser-Klasse hart getrennt (eigene Cookies SameSite=Strict, kein Cross-Routing, kein BYPASSRLS) - AdminRBAC mit eigenen Bundles + Default-Rollen (super_admin/support/sales/engineering/viewer), 2FA-Pflicht, 8h-Session, Self-Permission-Schutz
- AdminAuditLog cross-tenant mit Reason-Pflicht bei sensitiven Aktionen; Impersonate mit Reason + Banner
- Flag-Massen-Statistik: Effektiv-Auswertung (X aktiv/Y nicht), Live-Filter-Vorschau (Read-Replica), Bulk-Override
- Deterministische Flag-Auswertung (Override > Filter > Default) + Audit
- M040a Plattform-Lead-Inbox/Quellen und M040b Deal-Pipeline visuell klar getrennt
Benötigte UI-Elemente (Liste, KEIN Layout — Anordnung = Davids freie Hand)
Daten-Tabelle (sortierbar, paginiert), Rollen-/Permission-Bundle-Matrix, Session-Liste mit Revoke-Button, 2FA-Status-Badge, Reason-Pflicht-Dialog (Begründung erzwungen), Impersonate-Warn-Banner, Flag-Effektiv-Statistik-Kachel (aktiv/inaktiv-Zähler), Filter-Regel-Editor mit Live-Match-Vorschau-Liste, Bulk-Override-Bestätigung mit betroffener-Tenant-Anzahl, Audit-Timeline (Actor/Reason/Ziel), Lead-Inbox/-Detail/-Source-Verwaltung, getrennte Deal-Kanban-Ansicht, Empty-/Loading-/Permission-Denied-States (Klartext).
Davids Delta (David füllt aus)
- Überschriebene/geänderte Spec-Punkte:
- Neue UI/UX-Entscheidungen:
- Subframe-Screen-Link(s):
- Offene Fragen an Dev:
Dev-Nachzug (wir nach Davids Delta)
- Spec/ENTITY-MODEL an Davids Entscheidungen angepasst:
- REQUIREMENTS/ROADMAP nachgezogen:
- Plane-Ticket (
R-LEADS/VR-P28a/VA-P28b) aktualisiert: