27 KiB
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 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).
R-LEADS-Nachzug 2026-07-16:
R-LEADSkonsumiert ausschließlich die bereits grünen Verträge Host-Routing/Admin-Shell, Admin-Auth undrecordAdminAction()/AuditEvent. Die in AK-P19 noch offenen Billing-, Support- und Queue-DoD blockieren M040a nicht. R-LEADS besitzt sein eigenesadminLeads.prismaund 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 deaktiviertenhelp-desk-Plugin-Baum nach/admin/supportverlegt (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/auditcross-tenant + Gate- 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-/Entitlement-Mechanik (Billing-Domäne 12): Admin schaltet
SubscriptionFeature-Konnektoren je Tenant; Plan/Seats/Billing-/Payment-State wird nachBILL-02bisBILL-06ueber 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-featuresROADMAP.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-P19aktualisiert
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-gateStep-up. - DoD #7
AdminAuditLogwird 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.prismaenthaelt 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 bestehendesSupportTicketstatt Duplikat). Minimale Back-Relations.prisma validate+generategruen.db pushsteht 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) uebercreateAuditEvent. 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.tstoggelt Feature-Konnektoren je Tenant ueberTenantFeatureOverride(enabled/disabled/inherit), invalidiert dentenantHasModule-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:TypedQueueist 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 demSupportTicketMessage-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/listAdminTenantNotemit 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.tslegt nurUser+AdminUseran, keinen Tenant, keineTenantUser-Mitgliedschaft, keindefaultTenantId. Damit hat ein Admin keinen Workspace und taucht in keiner Mitgliederliste auf. TOTP/MFA laeuft ueber Authentik +admin-mfa-gateStep-up (bestehend). Verifiziert per Code-Read + bestehendejit-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 ohnetenantId-Param alle AuditEvent-Zeilen inkl. dertenantId=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_MSwar 60 Min -> auf 30 Min gesetzt;validateImpersonationSessionStateliefert danachstale_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 pusherfolgreich gegen eine frische pgvector-Postgres (Docker, da compose kein Postgres mitbringt): das gesamte Schema inkl.admin.prismasynct sauber. Verifiziert perpsql: TabellenAdminTenantNote,SupportTicketMessage+ SpalteSupportTicket.assignedToUserIdvorhanden. Damit AD-21 (Feature-Branch =db push, Migration erst beim Merge) erfuellt. Befehl:prisma db push --url <direct-url>(Prisma 7 kennt kein--skip-generatemehr).- 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 ohneADMIN_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/newmit 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/:idmit 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-ADMINin 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,EmptyStateund Form-Controls. Die Admin-Shell bleibt allein in der Route-Hierarchie; keinDefaultPageLayout, keine rekursive Sidebar. - Impersonation verlangt jetzt im echten
Dialogeinen Operator-Grund mit mindestens 10 Zeichen. Der Server erzwingt dieselbe Mindestlänge und schreibt den Klartext-Grund inImpersonationAuditundAuditEvent; 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-06ist vollständig umgesetzt und produktiv über/accounts/billingverdrahtet. 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:
extendTenantTrialinbilling-admin.server.ts(1–365 Tage, nie rückwärts, räumt past_due/frozen, Audittenant.trialExtended);AdminTenantOperationsPanel(Interim,~/ui) bindet Trial +subscription-assembly+tenant-notesproduktiv inaccounts/$id.tsx; Anlage-Route/admin/accounts/new(AdminTenantCreatePage) mit Branche/Typ, Owner-Einladung, optional Plan/Seats/Trial, Reason + Audittenant.created. - DoD #6: Support-Baum von den deaktivierten
help-desk-Plugin-Routen nachadmin/support/verlegt (Overview/Tickets/Feedback) + neues Ticket-Detailadmin/support/$id.tsx(AdminSupportTicketPage): Thread (Erstnachricht als Inbound), Reply, interne Notiz, Status, Zuweisung an AdminUser — alles über den auditiertensupport-inbox.server.supportals kanonischer Admin-Slug inPublicRouteSegments.tsregistriert (sonst stiller 404 durch HostRouting); Sidebar-Eintragui.nav.admin.helpDesk→/support. Queue-Job-Detail:QueueInspector.getJobDetail+ BullMQ-stacktrace[]/Timeline im echtenDialog(?detailQueue&detailJob). - RLS: Tenant-Detail-Reads/-Writes laufen im gebundenen
runWithRlsContext({tenantId})(Test$id.rls-context.test.tserweitert); 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).