Files
HiveGrid-Wireframes/03 Quellen und Referenzen/hivegrid-cloud/.planning/ticket-docs/VD-P28.md
T

5.2 KiB
Raw Blame History

VD-P28 · Screens P28 — Admin-Tiefe (Plattform-Admin)

Typ Screen (Design)
Owner David
Phase P28 — Plattform-Admin-Tiefe (v2-P8) · bedient R-LEADS/VR-P28a/VA-P28b
Cycle/Fenster v2-W3 — Admin/Help/Dashboard/v2-Launch · 2026-07-27 → fällig 2026-07-31
Status geplant (NEU — Phasen-Ticket)

♻️ Löst Sammel-Ticket auf: Dieses Phasen-Ticket ersetzt — zusammen mit VD-P22 und VD-P32 — das alte Sammel-Ticket VD-5 („Public-API-Keys + Admin-Tiefe + KWP-Setup"). VD-P28 = der Admin-Tiefe-Anteil. 🔴 Hardgrenze Admin-Welt: Sub-Domain admin.hivegrid.de, nicht unter /{tenant}/… erreichbar. Eigene AdminUser-Klasse, eigene Cookies (SameSite=Strict), kein BYPASSRLS. Interner Polish (Admin-Welt), nicht extern sichtbar.

Abhängigkeiten & Parallelität

  • Blocked by: D0-Baseline (D-D0a App-Shell, D-D0b Archetypen A2/A3/A5/A6 + Live-Preview) — Admin-Welt komponiert aus den D0-Archetypen, aber auf eigener Sub-Domain/Identität
  • Bedient (Dev): R-LEADS (finaler Design-Nachzug für M040a Intake/AdminLead-Inbox; Interim-UI blockiert nicht), VR-P28a (AdminUser-Welt + AdminRBAC, M038/039, 27.–29.07.), VA-P28b (Flag-Massen-Statistik M033 + M040b Deal-Ausbau, 29.–31.07.)
  • Läuft parallel zu: VD-P29 (Help), VD-P30 (Dashboard), VD-P31 (DSGVO) — v2-W3
  • Subframe: Pflicht je Route (A2, A3, A5, A6 + Live-Preview-Variante)

Was wir bauen

Die Plattform-Admin-Tiefe als getrennte Identitäts-/Rechte-Schicht für uns als 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
Plattform-Lead-Inbox [/leads, /leads/:id, /leads/sources] M040a: Liste/Detail, Quelle, Status, Assignment, Activity/Notizen und Source-Verwaltung; finalisiert die R-LEADS-Interim-UI A2 + A3 + 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

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
  • Plattform-Lead-Inbox M040a und Deal-Pipeline M040b für HiveGrid-eigene Verkäufe klar getrennt abgedeckt

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).

Quellen (granular)

  • designer-briefs/P28-plattform-admin-tiefe.md (vollständiger Brief — diese Doc ist sein Ticket-Destillat)
  • ENTITY-MODEL.md → Domäne 11: Plattform-Admin (M37) — eigene Welt, KEIN tenant_id + AdminUser (v2)
  • Plane-Snapshot: ersetzt Teil von VD-5; bedient R-LEADS als Design-Nachzug sowie VR-P28a/VA-P28b (v2-W3, 27.–31.07.)

Davids Delta (David füllt aus)

  • Überschriebene/geänderte Spec-Punkte:
  • Neue UI/UX-Entscheidungen:
  • Subframe-Screen-Link(s):
  • Offene Fragen an Dev: