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

22 KiB

AK-P3 · P3 Querschnitts-Oberflächen (Audit/Notif/Sprache DE)

Typ Dev (Code)
Owner Akeshan
Phase P3 — Querschnitts-Oberflächen
Cycle/Fenster W2 — Plattform & CRM (Demo 1) · fällig 2026-06-21 · Gate W2 (Noah-Demo #1)
Status Done (Owner-Freigabe erteilt; Plane-Status Done, Stand-Audit 2026-07-17: 7/7 DoD code-verifiziert)

🎨 design-nachzug: offen (seit 2026-07-07) — Interim-UI aus ~/ui steht; finale Subframe-Optik aus D-P3 ausstehend.

Abhängigkeiten & Parallelität

  • Blocked by: R-P1b (Service-Kerne: Audit-Hash-Kette, notify(), i18n-Engine), R-P2b (RLS + Permissions für audit.read)
  • Blocks: — (liefert Bedien-Oberflächen, keine harten Downstream-Blocker)
  • Läuft parallel zu: Raffaels R-P5 (Apps-Engine) — Paar AK-P3 ‖ R-P5. Disjunkte Domänen (Querschnitts-UI vs. Apps-Engine), eigene prisma/schema/*.prisma → kein Schema-Konflikt (AD-21). Berührungspunkt nur Sidebar — additiv.
  • Konflikt-Risiko: gering — nur Sidebar-Einträge + Settings-Routen; db push auf Branch.

Was wir bauen

Die Bedien-Oberflächen der in P1 gebauten Plattformdienste: Audit-Viewer (gefilterter, permission-gegateter Trail mit deutschem Summary-Text, Actor-Kind-Marker, Diff-Detail-Drawer, NDJSON/CSV-Export ins Hetzner-Object-Storage mit Zweck-Pflichtfeld), Notification-Center (In-App via SSE, Read-Status, Deeplink, Tabs Alle/Ungelesen, Bulk-Clear) + Notification-Settings (Event-Typen je Modul, In-App/Email-Toggle, Master „alle Emails aus"), sowie die Sprach-Settings (v1 DE-only-Hinweis; alle Strings durch t(), verify:i18n grün).

Benötigte Screens (Backend bedient — Design liefert D-P3 aus D-D0a/D-D0b)

Routen-Notation (Stand 2026-07-07, host-aware): Die Route-Convention mountet routes/admin/* zusätzlich als Admin-Host-Alias ohne /admin-Präfix und app/:tenant/* auf dem App-Host ohne /app-Präfix. Kanonisch erreichbar sind die Flächen also unter admin.<domain>/audit bzw. <app>/<tenant>/notifications; die pfadbasierten Formen (/admin/audit, /app/:tenant/…) existieren weiterhin. Angegeben ist unten die kanonische URL + das Route-Modul.

Screen [Route] Kern-Inhalt Liefert (Design)
Audit-Viewer [Admin-Host /audit · Modul routes/admin/audit.tsx] Zeit/Actor (+Kind-Marker)/Aktion/Subjekt/DE-Summary · Filter (Zeitraum/Actor/Kategorie/Subjekt-Typ) · Diff-Detail-Drawer · Export-Button D-P3 (A2+Drawer)
Audit-Export [Admin-Host /audit-export · Modul routes/admin/audit-export.tsx] — v1 synchron statt Job-Liste (/admin/audit/exports* = v2, s. Vorab-Entscheidungen) Anlage (Filter, Format, Zweck-Pflichtfeld) · signed-URL-Download · CSV/PDF-Fallback D-P3 (A2)
Notification-Center [Topbar-Drawer + App-Host /:tenant/notifications · Modul routes/app.$tenant/notifications.tsx] Titel/Body/Actor/Zeit/Read-Status, Tabs Alle/Ungelesen, Bulk-Clear, Bounce-Klartext D-P3 (A2)
Notification-Settings [App-Host /:tenant/settings/notifications · Modul routes/app.$tenant/settings/notifications.tsx] Event-Typen je Modul, In-App/Email-Toggle + Priority, Master „alle Emails aus" D-P3 (A6)

Eingebettet (kein eigener Screen): Per-Subject-Audit-Drawer in jeder Detail-View, Per-User-Audit-Drawer in /admin/users/:id, DE-Sprach-Hinweis im Profil (P2). Davids P3-Screens werden über D-P3 (Compose aus D0) geliefert.

Definition of Done

  • Audit-Viewer permission-gegated (audit.read), server-seitige Filter, DE-Summary-Text, Actor-Kind-Marker — AP-1 (+ Interim-Screen AP-6)
  • Diff-Detail-Drawer (Feld-für-Feld Vorher/Nachher; Maskierung bei sensiblen Werten) — AP-6: beforeDiff/afterDiff/summaryText additiv an AuditEvent (Owner-Freigabe 2026-07-06), echter ~/ui-Drawer mit Feld-für-Feld-Diff, maskierte Felder als „Wert geändert"; abgeleitete Summary bleibt Fallback für Alt-Zeilen. Abgrenzung: flächige Diff-Befüllung (Auto-Audit-Middleware) + Hash-Chain-Bindung der Diffs bleiben R-P1b/Raffael (Vermerk in R-P1b.md).
  • NDJSON/CSV-Export ins Hetzner-Object-Storage + Zweck-Pflichtfeld + Export-Job-Status/Download; jeder Export selbst auditiert (audit.exported); fixe Default-Retention + Cron-Auto-Löschung — AP-2 (+ Interim-Screen AP-6)
  • Notification-Center (SSE, Read-Status, Deeplink, Tabs, Bulk-Clear, Bounce-Klartext) — AP-3 + AP-6: Topbar-Drawer (echter ~/ui-Drawer), Live-Unseen-Count via SSE, Deeplink-Kontrakt payloadMetadata.deeplink (validiert, app-relativ) als Interim-UI (AD-28) — nicht mehr David-blockiert.
  • Notification-Settings (Event-Typen je Modul, In-App/Email-Toggle, Master-Toggle) — AP-4 (+ Interim-Screen AP-6)
  • Sprach-Settings DE — alle Strings durch t(), vollständige de-Locale, verify:i18n grün (AP-5); Kontakt.language-Feld ergänzt (AP-6, entsperrt durch CRM-P6-Merge; nullable, kein v1-Editor, Vermerk in R-P6.md)
  • (→ v2) Quiet-Hours/Bündelung/Push-Kanal/Retention-Editor/Legal-Hold/Saved-Views/Sprach-Wechsler ausgeschlossen

Technische Bausteine

  • Keine neuen Kern-Entities — liest/bedient die in R-P1b angelegten AuditEntry/Notification/NotificationPreference. Neu nur AuditExportJob ist v2 → in v1 fixe Default-Retention statt Job-Editor (Boilerplate liefert Retention-Cron + PDF-Export). Eigene prisma/schema/*.prisma falls Felder ergänzt (AD-21).
  • RLS auf allen tenant-bezogenen Lese-Pfaden; audit.read-Permission-Gate (aus R-P2b RBAC).
  • Konnektor tenantHasModule() für die Admin-/Settings-Routen.
  • i18n = JSON-Files (keine Tabelle); verify:i18n-CI-Gate aus R-P1b bleibt unantastbar.
  • is_demo_data greift nicht (Querschnitt) — Export-Files in Object-Storage mit Retention-Cleanup.

Quellen (granular)

  • ENTITY-MODEL.md → Domäne 2: Querschnitt (AuditEntry, Notification, NotificationPreference, NotificationDevice; i18n = Felder, keine Tabelle)
  • REQUIREMENTS.md → REQ-audit-retention-export, REQ-audit-permissions, REQ-notification-versand-pipeline, REQ-i18n-outbound
  • ROADMAP.md → Phase 3 · Milestones: (M028/M115/M116/M151/M152; Service-Kerne → P1, Flag-Admin-UI → P19)
  • designer-briefs/P03-querschnitts-oberflaechen.md

Dev-Nachzug (nach Davids D-P3-Delta)

Interim-UI (Vorschau, Stand 2026-07-07): Alle vier Flächen aus ~/ui gebaut (AD-28) — apps/web/app/components/screens/audit/{AuditListPage,AuditExportPage}.tsx, apps/web/app/components/screens/notifications/{NotificationCenterPage,NotificationSettingsPage,NotificationsDrawer}.tsx. Proof: Smoke tests/e2e/{audit,notifications}.spec.ts, Hot-Swap-Adapter auditList/notificationCenter (packages/ui-app/src/adapters/*.hot-swap.test.ts) grün; Visual-Baseline deferred wie R-P2a/AK-P4b (keine Snapshot-Harness — Interim-Baseline wird beim David-Nachzug gezogen). Refactor-Nachzug offen: finale Subframe-Optik aus D-P3 (Plane-Label design-nachzug).

  • Interim-UI aus ~/ui gebaut (AD-28, 2026-07-07) — VM als Prop, kein handgeschriebenes Tailwind für Spacing/Höhen
  • Audit-/Notif-Oberflächen an Davids finaler D-P3-Optik angepasst (Subframe-Swap hinter der stabilen VM/Loader-Grenze; design-nachzug: offen). Nicht Done-blockierend (AD-28). Beim Swap: Interim-Visual-Baseline neu ziehen.
  • Admin-Topbar-Drawer: der SSE-Stream ist tenant-scoped (app.$tenant/notifications/stream), die Admin-Topbar behält den Link — Drawer für Admin erst mit einem admin-scoped Stream (Nachzug, nicht DoD-relevant).
  • Requirements nachgezogen (2026-07-17: 4 Phase-3-REQs auf Done mit v1-Scope-Vermerk in REQUIREMENTS.md)
  • Plane-Ticket AK-P3 aktualisiert (2026-07-07: Abschluss-Kommentar + Label design-nachzug gesetzt; Branch gepusht. Status-Wechsel macht der Owner.)

Vorab-Entscheidungen (Owner-bestätigt 2026-06-24, /planning = SSoT)

  • Audit-Export v1 = synchron (Zweck-Pflichtfeld + Object-Storage + signed-URL + audit.exported + Retention-Cron). AuditExportJob-Entity + /admin/audit/exports-Job-Liste = v2 (Technische-Bausteine schlagen die Screen-Tabelle).
  • Permission-Key: bestehende admin.auditTrails.view (Admin) / app.settings.auditTrails.view (Tenant) wiederverwenden. DoD-Wortlaut audit.read ist damit der Alias auf admin.auditTrails.view (kein Key-Duplikat).

Umsetzungsstand (Claude/Akeshan) — Branch feat/AK-P3

AP-1 · Audit-Viewer /admin/audit — 2026-06-24

Gebaut (Commit 2bee1ecaa):

  • packages/db/src/audit-events-query.server.ts — listAuditEvents (paginiert, server-seitige Filter, neueste zuerst, nutzt vorhandene Indizes) + Subpath-Export.
  • packages/view-models/src/audit/audit-list.vm.ts — reiner Builder mit Actor-Kind-Marker (deriveAuditActorKind) + abgeleiteter DE-Summary (deriveAuditSummaryKey → i18n-Key + Params). VM-Unit-Test 5/5.
  • apps/web/app/routes/admin/audit.tsx — Route auf AuditEvent (nicht Legacy Log), gegated admin.auditTrails.view; Filter Zeitraum/Actor/Aktion/Subjekt-Typ/Ergebnis; Detail-Disclosure rendert die (write-time sanitisierte) metadata mit Maskierung; Pagination.
  • Reachability: AdminSidebar-Eintrag + UI-Registry-ID adminAudit, Permission-gegated; i18n-Keys audit.* in settings.json (de+en) + app.sidebar.audit (translations.json de+en).

DoD-Stand nach AP-1:

  • DoD 1 (Viewer permission-gegated, server-Filter, DE-Summary, Actor-Kind-Marker): done.
  • DoD 2 (Diff-Detail-Drawer): teilweise — Metadata-Disclosure + Maskierung erledigt; strukturiertes Feld-für-Feld Vorher/Nachher blockiert (AuditEvent ohne before/after_diff-Spalten → Coordination-Item mit R-P1b/Raffael, AD-21 core.prisma; siehe Plan §5.2). Persistente summary_text ebenso (LOCKED ENTITY-MODEL vs. reale Tabelle).
  • DoD 3-6: offen (AP-2..AP-5). DoD 7 (v2-Ausschlüsse): erfüllt (nicht gebaut).
  • %-Done: ~1,5 / 7 DoD ≈ 21 % · selbst machbar offen: AP-2..AP-5 + Querschnitt/Tests · blockiert: strukturierter Diff/persist. Summary (R-P1b), Davids D-P3-Screens, Kontakt.language (P6+).

Proof: view-models + db + web Typecheck grün · verify:i18n Exit 0 · VM-Test 5/5 · pre-commit-Hooks (eslint-baseline/lint-staged/secrets) grün · Node 22.15 (Typecheck/i18n unkritisch).

AP-2 · Audit-Export ins Object-Storage — 2026-06-24

Gebaut (Commit 8b65a9135):

  • apps/web/app/utils/audit/auditExportStorage.server.ts — runAuditExportToStorage: baut CSV/NDJSON, lädt via putBufferAsFile nach audit-exports/<scope>/..., gibt kurzlebige signed-URL zurück, schreibt audit.exported mit Zweck (Pflicht). Typisierte Fehler (kein Zweck / kein Storage).
  • audit-export.helpers.server.ts — renderAuditExportNdjson (+ Test 2/2).
  • apps/web/app/routes/admin/audit-export.tsx — Zweck-Pflichtfeld + Format-Select (CSV/NDJSON) + POST-Action mit Ergebnis-/Fehler-Panel; bestehender Direkt-CSV/PDF-Stream bleibt als Fallback. i18n auditExport.storage.* (de+en).

DoD-Stand nach AP-2:

  • DoD 3 (Export ins Object-Storage + Zweck + audit.exported + NDJSON/CSV + Retention-Cron): done.
  • Retention-Cron nachgezogen (Commit 5b463c2dd): registerAuditRetentionCron + Konstanten in audit-retention.ts (+2 Tests), Scheduler+Worker im Worker-general-Group (apps/worker/src/index.ts), nightly 03:30 UTC. Compliance-sicher: pro Tenant werden die regulatorischen Scopes (soc2/hipaa/gdpr) aufgelöst → Policy kürzt nie unter die geforderte Aufbewahrung (SOC2/HIPAA 7 J, GDPR 6 J, sonst 365 T). Lösch-Lauf selbst auditiert (audit.retention.pruned). Runtime-Verifikation auf Staging (Redis+DB) wie bei plugin-audit-retention; lokal via Typecheck + Unit-Tests grün.
  • Hinweis (kein App-Code möglich): Auto-Löschung der Export-Files im Object-Storage = Bucket-Lifecycle-Regel auf audit-exports/ (Infra), da v1 keine AuditExportJob-Tracking-Tabelle hat (= v2) und der Storage-Adapter keine List-Operation bietet. Signed-URL-TTL = fixe Default-Retention.

Proof: web Typecheck 0 Fehler · verify:i18n Exit 0 · NDJSON-Test 2/2 · pre-commit-Hooks grün.

AP-3 · Notification-Center-Logik — 2026-06-25

Gebaut (Commit 5422c26d5):

  • packages/db/src/notifications.server.ts — markAllInAppNotificationDeliveriesRead (Bulk-Read, tenant/user-scoped, toleriert 0 Treffer, gibt Count zurück) + erweiterte updateMany-Typ-Union. 3 neue Unit-Tests (gesamt 29/29 grün).
  • apps/web/app/routes/app.$tenant/notifications.tsx — neue Route-Action mark-all-read (CSRF-validiert, ruft Bulk-Read).
  • apps/web/app/components/notifications/NotificationCenter.tsx — Tabs Alle/Ungelesen (Client-Filter auf status, mit Count je Tab), Bulk-Clear-Button (nur sichtbar bei ungelesenen), Bounce-Klartext via deriveBounceMessageKey (klassifiziert Provider-Fehler in stabile M002-i18n-Keys; roher redaktierter Text nur noch als sekundäres Detail).
  • i18n notifications.center.tabs/bulkClear/unreadEmpty/bounce.* (de+en vollständig).

DoD-Stand nach AP-3:

  • DoD 4 (Notification-Center): selbst machbar erledigt — SSE + Read-Status (Bestand), Tabs + Bulk-Clear + Bounce-Klartext (neu). Blockiert (Dev-Nachzug nach Davids D-P3): Topbar-Drawer, Live-Unseen-Count, Deeplink je Notification — diese 3 sind UI/Pixel-abhängig und warten auf D-P3.

Proof: db Typecheck 0 Fehler · web Typecheck Exit 0 · verify:i18n Exit 0 · notifications-db-Test 29/29 · pre-commit-Hooks (test-density/eslint-baseline/lint-staged/secrets) grün · Node 22.15.

AP-4 · Notification-Settings — 2026-06-25

Gebaut (Commit 6abda7919):

  • apps/web/app/routes/app.$tenant/settings/notifications.tsx — die 3 hartkodierten Kategorien durch eine Event-Typen-je-Modul-Registry (NOTIFICATION_CATEGORY_REGISTRY: general/billing/team) ersetzt; Loader/UI leiten Kategorien + Modul-Gruppierung daraus ab (Default-Fallback wie Worker isNotificationEnabled bleibt erhalten).
  • Master „alle Emails aus" (set-email-master-Action): schreibt EMAIL=off für jede registrierte Kategorie, damit explizite Per-Kategorie-Overrides keine Mails durchlassen. UI-Checkbox spiegelt den Zustand (an, wenn alle Kategorien EMAIL=false).
  • i18n settings.notifications.modules.* + settings.notifications.master.* (de+en).
  • 3 neue Route-Tests (Master an/aus + Render mit Master-Switch + 3 In-App/3 Email).

DoD-Stand nach AP-4:

  • DoD 5 (Notification-Settings: Event-Typen je Modul, In-App/Email-Toggle, Master-Toggle): done.
  • Test-Hinweis (environmental, keine Regression): die Action-Tests (Master + Pre-Existing update-preference) brechen lokal auf Node 22.15 im postFormRequest-Helper (undici new Request mit URLSearchParams-Body, Fehler VOR dem Action-Code, Zeile 85) — gleicher dokumentierter Umgebungsbug wie in der Memory; Loader-/Render-Tests (4/10) grün. CI/Node 22.12 unkritisch. Web-Typecheck + verify:i18n grün.

AP-5 · Sprach-Settings DE — 2026-06-25

Gebaut (Commit 893a88918):

  • apps/web/app/components/settings/LanguageSettingsNotice.tsx — statischer, read-only DE-only-Hinweis (v1 nur Deutsch; Sprachwechsler + weitere Locales = v2 laut DoD 7). Alle Strings via t().
  • eingebunden in die erreichbare Profil-/Settings-Seite (app.$tenant/settings/profile.tsx).
  • i18n settings.language.* (de+en vollständig).
  • Render-Test 2/2 (kein roher i18n-Key leakt ins UI).

DoD-Stand nach AP-5:

  • DoD 6 (Sprach-Settings DE: alle Strings via t(), vollständige de-Locale, verify:i18n grün): selbst machbar done. Blockiert: Kontakt.language-Feld nicht baubar, da es vor CRM P6+ kein Contact/Kontakt-Model im Schema gibt (Plan §5.1) — nicht erfunden.

Proof: web Typecheck Exit 0 · verify:i18n Exit 0 · LanguageSettingsNotice-Test 2/2 · pre-commit-Hooks grün.

Gesamt-DoD-Stand (nach AP-1..AP-5) — alle selbst machbaren Punkte done

  • DoD 1 done · DoD 2 teilweise (abgeleitete Variante done; strukturierter Diff + persist. summary_text blockiert §5.2 R-P1b/core.prisma) · DoD 3 done · DoD 4 selbst machbar done (Tabs/Bulk-Clear/Bounce; Topbar-Drawer/Live-Count/Deeplink blockiert via D-P3) · DoD 5 done · DoD 6 selbst machbar done (Kontakt.language blockiert P6+) · DoD 7 erfüllt.
  • %-Done: ~6 / 7 DoD ≈ 86 % · selbst machbar offen: nichts · extern blockiert: (a) strukturierter Diff/persist. Summary → R-P1b/Raffael (core.prisma, dependency-aware, nicht unilateral); (b) D-P3-Pixel-UI/Topbar-Drawer/Live-Count/Deeplink → David; (c) Kontakt.language → CRM P6+.
  • Ticket bleibt offen (nicht Done): 100 % erst, wenn die extern blockierten Punkte aufgelöst sind. Freigabe/Status-Wechsel durch Owner.
  • Test-Umgebung: Action-Tests (Notif-Settings) brechen lokal nur am bekannten Node-22.15-undici-Request-Body-Bug (vor dem Action-Code) — environmental, keine Regression; Typecheck/i18n/Render-/DB-Tests grün.

Subframe-Befund (2026-06-24)

Projekt Basedesign (f023064a5ca0) hat nur P2-/Auth-Designs (WF-P2-Flows), keine D-P3-Designs (Audit/Notif/Sprache) → P3-Pixel-UI bleibt Dev-Nachzug. Sync-Ziel ist apps/web/app/ui (~/ui/*, tailwind-v4).

AP-6 · Interim-UI-Vollausbau + Schema-Restpunkte — 2026-07-07 (Branch akeshan/ak-p3-interim-ui)

Die drei „extern blockiert"-Restpunkte vom 2026-06-25 wurden per Owner-Entscheid (2026-07-06, AskUserQuestion: Voll-AD-28-Umbau + beide Schema-Punkte) aufgelöst — kein Blocker-Ticket war nötig (D-P3 durch Interim-UI ersetzt; Kontakt existiert seit CRM-P6-Merge; Diff-Spalten additiv mit Freigabe).

Gebaut (Commits 4c0bae7d3..c48fb780b + Migration/Doku):

  • S1 Schema (4c0bae7d3): AuditEvent.beforeDiff/afterDiff (Json?, write-time sanitisiert) + summaryText (String?) in core.prisma; Kontakt.language (String?) in crm.prisma. Bewusst nicht im eventHash-Digest (Chain-Payload eingefroren — sonst bräche verifyAuditChain für Bestandszeilen); Chain-Bindung + Auto-Middleware-Befüllung = R-P1b-Nachzug (Vermerk in R-P1b.md, Kontakt.language in R-P6.md).
  • S2 VMs (838c6f494): audit-list.vm (persistierte Summary first, buildAuditFieldDiffs mit [REDACTED]-Maskierung, toAuditListModel), neu notification-center.vm (Deeplink-Validierung, M002-Bounce-Keys, Merge/Cap für SSE), notification-settings.vm (Registry + Default-Vererbung), audit-export.vm.
  • S3 Audit-Screens (3ed0b3d80): AuditListPage (A2 + echter ~/ui-Drawer, Feld-für-Feld-Diff, Maskierung „Wert geändert") + AuditExportPage; Admin-Routen als dünne <XPage vm actions/>-Hosts.
  • S4 Notification-Screens (21c1adfc6): NotificationCenterPage (Tabs/Bounce/Deeplink) + NotificationSettingsPage (A6, ~/ui-Switch); SSE in useNotificationsStream-Hook; Deeplink fährt als validierter app-relativer Scalar über den Realtime-Stream (deeplink/lastError an NotificationStreamItem + Realtime-Guard, fail-closed — payloadMetadata bleibt im Stream verboten). Altes NotificationCenter.tsx entfernt.
  • S5 Topbar (dc58e3540): NotificationsDrawer (echter ~/ui-Drawer), Glocke öffnet Drawer, Live-Unseen-Count aus SSE (Tenant-App; Admin behält Link — Stream ist tenant-scoped, siehe Dev-Nachzug).
  • S6 Tests (c48fb780b): Smoke tests/e2e/{audit,notifications}.spec.ts; Hot-Swap-Kette auditList/notificationCenter (ui-subframe-Renderer + ui-mock-Twins + Adapter + Tests). Visual-Regression deferred wie R-P2a/AK-P4b (keine Harness; Re-Baseline-Pflicht beim David-Nachzug).
  • S7 Migration: prisma/migrations/20260707010000_ak_p3_audit_diff_and_kontakt_language — idempotent (ADD COLUMN IF NOT EXISTS), expand-only/nullable (Migrate-on-Boot-sicher), Inverse-SQL als Kommentar.

Proof (lokal, Node 22.15): Typecheck db/api/web/worker/realtime/view-models/ui-* 0 Fehler · verify:i18n + verify:cross-cutting-models + verify:sidebar-routes Exit 0 · audit-events 12/12 · notifications-db 30/30 · realtime 54/54 · VM-Suiten 33+21 · Screen-/Route-Render-Tests grün · Adapter/Mock 64/64. Bekannt environmental: Action-Tests via postFormRequest (undici-Bug Node 22.15, vor dem Action-Code) + verify:migrations-parity braucht Docker → CI. Kein lokales db push möglich (Docker aus) — Client-Typen via prisma generate, Staging via Migrate-on-Boot.

Gesamt-DoD-Stand: 7/7 = 100 % · selbst machbar offen: nichts · getrackter Nachzug (nicht Done-blockierend, AD-28): finale D-P3-Subframe-Optik (design-nachzug: offen), Interim-Visual-Baseline beim Swap, Admin-Drawer (tenant-scoped Stream), Diff-Chain-Bindung/Auto-Middleware (R-P1b).

Status-Wechsel auf Done: erfolgt — Plane steht auf Done, Label design-nachzug gesetzt, Abschluss-Kommentar vom 2026-07-06 vorhanden.

Stand-Audit — 2026-07-17 (Claude/Akeshan)

Drei-Quellen-Abgleich (Ticket-Doc vs. Plane vs. Code auf main) per /audit-ticket: 7/7 DoD = 100 % bestätigt, kein Code-Delta. Alle 12 Umsetzungs-Commits (2bee1ecaa..c48fb780b) sind in main gemerged; Artefakte inhaltlich verifiziert (Permission-Gate routes/admin/audit.tsx, Diff-Drawer + [REDACTED]-Maskierung audit-list.vm.ts/AuditListPage.tsx, Export mit Zweck-Pflicht + audit.exported auditExportStorage.server.ts, Retention-Cron apps/worker/src/index.ts, Center/Drawer/Settings-Screens, LanguageSettingsNotice in profile.tsx, Kontakt.language crm.prisma, Migration 20260707010000_… idempotent). Behobener Drift (rein Doku): Header-Status auf Done nachgezogen (Plane war bereits Done), REQUIREMENTS/ROADMAP-Nachzug erledigt (s. Dev-Nachzug-Checkbox). Offen bleiben nur die getrackten Nachzüge: design-nachzug (D-P3-Optik), Admin-Topbar-Drawer (tenant-scoped Stream), Diff-Chain-Bindung/Auto-Middleware (R-P1b).