Files
HiveGrid-Wireframes/03 Quellen und Referenzen/hivegrid-cloud/.planning/ticket-docs/AK-P19.md
T

27 KiB
Raw Blame History

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

⚠️ Billing-Recut 2026-07-04 (AD-27): Die frueheren Legacy-Provider-Positionen in diesem Ticket sind abgeloest. Plattform-Admin-Billing zielt jetzt auf HiveGrid-Entitlements + Lago-Billing-State + Mollie-Payment-State. Offene Legacy-Provider-spezifische Admin-Arbeit wandert in den BILL-*-Recut und darf nicht als neue Legacy-Provider-Implementierung fortgefuehrt werden.

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

🎨 design-nachzug: offen (seit 2026-07-12) — Interim-UI aus ~/ui steht für Billing, Jobs, Health und Support; finale Subframe-Optik aus D-ADMIN ausstehend.

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-/Entitlement-Mechanik wird hier angelegt), BILL-06 (interne Admin-Billing-Basis), 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).

R-LEADS-Nachzug 2026-07-16: R-LEADS konsumiert ausschließlich die bereits grünen Verträge Host-Routing/Admin-Shell, Admin-Auth und recordAdminAction()/AuditEvent. Die in AK-P19 noch offenen Billing-, Support- und Queue-DoD blockieren M040a nicht. R-LEADS besitzt sein eigenes adminLeads.prisma und erweitert den AK-P19-Scope nicht rückwirkend.

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-/Entitlement-Zusammenstellung je Tenant (Feature-Konnektoren togglen, Plan/Seats/Billing-State nach BILL-*), 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/User/Aktivität); Detail: Status-Wechsler (Reason), Abo-/Entitlement-Zusammenstellung (Konnektoren + Plan/Seats/Billing-State), 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/Seats/Status/Lago-Sync/Mollie-Payment-State; manuelle Override (Plan/Seats/Sonderfall/Reason), Sync forcieren, Refund-Verweis
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) — Authentik-SSO + JIT legt nur User+AdminUser an (kein Tenant), MFA via Authentik+Step-up
  • Tenant-Verwaltung + Abo-/Entitlement-Zusammenstellung (Konnektoren togglen + Plan/Seats/Billing-State nach BILL-*) + Trial-Verlängerung + Notizen — 2026-07-20 geschlossen: Trial-Verlängerung (1–365 Tage, nie rückwärts, räumt past_due/frozen auf), Konnektoren + Notizen produktiv im Tenant-Detail verdrahtet, vollständige Anlage-Route /admin/accounts/new (auf Raffaels Owner-Einladungs-Flow aufgesetzt). Bewusst außen vor: Demo-Daten-Häkchen (braucht AK-DEMO1-Seeder), Größe-Feld (kein Modell-Feld, wäre CR).
  • Impersonate (temporäre Tenant-User-Session max. 30 Min) mit Klartext-Banner im Tenant + Reason-Pflicht — Cap 30 Min + Banner + MFA-Gate + Operator-Reason-Dialog fertig; derselbe Klartext-Grund wird in beide Audit-Pfade geschrieben
  • 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 — 2026-07-20 geschlossen: Job-Detail-Dialog mit vollem BullMQ-stacktrace + Timeline; Support aus dem deaktivierten help-desk-Plugin-Baum nach /admin/support verlegt (Overview/Tickets/Feedback) + Ticket-Detail mit Thread/Reply/interner Notiz/Status/Zuweisung über den auditierten Service. Offen bleibt nur der Staging-Redis-Betriebsproof (Restliste B, extern).
  • AdminAuditLog (tenant_id=null, Hash-Kette); sensitive Aktionen mit Reason-Pflicht + Confirm-Phrase — via AuditEvent-Querschnitt (tenantId=null/actorType=admin) + /admin/audit cross-tenant + Gate
  • 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-/Entitlement-Mechanik (Billing-Domäne 12): Admin schaltet SubscriptionFeature-Konnektoren je Tenant; Plan/Seats/Billing-/Payment-State wird nach BILL-02 bis BILL-06 ueber Lago/Mollie/HiveGrid synchronisiert. tenantHasModule() prueft Feature im lokalen Entitlement-State.
  • 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 · Milestones: (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)

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

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

Interim-UI (Vorschau, Stand 2026-07-12): Vier app-chrome-freie Screens aus ~/ui gebaut — apps/web/app/components/screens/admin/AdminBillingPage.tsx, AdminJobsPage.tsx, AdminHealthPage.tsx und AdminSupportInboxPage.tsx. Proof: gezielte Route-/VM-/Impersonation-/Visual-Tests 39/39, Interim-Visual-Snapshot apps/web/app/components/screens/admin/__snapshots__/ak-p19-interim.visual.test.tsx.snap und Admin-E2E-Smoke tests/e2e/admin-p19-interim-smoke.spec.ts. Refactor-Nachzug offen: finale Subframe-Optik aus D-ADMIN (Plane-Label design-nachzug).

Umsetzungs-Notiz

2026-06-25 — Backend-Fundament (Branch feat/AK-P19)

Vorab-Entscheidungen (mit User abgestimmt):

  • Admin-Login = Authentik-SSO (juengere, in Prod laufende Infra-Entscheidung: AK-INFRA2, AGENTS.md STANDARDS §5/AD-3). Der aeltere Brief-Text „Email+Passwort+TOTP" gilt damit nicht; DoD #2 = TOTP/MFA via Authentik + admin-mfa-gate Step-up.
  • DoD #7 AdminAuditLog wird NICHT als eigenes Modell gebaut, sondern ueber die bestehende AuditEvent-Querschnitt-Huelle (tenantId=null, actorType=admin, Hash-Kette aus AK-P3). Grund: AGENTS.md verbietet Querschnitt-Nachbau; AuditEvent unterstuetzt tenantId=null bereits. admin.prisma enthaelt daher kein Audit-Modell.

Ist-Bestand (Boilerplate, verifiziert — zaehlt auf DoD): Host-Routing admin.hivegrid.de + Cookie-Trennung (DoD #1 ✅), eigene Admin-Shell/Sidebar (DoD #8 ✅), User-Ops + Feature-Flag-UI (DoD #5 ✅ weitgehend), Impersonate gewired mit MFA-Gate + Audit (DoD #4 teilweise).

Diese Session gebaut + verifiziert:

  • prisma/schema/admin.prisma — AdminTenantNote (Domaene 11) + SupportTicketMessage (Konversation/interne Notiz, erweitert bestehendes SupportTicket statt Duplikat). Minimale Back-Relations. prisma validate + generate gruen. db push steht noch aus (braucht laufende Dev-DB), Migration erst beim Merge (AD-21).
  • apps/web/app/services/admin/admin-action-audit.server.ts — Operator-Action-Audit-Gate (DoD #7): Reason-Pflicht + Confirm-Phrase + Emit als AuditEvent (tenantId=null/actorType=admin) ueber createAuditEvent. Unit-Test 10/10.
  • packages/view-models/src/admin/tenant-note-list.vm.ts — reiner Notizen-VM (DoD #3, pinned-first, i18n-Keys, Empty-State). Unit-Test 6/6.

Proof: web-Typecheck Exit 0, view-models-Typecheck clean, verify:i18n Exit 0, Tests 16/16. Commits 6cf7a55b4 (Schema), e562b2752 (Audit-Gate + VM). Nicht gepusht, kein Status-Wechsel.

%-DoD-Stand: rund 40 % (3 von 8 voll gruen: #1/#5/#8; #7 ~70 % = Gate gebaut, offen Viewer-Cross-Tenant + Verdrahtung an Aktionen; #3 ~30 % = Notizen-VM/Audit, offen Abo-Baukasten/Trial/Service).

Selbst machbar offen (Backend, ohne David): Abo-Baukasten-Mechanik (Konnektoren je Tenant + Plan/Seats/Billing-State nach BILL-*), Queue-Monitor (BullMQ), Support-Inbox-Service (auf SupportTicketMessage + bestehendem @hivegrid/db/support-tickets.server), AdminTenantNote-Service (CRUD), Impersonate-Haertung (30-Min-Cap/Banner), Admin-ohne-Tenant-Workspace-Haertung, Audit-Viewer Cross-Tenant-Erweiterung + Call-Site-Verdrahtung, db push. Extern blockiert: finale Subframe-UI aller Screens (Davids D-ADMIN/D-P19-Delta noch leer).

2026-06-25 (Forts.) — Backend-Slices Abo-Baukasten / Queue / Support / Notizen

Zusaetzlich gebaut + verifiziert:

  • Abo-Baukasten-Mechanik (DoD #3, Grundlage AK-P20): services/admin/subscription-assembly.server.ts toggelt Feature-Konnektoren je Tenant ueber TenantFeatureOverride (enabled/disabled/inherit), invalidiert den tenantHasModule-Cache und auditet reason-gegated. Reuse des Entitlement-Resolvers, kein Parallel-Store. + subscription-connectors.vm.ts (effektiver Zustand aus Blueprint-Default + Override).
  • Queue-Monitor (DoD #6 Teil A): services/admin/queue-monitor.server.ts — QueueInspector-Port + Snapshot-Aggregation + audited Pause/Resume/Retry; BullMQ-Adapter ueber @hivegrid/queue (Redis-Runtime auf Staging zu verifizieren). + queue-monitor.vm.ts (Counts -> Klartext-Health ok/warn/paused, Worst-of-Overall). Hinweis: TypedQueue ist enqueue-only, Read/Control via strukturellem Cast.
  • Support-Inbox (DoD #6 Teil B): services/admin/support-inbox.server.ts — Reply / interne Notiz / Status / Assignee auf dem SupportTicketMessage-Thread, validiert + auditiert. + support-conversation.vm.ts (Thread oldest-first, reply/internalNote/inbound).
  • Tenant-Notes (DoD #3): services/admin/tenant-notes.server.ts — create/delete/list AdminTenantNote mit Kategorie-Normalisierung + Audit.

Proof: web-Typecheck 0 Fehler (grep error TS = 0; Achtung: gepipte Typechecks maskieren tsc-Exit, daher gegen Inhalt geprueft), view-models-Typecheck clean, verify:i18n Exit 0, Admin-Tests 52/52 in 9 Dateien. Commits 0bb9e29ad (Abo-Baukasten+Queue), 116aee518 (Queue-BullMQ-Cast-Fix), c9dedcafe (Support+Notizen). Nicht gepusht, kein Status-Wechsel.

%-DoD-Stand jetzt: rund 60 %. Voll gruen: #1/#5/#8 (Boilerplate, verifiziert). Backend-fertig (UI = David): #6 (Queue+Support), #3-Teile (Abo-Baukasten + Notizen). #7 ~80 % (Gate gebaut + an Abo/Queue/Support-Aktionen verdrahtet; offen: Audit-Viewer Cross-Tenant + Impersonate/Status-Call-Sites).

Noch offen, selbst machbar: Audit-Viewer Cross-Tenant-Erweiterung, Impersonate-Haertung (30-Min/Banner) + Reason-Verdrahtung, Admin-ohne-Tenant-Workspace-Haertung (DoD #2), Trial-Verlaengerung + manuelle Tenant-Anlage, Billing-Recut-Adminbasis aus BILL-06, db push (Dev-DB) + VM-Unit-Tests laufen, Smoke-/Visual-Tests nach Davids UI. Extern blockiert: finale Subframe-Screens (David).

2026-06-25 (Forts. 2) — DoD #2 / #4 / #7 verifiziert bzw. geschlossen

Drei Punkte gegen den realen Code geprueft statt neu gebaut:

  • DoD #2 (Admin ohne Tenant-Workspace) = erfuellt. Der Admin-Login ist Authentik-SSO; modules/admin-sso/jit-provisioning.server.ts legt nur User + AdminUser an, keinen Tenant, keine TenantUser-Mitgliedschaft, kein defaultTenantId. Damit hat ein Admin keinen Workspace und taucht in keiner Mitgliederliste auf. TOTP/MFA laeuft ueber Authentik + admin-mfa-gate Step-up (bestehend). Verifiziert per Code-Read + bestehende jit-provisioning.server.test.ts (Fake-Client hat gar kein tenant-Modell).
  • DoD #7 (AdminAuditLog cross-tenant + Viewer) = erfuellt. Der /admin/audit-Viewer (AK-P3) liest ohne tenantId-Param alle AuditEvent-Zeilen inkl. der tenantId=null/actorType=admin-Operator-Aktionen, filterbar nach Actor/Tenant. Mein Gate schreibt genau dorthin; Reason + Confirm-Phrase liegen im Gate. Kein Viewer-Umbau noetig.
  • DoD #4 (Impersonate max. 30 Min) = geschlossen. IMPERSONATION_SESSION_TTL_MS war 60 Min -> auf 30 Min gesetzt; validateImpersonationSessionState liefert danach stale_started_at. Banner (rootData) + MFA-Step-up bestehen. Test: 29 Min gueltig / 31 Min stale. Offen nur das Operator-Reason-Modal auf der neuen Tenant-Detail-Impersonate-Aktion (Davids UI).

Commit feat(AK-P19): cap operator impersonation at 30 minutes. web-Typecheck 0 Fehler, session-Impersonation-Tests 16/16.

%-DoD-Stand jetzt: rund 70 %. Voll gruen: #1, #2, #4 (bis auf Reason-Modal=David), #5, #7, #8. Backend-fertig (UI=David): #6 (Queue+Support), #3 (Abo-Baukasten+Notizen). Rest #3: Trial-Verlaengerung + manuelle Tenant-Anlage + Billing-Recut-Adminbasis aus BILL-06 + db push.

2026-06-26 — prisma db push + DB-Integrationstest (real-DB-Verifikation)

  • db push erfolgreich gegen eine frische pgvector-Postgres (Docker, da compose kein Postgres mitbringt): das gesamte Schema inkl. admin.prisma synct sauber. Verifiziert per psql: Tabellen AdminTenantNote, SupportTicketMessage + Spalte SupportTicket.assignedToUserId vorhanden. Damit AD-21 (Feature-Branch = db push, Migration erst beim Merge) erfuellt. Befehl: prisma db push --url <direct-url> (Prisma 7 kennt kein --skip-generate mehr).
  • DB-Integrationstest admin-services.integration.test.ts: faehrt den echten Service-Code (tenant-notes, subscription-assembly, support-inbox) ueber einen echten Prisma-Client (createDbClient({connectionString})) gegen die gepushte DB — faengt Query-/Schema-Mismatches, die die Fake-Unit-Tests nicht sehen. 3/3 gruen mit DB, auto-skip ohne ADMIN_IT_DATABASE_URL (CI bleibt gruen). web-Typecheck 0 Fehler.

Commits test(AK-P19): DB-backed integration test, test(AK-P19): extend ... support-inbox thread. Damit ist der selbst-machbare Backend-Teil gegen eine echte DB verifiziert; db push aus der offenen DoD-Restliste erledigt. Es fehlt selbst-machbar nur noch: Trial-Verlaengerung + manuelle Tenant-Anlage + Billing-Recut-Adminbasis (BILL-06, Lago/Mollie/HiveGrid-gekoppelt) und Davids finale UI.

Noch zu erledigen (Stand 2026-07-20, 8/8 DoD dev-seitig)

A — Selbst machbar in AK-P19: (alle fünf Punkte am 2026-07-20 geschlossen, siehe Umsetzungs-Notiz unten)

  • Trial-Verlängerung je Tenant (1–365 Tage, Reason + Audit, räumt past_due/frozen auf)
  • Manuelle Tenant-Anlage vervollständigt: eigene Route /admin/accounts/new mit Branche/Typ, Owner-Einladung, optional Plan/Seats + Trial, Reason/Audit (Demo-Daten-Häkchen wartet auf AK-DEMO1-Seeder; Größe-Feld = CR)
  • Tenant-Detail-Wiring: Konnektoren + Notizen + Trial produktiv im Tenant-Detail (AdminTenantOperationsPanel)
  • Support-Ticket-Detail: /admin/support/:id mit Thread, Reply, interner Notiz, Status, Zuweisung
  • BullMQ-Job-Detail: Dialog mit vollem stacktrace (alle Versuche) + Timeline

B — Betrieb/Runtime:

  • BullMQ-Queue-Monitor-Adapter gegen echtes Redis auf Staging verifizieren und den Proof dokumentieren. Unit-Logik, Route und UI-Aktionen sind getestet.

C — Getrackter Design-Nachzug, nicht Done-blockierend (AD-28):

  • Finale Subframe-Optik aus D-ADMIN/D-P19 übernehmen und die oben aufgeführten Dev-Nachzüge aktualisieren. Die vorhandenen Interim-Screens, Impersonation-Reason-Dialoge sowie Smoke-/Hot-Swap-/Visual-Proofs bleiben bis dahin die Baseline.

Fertig und im Code produktiv verdrahtet: admin.prisma (db push ok), Operator-Audit-Gate, BILL-06-Billing-State inklusive Plan-/Seat-Override und Lago-/Mollie-Sync, Queue-Übersicht mit Retry/Pause/Resume, Support-Übersicht, Impersonation-Reason und 30-Minuten-Cap. DoD #1/#2/#4/#5/#7/#8 sind grün.

2026-07-12 — AD-28 Interim-UI + Impersonation-Reason

Umgesetzt:

  • Subframe-MCP geprüft: kein P19-/Plattform-Admin-Flow vorhanden; D-ADMIN in Plane weiter Backlog. Deshalb AD-28-Interim-Screens nach den bestehenden Automations-/Forms-Patterns gebaut.
  • Billing, Queue/Jobs, Health und Support-Übersicht rendern aus bestehenden Loader-/View-Models über ~/ui-StatsCard, Card, Table, BadgeFeedback, BannerAlert, EmptyState und Form-Controls. Die Admin-Shell bleibt allein in der Route-Hierarchie; kein DefaultPageLayout, keine rekursive Sidebar.
  • Impersonation verlangt jetzt im echten Dialog einen Operator-Grund mit mindestens 10 Zeichen. Der Server erzwingt dieselbe Mindestlänge und schreibt den Klartext-Grund in ImpersonationAudit und AuditEvent; MFA-Step-up, 30-Minuten-Cap und Tenant-Banner bleiben unverändert.

Proof: pnpm --filter @hivegrid/web typecheck Exit 0; repo-weites pnpm lint Exit 0; gezielte Route-/VM-/Impersonation-/Visual-Tests 39/39; verify:i18n, test:hot-swap, verify:ui-visual, verify:sidebar-routes, verify:source-health und verify:ci-baseline Exit 0. Der repo-weite pnpm test-Preflight hing auf Windows nach 10 Minuten am bekannten execvpe(/bin/bash) failed-Umgebungsfehler; deshalb gemäß AGENTS.md gezielte Vitest-Läufe.

%-DoD-Stand: AK-P19: 6/8 DoD = 75 % done. Voll grün: #1, #2, #4, #5, #7, #8. Teilweise/offen und daher nicht gezählt: #3 (Trial-Verlängerung + vollständige manuelle Tenant-Anlage + Tenant-Detail-Interim-Screen) und #6 (Support-Ticket-Detail/Reply-UI; BullMQ-Live-Adapter auf Staging). Selbst machbar offen: die genannten UI-/Action-Wirings. Extern blockiert: nur finale D-ADMIN-Optik, die dank Interim-UI als design-nachzug getrackt und nicht als eigener Backend-Blocker gewertet wird.

2026-07-13 — Ist-Code-Audit und Doc-Drift-Nachzug

Den nach PR #95 auf main gemergten Code erneut gegen die beiden offenen DoD-Punkte geprüft:

  • DoD #3: BILL-06 ist vollständig umgesetzt und produktiv über /accounts/billing verdrahtet. Plan-/Seat-Override, Lago-/Mollie-Sync, Billing-State und Interim-UI sind daher nicht mehr offen. Die einfache Tenant-Anlage existiert bereits, erfüllt aber nicht die vollständige AK-P19-Feld-/Reason-/Trial-/Demo-Spezifikation. Entitlement-Konnektoren und Tenant-Notizen besitzen getestete Services, jedoch noch kein produktives Tenant-Detail-Wiring. Eine Trial-Verlängerungsaktion existiert nicht.
  • DoD #6: Queue Pause/Resume/Retry sind einschließlich Route, CSRF, Permission, Audit und Interim-UI produktiv verdrahtet. Offen bleiben der BullMQ-Stacktrace im Job-Detail und der Staging-Redis-Proof. Die Support-Übersicht ist produktiv; Reply, interne Notiz, Status und Zuweisung existieren nur als getesteter Service und werden von keiner Produktionsroute aufgerufen.
  • Historische Umsetzungsnotizen oben bleiben als damalige Zeitstände erhalten; die DoD-Kommentare und die führende Restliste wurden auf den aktuellen Code-Stand korrigiert.

Proof: Code-Read auf main (6d352d050), Produktionsimport-Suche für subscription-assembly.server.ts, tenant-notes.server.ts und support-inbox.server.ts, Route-/Action-Abgleich für Billing, Jobs, Tenant-Anlage und Help-Desk. Nur diese Ticket-Doc geändert.

%-DoD-Stand: AK-P19: 6/8 DoD = 75 % done. Offen bleiben #3 und #6 mit den oben konkretisierten Restarbeiten; der finale Subframe-Nachzug ist nach AD-28 nicht Done-blockierend.

2026-07-20 — Stand-Audit + Restarbeiten (Branch fix/ak-p19-audit-restwork)

Audit-Befund (wichtig): Der Plane-Kommentar vom 2026-07-16 („dev-seitig 8 von 8, 312 Admin-Tests grün") beschreibt Arbeit, die nie im Repo angekommen ist — kein Commit nach dem 13.07. auf main oder irgendeinem Origin-Branch enthielt Trial-Verlängerung, /accounts/new, Tenant-Detail-Wiring, Support-Detail oder Job-Stacktrace (git log --all --grep AK-P19, Artefakt-Suche). Die Session hat vermutlich nie gepusht; ein lokaler Stand existiert laut Owner nicht mehr. Die Restarbeiten wurden deshalb neu gebaut, der 16.07.-Kommentar diente als Spec. Nebenbefund: Raffaels e8838dc0c (15.07., ohne AK-Ticket) hatte die Tenant-Anlage bereits um Owner-E-Mail-Einladung (ownerless Reservations) erweitert — die neue Anlage-Route setzt darauf auf statt zu duplizieren.

Umgesetzt (Commits f490a5556, 740caf849, f1f0ad372, c978a4e47, ba5c221e5):

  • DoD #3: extendTenantTrial in billing-admin.server.ts (1–365 Tage, nie rückwärts, räumt past_due/frozen, Audit tenant.trialExtended); AdminTenantOperationsPanel (Interim, ~/ui) bindet Trial + subscription-assembly + tenant-notes produktiv in accounts/$id.tsx; Anlage-Route /admin/accounts/new (AdminTenantCreatePage) mit Branche/Typ, Owner-Einladung, optional Plan/Seats/Trial, Reason + Audit tenant.created.
  • DoD #6: Support-Baum von den deaktivierten help-desk-Plugin-Routen nach admin/support/ verlegt (Overview/Tickets/Feedback) + neues Ticket-Detail admin/support/$id.tsx (AdminSupportTicketPage): Thread (Erstnachricht als Inbound), Reply, interne Notiz, Status, Zuweisung an AdminUser — alles über den auditierten support-inbox.server. support als kanonischer Admin-Slug in PublicRouteSegments.ts registriert (sonst stiller 404 durch HostRouting); Sidebar-Eintrag ui.nav.admin.helpDesk → /support. Queue-Job-Detail: QueueInspector.getJobDetail + BullMQ-stacktrace[]/Timeline im echten Dialog (?detailQueue&detailJob).
  • RLS: Tenant-Detail-Reads/-Writes laufen im gebundenen runWithRlsContext({tenantId}) (Test $id.rls-context.test.ts erweitert); Cross-Tenant-Support-Reads über den Operator-Zweig wie die bestehenden Admin-Listen.

Proof: web-Typecheck Exit 0 · verify:i18n/verify:sidebar-routes/verify:cross-cutting-models/verify:ui-visual/test:hot-swap Exit 0 · Admin-Test-Sweep 135/135 (3 DB-Integrationstests auto-skip ohne ADMIN_IT_DATABASE_URL) · Interim-Visual-Baseline re-baselined + um die drei neuen Screens erweitert · E2E-Smoke auf /support + /accounts/new umgestellt. Kein Schema-Change, keine neue Permission, keine Migration nötig.

Sichtbar unter (lokal pnpm dev:local, http://admin.localhost:3000): /accounts/<id> (Trial/Konnektoren/Notizen), /accounts/new, /support + /support/<ticketId>, /jobs (Details-Button an fehlgeschlagenen Jobs). Screens: apps/web/app/components/screens/admin/AdminTenantOperationsPanel.tsx, AdminTenantCreatePage.tsx, AdminSupportTicketPage.tsx.

%-DoD-Stand: AK-P19: 8/8 DoD = 100 % dev-seitig. Offen (nicht dev-blockierend): Staging-Redis-Betriebsproof für den Queue-Adapter (Restliste B, nach Deploy) und der getrackte design-nachzug (AD-28).

Nachzug 2026-07-20 (Browser-Review, Commit 9626e09f5): Die „Tage"-Box der Trial-Verlängerung hatte drei Defekte in der Subframe-NumberInput-Komponente bzw. deren Nutzung: (a) fixe h-9-Root-Höhe trotz Label → Input lief unter die Karte; (b) Grid-Spalten (140/160px) schmaler als die fixe 192px-Komponente → Nachbarfeld überdeckte die Stepper (betraf auch Billing-Seats + Tenant-Anlage); (c) Stepper-Chevrons waren app-weit reine Deko → klicken jetzt stepUp()/stepDown(). Zusätzlich fängt die Tenant-Ops-Action unerwartete Fehler als Klartext-Banner statt 500-Seite. Lokaler Betriebs-Befund dabei entdeckt: Der AuditChainHead der lokalen Dev-DB (chainKey platform) verifiziert nicht gegen das aktuelle AUDIT_CHAIN_SECRET → jede Operator-Aktion (Trial, Konnektoren, Notizen, Billing-Override, Queue-Pause) scheitert lokal am Audit-Writer. Kein Code-Bug; Reparatur = Chain-Head mit aktuellem Secret neu signieren oder lokale DB frisch aufsetzen. Staging/Prod nicht betroffen (dort ist das Secret konsistent zur DB).