Files
HiveGrid-Wireframes/03 Quellen und Referenzen/hivegrid-cloud/_bmad-output/specs/M21-audit-log.md
T

25 KiB
Raw Blame History

module, title, phase, status, last_updated, session_source, related_lps, spec_style
module title phase status last_updated session_source related_lps spec_style
21 Audit-Log 1 detail-spec-draft 2026-05-08 brainstorming-session-2026-05-07-2206.md
LP-1
LP-6
LP-9
LP-10
LP-13
requirements-pur

Modul 21 — Audit-Log

Detail-Spec gemäß LP-9. Tenant-weiter, manipulationsarmer Trail aller schreibenden Aktionen mit Vorher-/Nachher-Diff. Compliance-Grundlage für DSGVO-Auskunft, interne Nachvollziehbarkeit und Sicherheits-Forensik. Erfasst alle Schreib-Aktionen aller Module (AV #6 — Audit-Trail-Default).

Themenblöcke

A. Datenmodell (AuditEntry, Aufbewahrung)
B. Erfassungs-Vorschrift (was wird geloggt)
C. Menü-Struktur und Routes
D. Listen-View (Audit-Trail)
E. Detail-View (Diff-Anzeige)
F. Filter & Suche
G. Export (Compliance)
H. Aufbewahrung & Auto-Lösch
I. Manipulations-Schutz (Phase 2: Hash-Chain)
J. Permissions-Anwendung
K. Activity-Stream-Integration
L. Klartext-Hinweise
M. Phase 2 / spätere Features

Block A — Datenmodell

AuditEntry

  • id (UUID)
  • tenant_id (NOT NULL, RLS)
  • created_at (Timestamp, immutable, indexed)
  • actor_user_id (FK auf User; NULL bei System/Automation/KI)
  • actor_kind (Enum: user | system | automation | ki_agent | api_key | platform_admin)
  • actor_label (Snapshot des Names bei Erfassung — bleibt auch bei User-Löschung)
  • action (Enum, siehe Block B — z.B. contact.created, deal.stage_changed, permission.granted)
  • subject_type (Enum: contact | company | lead | deal | project | user | role | permission | tag | custom_field | api_key | tenant_setting | ...)
  • subject_id (UUID des betroffenen Objekts)
  • subject_label (Snapshot des Namens für menschen-lesbare Anzeige nach Subject-Hard-Delete)
  • before_diff (JSONB — Vorher-Snapshot der geänderten Felder)
  • after_diff (JSONB — Nachher-Snapshot der geänderten Felder)
  • metadata (JSONB — Action-spezifischer Kontext, z.B. Bulk-Operation-ID, Automation-Run-ID, KI-Prompt-ID)
  • ip_address (INET — bei API-/User-Aktionen)
  • user_agent (Text — bei User-Aktionen)
  • request_id (UUID — für Korrelation mit Logs)
  • summary_text (Pflicht — Klartext-Zusammenfassung in DE, z.B. „Max Mustermann hat Deal ‚Heizung Müller' von Stage Angebot auf Auftrag verschoben")
  • hash_prev (TEXT — Phase 2, Hash-Chain)
  • hash_self (TEXT — Phase 2, Hash-Chain)

Indizes

  • (tenant_id, created_at DESC) — Default-Sortierung
  • (tenant_id, actor_user_id, created_at DESC) — Filter nach Person
  • (tenant_id, subject_type, subject_id, created_at DESC) — Filter nach Modul/Objekt
  • (tenant_id, action, created_at DESC) — Filter nach Aktion
  • GIN-Index auf metadata für Korrelations-Queries
  • Trigram-Index auf summary_text für Volltext-Suche

Append-Only-Constraint

  • Tabelle hat KEINE UPDATE-/DELETE-Rechte für App-Role
  • Nur INSERT erlaubt; Audit-Cleanup-Job läuft mit Superuser-Role gegen Retention-Regeln (siehe Block H)
  • DB-Trigger blockt UPDATE auf bestehende Einträge (Belt-and-Suspenders)

Sub-Entitäten

AuditExportJob (für Compliance-Export):

  • id, tenant_id, requested_by_user_id, created_at
  • filter_criteria (JSONB — gleicher Filter wie Listen-View)
  • format (Enum: csv | json | pdf)
  • status (Enum: pending | running | completed | failed)
  • result_file_url (Scaleway-Storage, signed URL mit 7-Tage-Gültigkeit)
  • entry_count
  • completed_at

AuditRetentionPolicy (Tenant-Setting):

  • tenant_id (Primary Key)
  • default_retention_months (Default 24, min. 6, max. 120)
  • legal_hold_active (Boolean — bei aktivem Legal Hold KEINE Auto-Lösch)
  • legal_hold_reason (Text)
  • legal_hold_set_by, legal_hold_set_at

Block B — Erfassungs-Vorschrift

AV #6 — Audit-Trail-Default: Jede schreibende Aktion erzeugt einen Audit-Entry. Pflicht-Vorschrift, kein Modul ist davon befreit.

Pflicht-erfasste Action-Kategorien (Auswahl, nicht abschließend)

Auth & User-Lifecycle (Modul 27):

  • auth.login_success / auth.login_failed
  • auth.logout
  • auth.password_changed
  • auth.2fa_enabled / auth.2fa_disabled / auth.2fa_reset
  • user.invited / user.accepted_invitation
  • user.deactivated / user.removed / user.reactivated
  • user.deleted (Self-Delete)
  • session.revoked (manuell oder automatisch)
  • tenant.created / tenant.suspended / tenant.frozen / tenant.deletion_pending / tenant.deleted

Permissions & Rollen (Modul 27):

  • role.created / role.updated / role.deleted / role.duplicated
  • permission.granted / permission.revoked (mit Diff der atomaren Permissions)
  • user.role_assigned / user.role_removed
  • group.created / group.member_added / group.member_removed / group.deleted

CRM (Modul 1, 2, 3):

  • contact.created / contact.updated / contact.archived / contact.restored / contact.deleted
  • company.*, lead.*, deal.*
  • lead.promoted (mit Verweis auf entstandenen Contact + Deal)
  • merge.contacts / merge.companies (mit Verlierer + Gewinner + Field-Auswahl)
  • tag.applied / tag.removed
  • custom_field.definition_created / *_updated / *_archived / *_deleted
  • custom_field.value_set / *_changed / *_cleared

Projekte/Pipeline/Tasks (Modul 4, 26):

  • project.created / project.stage_changed / project.archived / project.deleted
  • task.created / task.assigned / task.completed / task.deleted

Kommunikation (Modul 9, 10, 12, 13):

  • email.sent (Outbound, mit Empfänger + Betreff in metadata)
  • email_marketing.campaign_sent (mit Empfänger-Anzahl)
  • call.made / call.received (Metadaten: Dauer, Aufzeichnung-Link)
  • chat.message_deleted (Soft-Delete; Edit nicht erfasst da häufig)

Files (Modul 23):

  • file.uploaded / file.deleted / file.shared / file.access_revoked

Automation & KI (Modul 17, 18):

  • automation.created / automation.activated / automation.deactivated / automation.deleted
  • automation.executed (Aggregat-Eintrag pro Run, Detail-Ausführungs-Log separat in Modul 17)
  • ki.action_taken (mit Prompt-Hash + bestätigter User)

Settings & Integrationen (Modul 27, 33a, 19):

  • tenant_setting.changed (welches Setting, von wem, alt/neu)
  • integration.connected / integration.disconnected
  • api_key.created / api_key.revoked
  • feature_flag.changed (Plattform-Admin-Aktion, sichtbar in Tenant-Audit nur als Marker)

Audit-Log selbst:

  • audit.exported (Wer hat wann was exportiert)
  • audit.legal_hold_set / audit.legal_hold_released
  • audit.retention_changed

Customer-Portal (Modul 15):

  • portal_user.invited / portal_user.action (Kommentar, Datei-Download, Approval)

Code-Erfassungs-Pattern

Architektur-Vorschrift:

  • Zentraler auditService.log({ action, subject, before, after, ... })-Service
  • Aufruf in jedem schreibenden Service-Layer-Pfad (nicht im Controller — Service-Layer ist die Wahrheits-Schicht)
  • Bei Bulk-Operationen: ein Audit-Entry pro betroffenem Objekt + ein Aggregat-Entry mit Bulk-Operation-ID (metadata.bulk_op_id)
  • Bei Transaction-Failure: Audit-Entry rollt mit zurück (gleiche Transaction)

NICHT erfasst (bewusste Ausschlüsse, gemäß LP-13 Datenökonomie)

  • Pure Read-Aktionen (Liste laden, Detail anzeigen) — würde Audit fluten
  • Real-time-Cursor-Position in Editoren
  • Chat-Message-Edits (zu häufig — nur Delete)
  • Notification-Read-Status

Ausnahmen mit P2-Ausbaupfad:

  • Sensible Read-Aktionen (HR-Daten lesen, DSGVO-Export herunterladen) → P1-Pflicht-Erfassung als Spezial-Action audit.sensitive_read
  • Customer-Portal-Login als portal.login

Block C — Menü-Struktur und Routes

Sidebar-Eintrag: unter Workspace-Verwaltung (Tenant-Admin) → Audit-Log.

Routen:

/{tenant}/admin/audit                          → Audit-Trail Listen-View
/{tenant}/admin/audit/:id                      → Audit-Entry Detail
/{tenant}/admin/audit/exports                  → Export-Jobs Übersicht
/{tenant}/admin/audit/exports/new              → Export-Job anlegen
/{tenant}/admin/audit/exports/:id              → Export-Job-Status + Download
/{tenant}/admin/audit/settings                 → Aufbewahrungs-Settings + Legal Hold

Zusätzliche Einbettung:

  • Per-Subject-Audit-Drawer in jeder Detail-View (Contact-Detail, Deal-Detail etc.) zeigt gefiltert auf subject_type + subject_id (Permission audit.read erforderlich)
  • Per-User-Audit-Drawer in /{tenant}/admin/users/:id/ zeigt Aktionen dieses Users (Permission audit.read)

Block D — Listen-View (Audit-Trail)

Zu zeigende Daten pro Eintrag

  • Datum + Uhrzeit (relativ < 7 Tage, sonst absolut)
  • Actor (Avatar + Name + Actor-Kind-Marker für System/Automation/KI/API-Key/Plattform-Admin)
  • Action (menschen-lesbares Label aus Action-Enum, lokalisiert über i18n)
  • Subject (Typ + Name, klickbar zur Quelle wenn nicht gelöscht)
  • Summary-Text als Hauptinhalt
  • Optional: IP / User-Agent-Marker bei expandierten Zeilen

Benötigte UI-Elemente

  • Listen-Anzeige (Designer-Wahl: Tabelle, Stream, Karten)
  • Filter-Komponenten (siehe Block F)
  • Such-Funktion (Volltext über summary_text)
  • Sortierung: Default Datum absteigend (umkehrbar)
  • Pagination (Cursor-basiert, „Mehr laden", 100 pro Page — Audit-Daten oft groß)
  • Klick auf Zeile → Detail-View
  • Quick-Filter-Funktionen (Click auf Actor / Subject / Action filtert die Liste vor)
  • Date-Range-Selektor (Default: letzte 30 Tage; max. 24 Monate ohne Export)
  • Export-Funktion-Button (führt zu Export-Job-Anlage)

Operationen

  • Filter anwenden / kombinieren / als „Gespeicherte Ansicht" speichern (max. 5 pro User)
  • Drill-Down via Klick auf Felder
  • Detail-Anzeige für einzelnen Entry
  • Export starten (siehe Block G)

Performance-Anforderungen

  • Server-side-Filter zwingend (Audit-Tabellen werden groß: bei 50 MA Geerkens schätzungsweise 50-200k Entries/Monat)
  • Indizes (siehe Block A)
  • Default-Query auf 30 Tage begrenzt; ältere Daten nur über explizite Date-Range
  • Bei Bulk-Operations: Aggregat-Entry standardmäßig anzeigen, Individual-Entries auf Klick aufklappbar
  • Materialized View für Statistik-Aggregate (P2)

Block E — Detail-View (Diff-Anzeige)

Zu zeigende Daten

  • Vollständiger Eintrag (alle Felder aus Block A)
  • Vorher-/Nachher-Diff als visualisierter Vergleich
  • Bei Bezug zu Bulk-Operation: Liste aller Geschwister-Entries derselben Bulk-Op
  • Bei Bezug zu Automation-Run: Verlinkung in Automation-Execution-Log (Modul 17)
  • Bei Bezug zu KI-Aktion: Verlinkung in KI-Aktion-Log mit Prompt-Hash (Modul 18)

Benötigte UI-Elemente

  • Strukturierte Anzeige aller Eintrag-Felder
  • Diff-Visualisierung pro geändertem Feld:
    • Skalare Werte: Vorher / Nachher direkt nebeneinander
    • JSON/Listen-Werte: Strukturierter Diff (Hinzufügungen / Löschungen / Änderungen)
    • Sensible Felder (z.B. Passwort-Hash): nur Marker „Wert geändert", kein Vorher/Nachher
  • Verlinkungs-Funktionen zu Subject (wenn nicht gelöscht), Actor-Profil, Bulk-Op-Sicht
  • Copy-to-Clipboard-Funktion für request_id (für Support-Korrelation)

Operationen

  • Read-only — keine Editier-Funktion, keine Löschung
  • „Ähnliche Einträge anzeigen" (filtert Liste auf gleiche Action + Subject-Type)
  • „Verlauf dieses Objekts" (filtert auf gleiche subject_type + subject_id)

Klartext-Hinweise

  • Bei Subject-Hard-Delete: „Das betroffene Objekt wurde inzwischen gelöscht. Snapshot des Namens: ‚X'."
  • Bei sensiblen Diff-Inhalten: „Diff aus Datenschutz-Gründen nicht sichtbar — nur ‚Wert geändert' wird gezeigt."
  • Bei System/Automation-Actor: „Diese Aktion wurde von der Automation ‚X' ausgeführt — [Automation öffnen]"

Block F — Filter & Suche

Filter-Optionen

Pflicht-Filter (immer sichtbar):

  • Date-Range (Default 30 Tage; explizite Auswahl bis max. Retention-Period)
  • Actor (Multi-Select aus User + System + Automation + KI + API-Key)
  • Action-Kategorie (gruppiert: Auth, CRM, Projekte, Kommunikation, Settings, ...)

Erweiterte Filter:

  • Subject-Type (Multi-Select)
  • Subject-ID (Free-Text mit Auto-Complete bei Eingabe)
  • IP-Adresse (für Sicherheits-Forensik)
  • Actor-Kind (User / System / Automation / KI / API-Key / Plattform-Admin)
  • Bulk-Op-ID (für Korrelation)
  • Request-ID (für Support-Korrelation)

Volltext-Suche:

  • Über summary_text mit Trigram-Index
  • Server-side, debounced (500ms)

Gespeicherte Ansichten

  • User kann Filter-Kombination als „Ansicht" speichern (max. 5 pro User)
  • Beispiel-Default-Ansichten geseeded:
    • „Login-Aktivität letzte 7 Tage"
    • „Permissions-Änderungen letzte 30 Tage"
    • „Hard-Deletes letzte 90 Tage"
    • „API-Key-Aktionen"

Permissions-Auswirkung im Filter

  • User mit audit.read (nicht audit.admin) sieht alle Einträge des Tenants — kein eigener Owner-Check, da Audit tenant-weit ist
  • HR-bezogene Audit-Einträge (Modul 14) zeigen nur Marker ohne Diff-Inhalt für User ohne hr.read_all
  • Sensible Diff-Inhalte (z.B. Customer-Portal-User-Daten) ohne Detail-Diff für User ohne entsprechende Modul-Permission

Block G — Export (Compliance)

Use-Cases

  • DSGVO-Auskunft (Behörde fragt: Welche Aktionen wurden mit den Daten von Person X durchgeführt?)
  • Interne Compliance-Audits
  • Sicherheits-Forensik (Übergabe an Externe für Vorfalls-Analyse)
  • Rechtsstreit (Gerichtsanforderung)

Export-Job-Anlage (/admin/audit/exports/new)

Zu zeigende Daten:

  • Filter-Kriterien (analog Listen-View)
  • Format-Auswahl (CSV / JSON / PDF)
  • Zweck-Begründung (Pflichtfeld, Freitext, wird in Audit erfasst)

Operationen:

  • Filter setzen (gleiche UX wie Listen-View)
  • Format wählen
  • Vorschau der zu exportierenden Anzahl Einträge (count-only, vor Submit)
  • Job submit → asynchrone Verarbeitung
  • Notification bei Fertigstellung (Modul 22)

Format-Spezifikationen:

  • CSV: Flach, Diff als JSON-String pro Zeile
  • JSON: Strukturiert mit voll-aufgelöstem Diff
  • PDF: Lesbarer Bericht mit Header (Tenant, Zeitraum, Erstellt von, Filter-Kriterien, Anzahl Einträge), tabellarischer Inhalt, signierter Footer (Phase 2: digitale Signatur via PandaDoc)

Export-Job-Status (/admin/audit/exports/:id)

Zu zeigende Daten:

  • Job-Status (Pending/Running/Completed/Failed)
  • Filter-Kriterien (read-only)
  • Erstellt von / am
  • Zweck-Begründung
  • Anzahl Einträge im Resultat
  • Download-Link (signed URL, 7 Tage gültig)
  • Bei Fehler: Klartext-Fehlermeldung

Operationen:

  • Download (1x kostenlos pro Job; weitere Downloads regenerieren signed URL)
  • Job widerrufen / löschen (nur falls kein Download erfolgte)

Export-Tracking

  • Jeder Export wird selbst auditiert (audit.exported Action)
  • Export-Datei selbst auf Scaleway-Storage tenants/{tenantId}/audit-exports/{jobId}/...
  • Export-Datei wird nach 30 Tagen automatisch gelöscht (Notification 7 Tage vorher)

Klartext-Hinweise

  • Vor Submit: „Du exportierst 4.892 Audit-Einträge. Der Export wird selbst geloggt und sichtbar für andere Tenant-Admins."
  • Bei Job-Failure: „Export fehlgeschlagen — bitte Filter eingrenzen und erneut versuchen. Bei wiederholtem Fehler: Support kontaktieren."

Block H — Aufbewahrung & Auto-Lösch

Default-Retention

  • 24 Monate ab created_at
  • Tenant-Admin-konfigurierbar in /admin/audit/settings (min. 6, max. 120 Monate)

Auto-Lösch-Job

  • Täglicher Cron-Job läuft mit Superuser-Role
  • Löscht Einträge älter als Retention-Period — außer:
    • legal_hold_active = true → Lösch-Pause für gesamten Tenant
    • Sensible Action-Kategorien mit Sonder-Retention (Phase 2):
      • auth.* und permission.* mindestens 36 Monate
      • tenant.deleted-Einträge dauerhaft (für Reaktivierungs-Window)

Setting in /admin/audit/settings:

  • Toggle „Legal Hold aktivieren"
  • Bei Aktivierung: Pflicht-Begründung (Freitext, mindestens 20 Zeichen)
  • Bei Aktivierung: Auto-Lösch pausiert für gesamten Tenant
  • Permission: nur tenant.admin UND audit.admin
  • Aktivierung wird selbst auditiert (audit.legal_hold_set)

Klartext-Hinweis bei aktivem Legal Hold:

  • Banner im Audit-Log: „Legal Hold aktiv seit [Datum] — keine automatische Löschung. Begründung: [Text]. [Bei Bedarf aufheben]"

Retention-Änderung

  • Tenant-Admin kann Retention herauf-/herunter-setzen
  • Bei Reduzierung: Klartext-Bestätigung mit Anzahl betroffener Einträge: „Wenn du Retention auf 12 Monate setzt, werden ca. 47.231 Audit-Einträge älter als 12 Monate beim nächsten Auto-Lösch-Lauf entfernt. [Bestätigen] [Abbrechen]"
  • Änderung wird selbst auditiert (audit.retention_changed)

Block I — Manipulations-Schutz (Phase 2: Hash-Chain)

Phase 1: Append-Only-Constraint auf DB-Ebene (siehe Block A). Tenant-Admin und Support sehen Einträge gleich; keine Edit-/Delete-Rechte für irgendwen außer Auto-Cleanup-Job.

Phase 2 — Hash-Chain:

  • Pro Eintrag: hash_self = SHA256(prev_hash || canonical_serialization(entry))
  • hash_prev zeigt auf vorherigen Eintrag desselben Tenants
  • Ein „Genesis"-Eintrag pro Tenant zur Initialisierung
  • Verifikations-Tool in /admin/audit/settings → „Integrität prüfen": läuft asynchron über Tenant-Audit-Trail, gibt Anzahl Einträge + Hash-Validität zurück
  • Bei Manipulation entdeckt: Klartext-Alert + Audit-Eintrag mit Lücke-Marker
  • Optional: tägliche Veröffentlichung des aktuellen Tenant-Hash als signierte Notification an Tenant-Admin (Notar-Pattern light)

Phase 3 / falls Compliance verlangt: signierte Hash-Veröffentlichung an externen Time-Stamping-Service (z.B. RFC 3161-konformer EU-Provider).


Block J — Permissions-Anwendung

Permission-IDs

Permission Erlaubt
audit.read Audit-Trail lesen (tenant-weit), Detail-View, Filter, Suche
audit.admin Export-Jobs anlegen, Aufbewahrungs-Settings ändern, Legal Hold setzen/aufheben

Bundle-Mapping (Variante 2)

Bundle Atomare Permissions
audit.none (keine)
audit.read audit.read
audit.admin audit.read + audit.admin

Anwendung in Routes

  • /admin/audit → audit.read
  • /admin/audit/:id → audit.read
  • /admin/audit/exports → audit.admin
  • /admin/audit/exports/new → audit.admin
  • /admin/audit/exports/:id → audit.admin (Anlage) oder Self-Job-Owner (Status sehen)
  • /admin/audit/settings → audit.admin UND tenant.admin

Anwendung in Per-Subject-Drawer

  • Detail-View eines Contacts/Deals/Projekts zeigt Audit-Drawer wenn User audit.read hat
  • Ohne Permission: kein Drawer sichtbar (kein Tab, kein Hinweis)

Sensible Diff-Inhalte

  • HR-bezogene Diffs (Modul 14): voll sichtbar nur mit hr.read_all ODER audit.admin
  • Customer-Portal-User-Diffs (Modul 15): nur mit entsprechender Modul-Permission
  • Passwort-Hashes / Geheimnisse: nie als Diff-Inhalt, nur Marker „Wert geändert"

Self-Audit-Schutz

  • User darf eigene Audit-Einträge sehen (kann ohne audit.read über /settings/security/-Sub-Page eigene Aktivitäten einsehen — Phase 2 Detail)
  • User kann eigene Audit-Einträge nicht ändern oder löschen (DB-Constraint)

Audit-Eigene Audit-Einträge

  • audit.exported, audit.legal_hold_set, audit.retention_changed sind sichtbar für jeden mit audit.read
  • Kein „blinder Fleck" für Tenant-Admin — selbst Tenant-Admin-Aktionen am Audit-Log sind transparent

Klartext-Fehler

  • Zugriff auf /admin/audit ohne audit.read: 403 mit „Du hast keine Berechtigung, das Audit-Log zu sehen. Bitte Tenant-Admin kontaktieren, falls erforderlich."
  • Export-Versuch ohne audit.admin: Aktions-Funktion einfach nicht sichtbar, Tooltip falls dennoch angezeigt: „Hierfür benötigst du erweiterte Berechtigungen."
  • Legal-Hold-Aufhebung ohne Begründung: „Bitte gib einen Grund für die Aufhebung an — wird selbst geloggt."

Block K — Activity-Stream-Integration

  • Audit-Log und Activity-Stream sind getrennte Konzepte:
    • Activity-Stream (Modul 1, Block E) ist user-facing, bezogen auf einzelne Entitäten (Contact-Aktivitäten), nicht alle Aktionen
    • Audit-Log ist tenant-weit, erfasst ALLE schreibenden Aktionen, ist Compliance-Werkzeug
  • Brückenpunkt: Manche Audit-Actions erzeugen zusätzlich Activity-Stream-Einträge (z.B. lead.assigned ist sowohl Audit als auch Activity)
  • Activity-Stream sieht jede Activity, deren Subject der User sehen darf (siehe Modul 1)
  • Audit-Log sieht jede Action des Tenants, gegated durch audit.read (tenant-weit, kein Subject-Permission-Filter)
  • Activity-Typ audit_event (in Modul 1 definiert) ist nur sichtbar mit audit.read und zeigt Audit-Aktionen, die NICHT bereits als reguläre Activity gelistet sind (z.B. Permission-Änderungen)

Block L — Klartext-Hinweise

  • Leerer Trail (frischer Tenant): „Noch keine Aktionen erfasst — Audit-Einträge erscheinen, sobald jemand schreibend tätig wird."
  • Filter ohne Treffer: „Keine Einträge passen zu deinen Filtern. [Filter zurücksetzen]"
  • Subject gelöscht: „Das betroffene Objekt wurde inzwischen gelöscht. Snapshot-Name: ‚X'."
  • Sensible Diff-Inhalte: „Aus Datenschutz-Gründen wird nur ‚Wert geändert' angezeigt."
  • Bulk-Op-Hinweis: „Diese Aktion ist Teil einer Bulk-Operation mit 47 weiteren Einträgen. [Alle anzeigen]"
  • Automation-Hinweis: „Ausgeführt von Automation ‚X' (Run-ID Y). [Automation öffnen] [Run-Log öffnen]"
  • KI-Hinweis: „KI-Aktion auf Basis von User-Bestätigung von [User]. [KI-Prompt anzeigen]"
  • Legal Hold aktiv: „Legal Hold aktiv — Aufbewahrung verlängert."
  • Retention abgelaufen, Legal Hold setzte rückwirkend ein: „Hinweis: Legal Hold wurde nach Auto-Lösch-Lauf gesetzt. Einträge älter als [Retention] sind möglicherweise bereits gelöscht."
  • Export läuft: „Export wird im Hintergrund verarbeitet (geschätzt X Minuten). Notification bei Fertigstellung."

Block M — Phase 2 / spätere Features

  • Hash-Chain mit Verifikations-Tool (siehe Block I)
  • Externes Time-Stamping (RFC 3161 EU-Provider)
  • PDF-Bericht mit digitaler Signatur (PandaDoc-Integration)
  • Pro-Action Sonder-Retention (z.B. Auth/Permission 36 Monate auch bei Default 12)
  • Real-time-Audit-Feed (Server-Sent-Events für Tenant-Admin-Live-Monitoring)
  • Audit-Anomalie-Detection (KI erkennt verdächtige Muster: ungewöhnliche Login-Zeiten, Massen-Lösch-Aktionen, Permission-Eskalation)
  • Cross-Tenant-Trail für Plattform-Admin (für Support-Forensik mit Audit-Eintrag pro Lookup)
  • Self-Audit für User (/settings/security/-Sub-Page mit eigenen Aktivitäten der letzten 90 Tage)
  • Replay-Funktion (für Test-Tenants: Audit-Trail in einen anderen Tenant nachspielen — sehr Phase 3)
  • Materialized Views für Audit-Statistiken (Aktionen pro Tag, Top-Actor, Top-Subject-Type)

Architektur-Vorschriften (Querschnitt)

  • AV #6: Audit-Trail-Default für jede schreibende Aktion (in jedem Modul Pflicht-Aufruf des auditService.log())
  • AV #1, LP-10: Klartext-Diagnostik überall (Subject-gelöscht, Bulk-Op, Automation-/KI-Bezug, Sensible Inhalte)
  • LP-1: Tenant-Isolation strikt — Audit-Einträge sind tenant-scoped, kein Cross-Tenant-Read außer Plattform-Admin (mit eigenem Audit)
  • LP-13: EU-Stack — Audit-Daten bleiben in Scaleway, Export-Files in Scaleway-Storage, kein Drittland-Transfer
  • LP-9: UI-Element-Anforderungen als Liste, kein Layout
  • AV #20: KI darf Audit-Einträge weder verändern noch löschen — Lese-Aktionen für KI sind eigenes Audit-Event (audit.sensitive_read-Variante mit actor_kind = ki_agent)

Detail-Spec-Status: DRAFT

Erste vollständige Detail-Spec für Modul 21. Vor Bau: Verifizierung mit Noah (zusammen mit Pflichtenheft-Sweep). Bei Implementierung dann konkrete Index-Strategie, Action-Enum-Vollständigkeit, JSONB-Diff-Serialisierungs-Format und Storage-Pfad-Strategien finalisieren.

Offene Detail-Punkte (nicht-blockierend):

  • Konkretes Default-Retention finalisieren (24 Monate angenommen aus Brainstorming, mit Noah validieren ob für Geerkens passt)
  • Hash-Chain-Implementierung Phase 2 detailliert (Algorithmus-Wahl, Performance-Impact bei großen Trails)
  • Sensible-Diff-Heuristik: Welche Felder werden als sensibel klassifiziert (HR, Portal-User, Geheimnisse) — Liste pro Modul
  • Action-Enum-Liste vollständig erst nach allen Modul-Specs (Modul 21 dokumentiert das Pattern, konkrete Action-IDs entstehen modulweise)
  • Plattform-Admin-Cross-Tenant-Audit-Pattern Phase 1 oder Phase 2

Abhängige Module:

  • Modul 27 (Auth/Permissions) — Permission-Bundle audit.*, alle Auth-bezogenen Action-IDs
  • Modul 22 (Notifications) — Export-Fertigstellungs-Notification, Anomalie-Alerts (Phase 2)
  • Modul 23 (Files) — Export-File-Storage in Scaleway
  • Modul 17 (Automation) — Automation-Run-ID-Korrelation
  • Modul 18 (KI-Layer) — KI-Prompt-ID-Korrelation
  • Alle anderen Module — als Audit-Quellen (jedes Modul ruft auditService.log() auf bei schreibenden Aktionen)