4.8 KiB
4.8 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 | geplant |
Abhängigkeiten & Parallelität
- Blocked by:
R-P1b(Service-Kerne: Audit-Hash-Kette,notify(), i18n-Engine),R-P2b(RLS + Permissions füraudit.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), eigeneprisma/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ändigede-Locale,verify:i18ngrü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-P1bangelegtenAuditEntry/Notification/NotificationPreference. Neu nurAuditExportJobist v2 → in v1 fixe Default-Retention statt Job-Editor (Boilerplate liefert Retention-Cron + PDF-Export). Eigeneprisma/schema/*.prismafalls 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_datagreift 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-outboundROADMAP.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-P3aktualisiert