Files
HiveGrid-Wireframes/hivegrid-cloud/.planning/ticket-docs/AK-P19.md
T

6.8 KiB

AK-P19 · P19 Plattform-Admin (admin.hivegrid.de)

Typ Dev (Code)
Owner Akeshan
Phase P19 — Plattform-Admin
Cycle/Fenster W2 — Plattform & CRM (Demo 1) · fällig 2026-06-24 · Gate W2
Status geplant

Abhängigkeiten & Parallelität

  • Blocked by: R-P2b (RLS + RBAC + User-Lifecycle — Admin nutzt Boilerplate-User-Modell als Extension), AK-P3 (Querschnitt: Audit-Hash-Kette für AdminAuditLog)
  • Blocks: AK-P20 (Abo-Baukasten-Mechanik wird hier angelegt), AK-DEMO1 (Demo-Tenant via Admin)
  • Läuft parallel zu: Raffaels R-P6 (CRM-Kern). Maximal isoliert — Admin-Welt vs. CRM-Domäne, eigener Host admin.hivegrid.de, kein Schema-Konflikt. Eigene prisma/schema/admin.prisma (AD-21); getrennte Welt, KEIN tenant_id auf den Admin-Tabellen.
  • Konflikt-Risiko: keines auf Schema-Ebene; berührt core.prisma nur für User-Extension (admin-mfa-gate).

Was wir bauen

Die getrennte Plattform-Admin-Welt auf admin.hivegrid.de (Host-Routing, NICHT /admin-Pfad): eigene Admin-Shell (getrennte Sidebar/Topbar), Cookie-Domain-Trennung zu app.hivegrid.de, TOTP-Pflicht + MFA-Step-up. Admin-User haben keinen Tenant-Workspace und erscheinen in keiner Mitgliederliste (Boilerplate-Default-Provisionierung abschalten). Funktionen: Tenant-Verwaltung (Stammdaten, Status-Wechsel mit Reason-Pflicht, Notizen, Impersonate mit Begründung max. 30 Min + Banner), Abo-Zusammenstellung je Tenant (Feature-Konnektoren togglen + Stripe-Positionen = Abo-Baukasten-Mechanik), User-Verwaltung (2FA-Reset/Session-Revoke), Feature-Flag-Verwaltung (UI zur Engine aus P1), Queue-/Health-Monitoring (BullMQ Retry/Pause/Resume), Support-Inbox (speist sich aus P21-Feedback-Widget) und der AdminAuditLog (cross-tenant, tenant_id=null). v1-Cut: getrennte AdminUser-Identität/AdminRBAC (M038/M039) → v2; Plattform-Lead-Pipeline → v2; Flag-Massen-Statistik → v2; Churn/ARPU → v2.

Benötigte Screens (Backend bedient — Design liefert D-ADMIN + D-P19; eigene Admin-Shell)

Screen [Route] Kern-Inhalt
Admin-Login + 2FA [admin.hivegrid.de/login, /2fa] Email+Passwort (NIST/HIBP, Captcha ab 3. Fehler), TOTP-Pflicht, kein Magic-Link, 8h-Session
Admin-Dashboard [/dashboard] Basis-KPIs Tenants/aktive User/MRR + System-Health-Ampel + Queue-Status, Drill-Down (Churn/ARPU → v2)
Tenant-Liste + Detail [/tenants, /:id] Liste (Status/Plan/MRR/User/Aktivität); Detail: Status-Wechsler (Reason), Abo-Zusammenstellung (Konnektoren + Stripe-Positionen), Trial-Verlängerung, Notizen, Impersonate mit Begründung, User-/Activity-/Audit-/Flag-Sektionen
Manuelle Tenant-Anlage [/tenants/new] Name, Slug (Live-Validation), Branche/Größe, Initial-Admin-Email, Module/Plan, Trial, Demo-Daten-Häkchen, Reason
User-Liste + Detail [/users, /:id] Memberships/2FA/Sessions; Ops (2FA-Reset mit Reason, Session-Revoke, Deaktivieren, Lösch im Auftrag)
Subscription-Liste + Detail [/subscriptions, /:id] Plan/MRR/Status/Stripe-Sync; manuelle Override (Plan/Sonderpreis/Reason), Stripe-Sync forcieren, Refund
Feature-Flags [/feature-flags] Flag-Liste + Targeting-Filter (plan-tier) + Tenant-Override mit Ablauf (Massen-Statistik → v2)
Health + Worker-Queues [/health, /health/workers] Service-Ampeln, DB/Redis/Storage; BullMQ-Queues Active/Waiting/Delayed/Failed, Job-Detail + Retry/Pause/Resume
Support-Inbox + Detail [/support, /:id] Liste + Konversation + Markdown-Reply + interne Notiz; speist sich aus Feedback-Widget (P21)
Admin-Audit [/audit] Cross-Tenant-AdminAuditLog + Tenant-Audit-Read, Filter, Diff-Drawer, Export (read-only)
Subprozessoren + AVV [/legal/subprocessors, /legal/avv] Subprozessor-Liste; AVV-Versionen + akzeptierende/ausstehende Tenants

Definition of Done

  • Host-Routing admin.hivegrid.de (NICHT /admin-Pfad!) + Cookie-Domain-Trennung App↔Admin
  • TOTP-Pflicht hart erzwungen; Admin ohne Tenant-Workspace (Default-Provisionierung abgeschaltet, in keiner Mitgliederliste)
  • Tenant-Verwaltung + Abo-Zusammenstellung (Konnektoren togglen + Stripe-Positionen) + Trial-Verlängerung + Notizen
  • Impersonate (temporäre Tenant-User-Session max. 30 Min) mit Klartext-Banner im Tenant + Reason-Pflicht
  • User-Verwaltung (2FA-Reset/Session-Revoke), Feature-Flag-UI (zur Engine aus P1)
  • Queue-Monitor (BullMQ Retry/Pause/Resume, Job-Detail mit Error-Stack) + Support-Inbox
  • AdminAuditLog (tenant_id=null, Hash-Kette); sensitive Aktionen mit Reason-Pflicht + Confirm-Phrase
  • Eigene getrennte Admin-Shell (kein Reuse der App-Sidebar)

Technische Bausteine

  • Entities (eigene prisma/schema/admin.prisma — KEIN tenant_id, getrennte Welt): AdminAuditLog (admin_user_id, action_type, target_kind/id, summary_text, metadata Diff — cross-tenant), AdminTenantNote (tenant_id, note_text, category, pinned), AdminSupportTicket (+ Message — source_kind in_app_feedback_widget/inbound_email, tenant_id, status, priority). v1-Cut: AdminUser/AdminRole/AdminSession (M038/M039) → v2; v1 = Boilerplate-User-Extension + admin-mfa-gate.server.ts. AdminLead/AdminDeal → v2.
  • Abo-Baukasten-Mechanik (Billing-Domäne 12): Admin schaltet SubscriptionFeature-Konnektoren je Tenant + Stripe-Positionen — Grundlage für AK-P20 (Self-Service-UI dort → v2). tenantHasModule() prüft Feature im Abo.
  • Host-Routing + Cookie-Domain-Trennung (Boilerplate routet /admin-Pfad → auf Host umstellen); TOTP-Pflicht + MFA-Step-up-Gate.
  • Impersonate generiert temporäre Tenant-Session (max 30 Min) mit Banner + Audit-Spur; kein BYPASSRLS.
  • AdminAuditLog über die Audit-Hash-Kette (AK-P3); Reason-Pflicht bei Status-Wechsel/Impersonate/Override.

Quellen (granular)

  • ENTITY-MODEL.md → Domäne 11: Plattform-Admin (eigene Welt, kein tenant_id; AdminAuditLog/TenantNote/SupportTicket v1, AdminUser/Role/Session = v2) + Domäne 12 (Abo-Baukasten für Abo-Zusammenstellung)
  • REQUIREMENTS.md → REQ-plattform-admin-identität (AdminUser-Identität/RBAC → v2), REQ-plattform-admin-features
  • ROADMAP.md → Phase 19 · PHASE-SOURCES.md → Phase 19 (M031/M032 Flag-UI, M034-auth bindende Auflagen, M035 gedünnt, M036-mandanten, M037-impersonate, M041-health/audit/support; M038/M039/M033/M040 → v2)
  • designer-briefs/P19-plattform-admin.md (eigene Admin-Shell, Abo-Baukasten-Panel, Impersonate, v1-Cuts)
  • _bmad-output/specs/M37-plattform-admin.md, M32-feature-flags.md

Dev-Nachzug (nach Davids D-ADMIN/D-P19-Delta)

  • Spec/ENTITY-MODEL an Davids UI-Entscheidungen angepasst
  • REQUIREMENTS/PHASE-SOURCES nachgezogen
  • Plane-Ticket AK-P19 aktualisiert