7.9 KiB
Designer-Brief · P19 — Plattform-Admin
Phase: 19/21 · Modul: M37 (+ M32 Feature-Flag-UI) · Owner-Dev: Akeshan (AK-P19) · Designer: David
Quellen: ROADMAP.md §Phase 19 · ENTITY-MODEL.md Domäne 11 (Plattform-Admin) + Domäne 12 (Abo-Baukasten, für Abo-Zusammenstellung) · SCREEN-MAP.md §3 (Plattform-Admin-Block) · _bmad-output/specs/M37-plattform-admin.md, M32-feature-flags.md (Admin-UI-Teile)
Subframe: Pflicht je Route. Eigene Admin-Shell (nicht App-Shell A1) — getrennte Sidebar/Topbar auf admin.hivegrid.de; interner Polish reicht (kein 🌐-Niveau). Archetypen-Reuse: A2 Liste, A3 Detail, A4 Form, A5 Modal, A6 Settings, KPI/Charts.
🟡 Getrennte Welt — eigene Shell, kein App-Reuse der Sidebar. Läuft auf
admin.hivegrid.demit Host-Routing, Cookie-Domain-Trennung zu app.hivegrid.de, TOTP-Pflicht + MFA-Step-up. v1-Schnitt (verbindlich): Die getrennte AdminUser-Identität / AdminRBAC-Parallelwelt (M038/M039) ist v2 — v1 nutzt das Boilerplate-User-Modell als Extension +admin-mfa-gate. Es gibt keine AdminUser-/AdminRole-Verwaltungs-Screens in v1, keine Plattform-Lead-Pipeline/Deal-Kanban (unser eigenes Sales-Tool → v2), keine Feature-Flag-Massen-Statistik (→ v2). Admin-Dashboard zeigt Basis-KPIs (Tenants/User/MRR), Churn/ARPU → v2. Neu v1: Admin stellt Tenant-Abos zusammen (Feature-Konnektoren togglen + Stripe-Positionen — Abo-Baukasten-Mechanik; Self-Service-UI dafür → v2). KWP-Sync-Status-Screen entfällt v1 (KWP ist erstes v2-Modul).
Was dieses Modul tut (Kurzfassung)
Die Plattform ist aus einer getrennten Admin-Welt betreibbar: Tenant-Management (Stammdaten, Status-Wechsel, Notizen, Impersonate mit Begründung), Abo-Zusammenstellung je Tenant (Feature-Konnektoren + Stripe-Positionen + Trial-Verlängerung), User-Verwaltung (2FA-Reset, Session-Revoke), Feature-Flag-Verwaltung (UI zur Engine aus Phase 1), Queue-/Health-Monitoring und eine Support-Inbox, die sich aus dem Feedback-Widget (P21) speist. Alle Admin-Aktionen laufen ins AdminAuditLog (cross-tenant, tenant_id=null).
Benötigte Screens
| Screen [Route] | Kern-Inhalt | Archetyp |
|---|---|---|
Admin-Login + 2FA [admin.hivegrid.de/login, /2fa] |
Email + Passwort (NIST/HIBP, Captcha ab 3. Fehler), TOTP-Pflicht, kein Magic-Link, 8h-Session | A4 / A5 |
Admin-Dashboard [/dashboard] |
Basis-KPIs: Tenants, aktive User, MRR + System-Health-Ampel + Queue-Status · Klick je Kachel → Drill-Down · Zeitraum-Wechsler (Churn/ARPU/Sales-Pipeline → v2) | KPI |
Tenant-Liste [/tenants] |
Name, Slug, Status (Klartext-Farbe), Plan, MRR, User-Anzahl, letzte Aktivität, Branche/Größe · Filter + Suche + Bulk (Tag/Email) | A2 |
Tenant-Detail [/tenants/:id] |
Stammdaten, Status-Wechsler (Reason-Pflicht), Abo-Zusammenstellung (Feature-Konnektoren togglen + Stripe-Positionen — Abo-Baukasten!), Trial-Verlängerung (Datum + Reason), Notizen (Markdown, kategorisiert, gepinnt), User-/Activity-/Audit-/Feature-Flag-Sektionen, Impersonate mit Begründungs-Pflicht | A2 / A3 + A6 |
Manuelle Tenant-Anlage [/tenants/new] |
Name, Slug (Live-Validation), Branche, Größe, Initial-Admin-Email, Initial-Module/Plan, Trial-Dauer, Demo-Daten-Häkchen, Reason-Pflicht | A4 |
User-Liste + Detail [/users, /:id] |
Liste: Email, Name, Tenant-Memberships, 2FA-Status, letzte Aktivität, Status · Detail: Memberships mit Rolle, Sessions, letzte Logins, Ops (2FA-Reset mit Reason, Session-Revoke, Deaktivieren, Lösch im Auftrag) | A2 / A3 |
Subscription-Liste + Detail [/subscriptions, /:id] |
Liste: Tenant, Plan, MRR, Status, Renewal, Stripe-Sync · Detail: Stripe-Customer/Sub-ID (Link), Plan + Positionen + MRR, Trial, Rechnungs-History, manuelle Override (Plan/Sonderpreis/Reason), Stripe-Sync forcieren, Refund | A2 / A3 |
Feature-Flags [/feature-flags] |
Flag-Liste (Key, Status, Targeting), Filter-Editor (plan-tier), Tenant-Override mit Ablauf (Massen-Statistik → v2) | A2 + A6 |
Health + Worker-Queues [/health, /health/workers] |
Service-Ampeln (Web/API/Worker/Scheduler), DB/Redis/Storage · BullMQ-Queues: Active/Waiting/Delayed/Failed je Queue, Job-Detail mit Error-Stack, Retry (Bulk/einzeln), Pause/Resume · Error-Rate Top-10 | A2 + KPI |
Support-Inbox + Ticket-Detail [/support, /:id] |
Liste: Betreff, Tenant, Source, Status, Priorität, Zugewiesen · Detail: Konversation, Antwort (Markdown + Anhänge), interne Notiz, Status/Priority/Tag/Assignee-Wechsler, Reaktions-Templates · speist sich aus Feedback-Widget (P21)! | A2 / A3 |
Admin-Audit [/audit] |
Cross-Tenant-AdminAuditLog + aggregierter Tenant-Audit-Read · Filter (Akteur/Tenant/Action-Type/Zeitraum/Target), Volltext in Summary, Detail-Drawer mit Diff, Export (CSV/JSON) · read-only |
A2 + Drawer |
Subprozessoren + AVV [/legal/subprocessors, /legal/avv] |
Subprozessor-Liste (anlegen/edit/archiv, 14-Tage-Widerspruchs-Trigger) · AVV-Versionen (PDF-Vorlage, Aktiv-ab, akzeptierende/ausstehende Tenants, Re-Akzeptanz-Trigger) | A2 + A6 |
(Entfällt v1: AdminUser-/AdminRole-Verwaltung, Plattform-Lead-Inbox/Deal-Kanban, KWP-Sync-Status, Feature-Flag-Massen-Statistik — alles v2.)
Geplante Features (muss abgedeckt sein)
- Plattform-Admin meldet sich auf
admin.hivegrid.dean (Host-Routing, Cookie-Domain-Trennung, TOTP-Pflicht + MFA-Step-up); Admin-User haben keinen Tenant-Workspace und erscheinen in keiner Mitgliederliste; kein Generalschlüssel zwischen Plattform und Mandanten (getrennte AdminUser-Identität/AdminRBAC = M038/M039 → v2; v1 = Boilerplate-User-Extension +admin-mfa-gate) - Admin verwaltet Tenants, Subscription-Overrides und Feature-Flags aus zentraler Konsole; Abo-Zusammenstellung = Feature-Konnektoren togglen + Stripe-Positionen (Abo-Baukasten-Mechanik)
- Admin-Dashboard zeigt Boilerplate-KPIs (Tenants/User/MRR) + System-Health + Queue-Status (Churn/ARPU/Health-Kacheln → v2)
- Admin überwacht BullMQ-Queues (Retry/Pause/Resume, Job-Detail mit Error-Stack) und bearbeitet eine Support-Inbox
AdminAuditLogprotokolliert plattformweite Aktionen (tenant_id=null) über die Audit-Hash-Kette; sensitive Aktionen (Status-Wechsel, Impersonate, Subscription-Override) mit Reason-Pflicht + Klartext-Bestätigung- Impersonate generiert temporäre Tenant-User-Session (max. 30 Min) mit Klartext-Banner im Tenant + voller Reason-Spur
- Eigene getrennte Admin-Shell (Sidebar: Dashboard/Tenants/Users/Subscriptions/Feature-Flags/Health/Audit/Support/Legal/Settings) — kein Reuse der App-Sidebar
Benötigte UI-Elemente (Liste, KEIN Layout — Anordnung = Davids freie Hand)
Eigene Admin-Sidebar + -Topbar (getrennt von A1), KPI-Kacheln mit Drill-Down + Zeitraum-Wechsler, System-Health-Ampel, Daten-Tabelle (sortierbar, paginiert, Spalten-Konfig), Filter-Bar, Bulk-Action-Toolbar, Status-Wechsler mit Reason-Pflicht-Modal, Abo-Baukasten-Panel (Feature-Konnektor-Toggles + Stripe-Positionsliste mit Preisen), Trial-Verlängerungs-Datum-Picker, Markdown-Notizen-Editor mit Pin + Kategorie, Impersonate-Button mit Begründungs-Modal, Stripe-Link-Badge, manuelle-Override-Formular, Queue-Status-Tabelle mit Retry/Pause/Resume, Job-Detail-Drawer mit Error-Stack, Feature-Flag-Liste + Targeting-Filter-Editor + Tenant-Override-mit-Ablauf, Support-Konversations-Ansicht + Markdown-Reply + interne-Notiz-Toggle + Reaktions-Templates, Audit-Tabelle mit Diff-Drawer + Export, Subprozessor-Tabelle + AVV-Versions-Liste mit PDF-Upload, Bestätigungs-Dialoge (Confirm-Phrase für destruktive Aktionen), Empty-/Loading-/Fehler-/Permission-Denied-States (Klartext mit Lösungs-Knopf).
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 (AK-P19) aktualisiert: