200 lines
22 KiB
Markdown
200 lines
22 KiB
Markdown
# 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
|
|
- [x] **Audit-Viewer** permission-gegated (`audit.read`), server-seitige Filter, DE-Summary-Text, Actor-Kind-Marker — *AP-1* (+ Interim-Screen *AP-6*)
|
|
- [x] **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`).
|
|
- [x] **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*)
|
|
- [x] **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.
|
|
- [x] **Notification-Settings** (Event-Typen je Modul, In-App/Email-Toggle, Master-Toggle) — *AP-4* (+ Interim-Screen *AP-6*)
|
|
- [x] **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`)
|
|
- [x] *(→ 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`).
|
|
|
|
- [x] 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).
|
|
- [x] Requirements nachgezogen (2026-07-17: 4 Phase-3-REQs auf Done mit v1-Scope-Vermerk in `REQUIREMENTS.md`)
|
|
- [x] 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).
|