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 Hostadmin.hivegrid.de, kein Schema-Konflikt. Eigeneprisma/schema/admin.prisma(AD-21); getrennte Welt, KEINtenant_idauf den Admin-Tabellen. - Konflikt-Risiko: keines auf Schema-Ebene; berührt
core.prismanur 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— KEINtenant_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-featuresROADMAP.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-P19aktualisiert