Files
HiveGrid-Wireframes/03 Quellen und Referenzen/hivegrid-cloud/.planning/ticket-docs/D-ADMIN.md
T
2026-07-08 16:15:37 +02:00

7.4 KiB

D-ADMIN · Plattform-Admin-Compose

Typ Screen (Design)
Owner David
Phase P19 — Plattform-Admin (bedient AK-P19)
Cycle/Fenster W2 — Plattform & CRM (Demo 1) · 2026-06-26 → fällig 2026-06-26
Status geplant

🟩 Compose-Ticket: deckt alle Admin-Screens (P19). Compose aus A2/A3/A4/A5/A6 + KPI/Charts — aber eigene Admin-Shell (nicht App-Shell A1): getrennte Sidebar/Topbar auf admin.hivegrid.de. Interner Polish reicht (kein 🌐-Niveau).

🟡 v1-Schnitt (verbindlich): Getrennte AdminUser-Identität / AdminRBAC-Parallelwelt (M038/M039) → v2 (v1 = Boilerplate-User-Extension + admin-mfa-gate). Keine AdminUser-/AdminRole-Verwaltungs-Screens, keine Plattform-Lead-Pipeline/Deal-Kanban, keine Feature-Flag-Massen-Statistik, kein KWP-Sync-Status-Screen in v1; Churn/ARPU → v2. Neu v1: Admin stellt Tenant-Abos zusammen (Feature-Konnektoren togglen + Legacy-Provider-Positionen — Abo-Baukasten-Mechanik).

Abhängigkeiten & Parallelität

  • Blocked by: D-D0b (Archetypen — Reuse der Bausteine; die Admin-Sidebar/-Topbar werden hier aber getrennt neu komponiert, kein A1-Reuse)
  • Blockt: —
  • Bedient (Dev): AK-P19 (M37 Plattform-Admin + M32 Feature-Flag-UI)
  • Subframe: Pflicht je Route. Eigene Admin-Shell; Archetypen-Reuse A2/A3/A4/A5/A6 + KPI/Charts.

Was wir bauen

Die getrennte Plattform-Admin-Welt auf admin.hivegrid.de: Admin-Login + 2FA, Admin-Dashboard (Basis-KPIs), Tenant-Management inkl. Abo-Zusammenstellung, User-/Subscription-Verwaltung, Feature-Flags, Health/Worker-Queues, Support-Inbox, Admin-Audit und Subprozessoren/AVV.

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 + Legacy-Provider-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, Legacy-Provider-Sync · Detail: Legacy-Provider-Customer/Sub-ID (Link), Plan + Positionen + MRR, Trial, Rechnungs-History, manuelle Override (Plan/Sonderpreis/Reason), Legacy-Provider-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.)

Features (muss abgedeckt sein)

  • Admin meldet sich auf admin.hivegrid.de an (Host-Routing, Cookie-Domain-Trennung, TOTP-Pflicht + MFA-Step-up); Admin-User ohne Tenant-Workspace; kein Generalschlüssel
  • Admin verwaltet Tenants/Subscription-Overrides/Feature-Flags; Abo-Zusammenstellung = Feature-Konnektoren togglen + Legacy-Provider-Positionen (Abo-Baukasten)
  • Admin-Dashboard: Boilerplate-KPIs (Tenants/User/MRR) + System-Health + Queue-Status
  • BullMQ-Queue-Monitoring (Retry/Pause/Resume, Job-Detail mit Error-Stack) + Support-Inbox
  • AdminAuditLog (tenant_id=null) über Audit-Hash-Kette; sensitive Aktionen (Status-Wechsel/Impersonate/Subscription-Override) mit Reason-Pflicht + Klartext-Bestätigung
  • Impersonate → temporäre Tenant-User-Session (max. 30 Min) mit Klartext-Banner im Tenant + Reason-Spur
  • Eigene getrennte Admin-Shell (Sidebar Dashboard/Tenants/Users/Subscriptions/Feature-Flags/Health/Audit/Support/Legal/Settings) — kein App-Sidebar-Reuse

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 + Legacy-Provider-Positionsliste mit Preisen); Trial-Verlängerungs-Datum-Picker; Markdown-Notizen-Editor mit Pin + Kategorie; Impersonate-Button mit Begründungs-Modal; Legacy-Provider-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).

Quellen (granular)

  • designer-briefs/P19-plattform-admin.md (vollständiger Brief — alle Admin-Screens, diese Doc ist sein Ticket-Destillat)
  • ENTITY-MODEL.md → Domäne 11 (Plattform-Admin) + Domäne 12 (Abo-Baukasten, für Abo-Zusammenstellung)
  • SCREEN-MAP.md → §3 Plattform-Admin · ROADMAP.md → Phase 19 · _bmad-output/specs/M37-plattform-admin.md, M32-feature-flags.md

Davids Delta (David füllt aus)

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