Files
HiveGrid-Wireframes/hivegrid-cloud/.planning/ticket-docs/AK-P3.md
T

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ü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