# 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** | geplant | ## 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`) | Screen [Route] | Kern-Inhalt | Liefert (Design) | |---|---|---| | Audit-Viewer [`/admin/audit`] | 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-Jobs [`/admin/audit/exports` +`/new` +`/:id`] | Job-Liste · Anlage (Filter, Format, Zweck) · Status + signed-URL-Download | `D-P3` (A2) | | Notification-Center [Topbar-Drawer + `/notifications`] | Titel/Body/Actor/Zeit/Read-Status, Tabs Alle/Ungelesen, Bulk-Clear, Bounce-Klartext | `D-P3` (A2) | | Notification-Settings [`/settings/notifications`] | 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 - [ ] **Diff-Detail-Drawer** (Feld-für-Feld Vorher/Nachher; Maskierung bei sensiblen Werten) - [ ] **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 - [ ] **Notification-Center** (SSE, Read-Status, Deeplink, Tabs, Bulk-Clear, Bounce-Klartext) - [ ] **Notification-Settings** (Event-Typen je Modul, In-App/Email-Toggle, Master-Toggle) - [ ] **Sprach-Settings DE** — alle Strings durch `t()`, vollständige `de`-Locale, `verify:i18n` grün; `Contact.language`-Feld vorhanden (Outbound ab v2) - [ ] *(→ 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 · `PHASE-SOURCES.md` → Phase 3 (M028/M115/M116/M151/M152; Service-Kerne → P1, Flag-Admin-UI → P19) - `designer-briefs/P03-querschnitts-oberflaechen.md` - `_bmad-output/specs/M21-audit-log.md`, `M22-notifications.md`, `M30-i18n.md` (Oberflächen-Teile) ## Dev-Nachzug (nach Davids `D-P3`-Delta) - [ ] Audit-/Notif-Oberflächen an Davids UI angepasst - [ ] REQUIREMENTS/PHASE-SOURCES nachgezogen - [ ] Plane-Ticket `AK-P3` aktualisiert