25 KiB
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 |
|
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
metadatafür Korrelations-Queries - Trigram-Index auf
summary_textfü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_atfilter_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_countcompleted_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_failedauth.logoutauth.password_changedauth.2fa_enabled/auth.2fa_disabled/auth.2fa_resetuser.invited/user.accepted_invitationuser.deactivated/user.removed/user.reactivateduser.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.duplicatedpermission.granted/permission.revoked(mit Diff der atomaren Permissions)user.role_assigned/user.role_removedgroup.created/group.member_added/group.member_removed/group.deleted
CRM (Modul 1, 2, 3):
contact.created/contact.updated/contact.archived/contact.restored/contact.deletedcompany.*,lead.*,deal.*lead.promoted(mit Verweis auf entstandenen Contact + Deal)merge.contacts/merge.companies(mit Verlierer + Gewinner + Field-Auswahl)tag.applied/tag.removedcustom_field.definition_created/*_updated/*_archived/*_deletedcustom_field.value_set/*_changed/*_cleared
Projekte/Pipeline/Tasks (Modul 4, 26):
project.created/project.stage_changed/project.archived/project.deletedtask.created/task.assigned/task.completed/task.deleted
Kommunikation (Modul 9, 10, 12, 13):
email.sent(Outbound, mit Empfänger + Betreff inmetadata)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.deletedautomation.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.disconnectedapi_key.created/api_key.revokedfeature_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_releasedaudit.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(Permissionaudit.readerforderlich) - Per-User-Audit-Drawer in
/{tenant}/admin/users/:id/zeigt Aktionen dieses Users (Permissionaudit.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_textmit 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(nichtaudit.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.exportedAction) - 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.*undpermission.*mindestens 36 Monatetenant.deleted-Einträge dauerhaft (für Reaktivierungs-Window)
Legal Hold
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.adminUNDaudit.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_prevzeigt 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.adminUNDtenant.admin
Anwendung in Per-Subject-Drawer
- Detail-View eines Contacts/Deals/Projekts zeigt Audit-Drawer wenn User
audit.readhat - Ohne Permission: kein Drawer sichtbar (kein Tab, kein Hinweis)
Sensible Diff-Inhalte
- HR-bezogene Diffs (Modul 14): voll sichtbar nur mit
hr.read_allODERaudit.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_changedsind sichtbar für jeden mitaudit.read- Kein „blinder Fleck" für Tenant-Admin — selbst Tenant-Admin-Aktionen am Audit-Log sind transparent
Klartext-Fehler
- Zugriff auf
/admin/auditohneaudit.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.assignedist 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 mitaudit.readund 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 mitactor_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)