204 lines
27 KiB
Markdown
204 lines
27 KiB
Markdown
# 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).
|