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

204 lines
27 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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
- [x] **Host-Routing `admin.hivegrid.de`** (NICHT `/admin`-Pfad!) + **Cookie-Domain-Trennung** App↔Admin
- [x] **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
- [x] **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).
- [x] **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
- [x] **User-Verwaltung** (2FA-Reset/Session-Revoke), **Feature-Flag-UI** (zur Engine aus P1)
- [x] **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).
- [x] **`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
- [x] 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)*
- [x] **Trial-Verlängerung** je Tenant (1–365 Tage, Reason + Audit, räumt past_due/frozen auf)
- [x] **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)
- [x] **Tenant-Detail-Wiring:** Konnektoren + Notizen + Trial produktiv im Tenant-Detail (`AdminTenantOperationsPanel`)
- [x] **Support-Ticket-Detail:** `/admin/support/:id` mit Thread, Reply, interner Notiz, Status, Zuweisung
- [x] **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).