Files

4.3 KiB
Raw Permalink Blame History

Designer-Brief · P28 — Plattform-Admin-Tiefe

Phase: 28/34 · Module: M37/M32 (M038/M039/M033/M040) · Owner-Dev: Raffael (VR-P28a) + Akeshan (VA-P28b) · Designer: David (D-Admin-Tiefe) Quellen: ROADMAP-V2.md §v2-P8 · ROADMAP.md §Phase 28 · _bmad-output/specs/M37-plattform-admin.md (Block A–D) · _bmad-output/specs/M32-feature-flags.md (Massen-Statistik) 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. v1 lieferte die Auflagen-Brücke (M034: Host-Routing/Cookie-Trennung/TOTP); P28 löst sie durch die echte getrennte Identität/RBAC 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 AdminRBAC (Default-Rollen super_admin/support/sales/engineering/viewer), 2FA-Pflicht, 8h-Session, Self-Permission-Schutz und cross-tenant AdminAuditLog mit Reason-Pflicht. Dazu die Feature-Flag-Massen-Statistik (effektive Auswertung über alle Tenants, Live-Filter-Vorschau, Bulk-Override) und eine interne Lead-Pipeline für HiveGrid-eigene Verkäufe.

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
Interne Lead-Pipeline [/leads] HiveGrid-eigene Verkäufe: Lead-/Deal-Liste + Detail, Quelle/source_detail, Stage 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
  • Interne Lead-Pipeline für HiveGrid-eigene Verkäufe

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-/Deal-Pipeline-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/PHASE-SOURCES nachgezogen:
  • Plane-Ticket (VR-P28a / VA-P28b) aktualisiert: