Files
HiveGrid-Wireframes/hivegrid-cloud/.planning/ticket-docs/VD-P28.md
T

58 lines
5.0 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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: