58 lines
5.0 KiB
Markdown
58 lines
5.0 KiB
Markdown
# VD-P28 · Screens P28 — Admin-Tiefe (Plattform-Admin)
|
||
|
||
| | |
|
||
|---|---|
|
||
| **Typ** | Screen (Design) |
|
||
| **Owner** | David |
|
||
| **Phase** | P28 — Plattform-Admin-Tiefe (v2-P8) · bedient `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):** `VR-P28a` (AdminUser-Welt + AdminRBAC, M038/039, 27.–29.07.), `VA-P28b` (Flag-Massen-Statistik M033 + interne Lead-Pipeline, 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 |
|
||
| 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 |
|
||
|
||
## 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
|
||
|
||
## 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).
|
||
|
||
## 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)
|
||
- `ROADMAP-V2.md` §v2-P8 (Screens/Features = Hauptquelle) · `ROADMAP.md` §Phase 28 · `_bmad-output/specs/M37-plattform-admin.md` (Block A–D) · `_bmad-output/specs/M32-feature-flags.md`
|
||
- Plane-Snapshot: ersetzt Teil von `VD-5`; bedient `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:
|