# 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. Eigene `AdminUser`-Klasse parallel zu `User`/`TenantUser`, eigene Cookies (SameSite=Strict), kein Cross-Routing. **Kein BYPASSRLS** — der Admin liest Tenant-Daten via RLS mit gesetztem `app.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: