Files
HiveGrid-Wireframes/02 Wireframes/P3 Audit Log/WF-P3 Audit Log/WF-P3 Audit Log.md
T

5.6 KiB
Raw Blame History

kind, project, ticket, package, typ, status, subframe, canvas
kind project ticket package typ status subframe canvas
wireframe-package HiveGrid Screen Project D-P3 WF-P3 Audit Log Flow Validiert WF-P3 Audit Log.canvas

WF-P3 Audit Log

Status: Validiert (Screen-Liste)
Subframe-Link: -
Canvas: Canvas
Stand: 2026-07-08


1. Kurzfassung

Das Aktivitäts-Protokoll: „Wer hat wann was getan" als deutscher Klartext-Satz, mit Vorher/Nachher-Vergleich, Export mit Zweck-Pflichtangabe und einem wiederverwendbaren „Verlauf dieses Objekts"-Drawer für alle Detailseiten. Der Protokoll-Dienst existiert schon (Dev P1) — wir bauen die Bedienung.


2. Intent Check

Frage Antwort
Welches Ticket/Modul ist betroffen? D-P3 (Teil Audit), Dev-Pendant AK-P3
Was soll der Nutzer am Ende schaffen? Nachvollziehen, wer was geändert hat; bei Bedarf belegen (Export); Verlauf direkt am Objekt sehen
Flow, Screen, Zustand oder Doku? Ein Screen mit zwei Reitern + drei Drawer/Modals
Welche Planning-Quellen wurden geprüft? ticket-docs/D-P3.md, SCREEN-MAP §2, HiveGrid Map
Was ist sicher im Scope? Protokoll-Tabelle, Filter/Sortierung, Diff-Drawer, Export mit Zweck, Objekt-Verlauf-Drawer
Was ist sicher nicht im Scope? Aufbewahrungs-Editor, Legal Hold, gespeicherte Ansichten (v2)
Admin/Normalrolle-Unterschiede? Nur mit Recht audit.read sichtbar (Admin-Bereich)
Unsichere Annahmen? Ob Diff-Drawer und Objekt-Verlauf-Drawer eine gemeinsame Komponente teilen — Subframe-Bau zeigt es

3. Scope

Punkt Inhalt
Ticket/Modul D-P3 · Audit
Nutzerrolle Admin (Maximalansicht, Recht audit.read)
Startpunkt Einstellungen/Verwaltung → Aktivitäts-Protokoll (/admin/audit)
Ziel Eintrag gefunden, verstanden (Diff), ggf. exportiert
Haupt-Archetyp A2 Liste + Drawer · A5 Modal
Bespoke-Anteil Keiner — Baukasten-Compose; Diff-Ansicht ist die aufwendigste Einzelkomponente
Out of scope Retention-Editor, Legal-Hold, Saved-Views (v2)

4. Entscheidungen (validiert 2026-07-08)

Entscheidung Status Notiz
Export-Übersicht als Reiter im Protokoll-Screen (Option B) genommen Reiter „Protokoll" / „Exporte" — alles an einem Ort
Sortier-/Filterbarkeit: nach Mitarbeiter, Zeitraum, Bereich (Modul, z. B. Aufgaben), Änderungs-Art genommen Davids Ergänzung; dazu Quick-Filter per Klick auf Tabellenwerte
Actor-Marker: Mensch / Automation / MCP-Agent / Admin genommen Pivot AD-26 („KI" → „MCP/Agent"), passt zur Sidebar-Entscheidung
Detail als Drawer (nicht eigene Seite) genommen Feld-für-Feld Vorher/Nachher, farbig
Export-Anlage als Modal mit Zweck-Pflichtfeld genommen übernimmt die aktuell gesetzten Filter
„Verlauf dieses Objekts" als eigener wiederverwendbarer Drawer genommen wird das Muster für alle Detailseiten (Kontakt, Projekt, …)

Happy Path

  1. Admin öffnet Aktivitäts-Protokoll → Tabelle mit Klartext-Sätzen, Default letzte 30 Tage.
  2. Filtern/Sortieren (Mitarbeiter, Zeitraum, Bereich, Änderungs-Art) oder Klick auf einen Tabellenwert als Schnellfilter.
  3. Zeile öffnen → Detail-Drawer mit Vorher/Nachher; von dort „Verlauf dieses Objekts" oder „Ähnliche Einträge".
  4. Bei Bedarf „Exportieren" → Modal (Format + Zweck-Pflicht) → Job erscheint im Reiter „Exporte" → Download, wenn fertig.

Meldungs-/Error-States (validiert)

Ereignis UI-Form Blockiert? Bauen? Copy/Notiz
Kein Recht audit.read A7-Zustand „kein Zugriff" ja Wiederverwenden Baukasten-Zustand
Export fehlgeschlagen Status-Badge rot + „erneut versuchen" nein Nur dokumentieren in der Job-Liste
Sensibler Wert maskiert Inline-Hinweis im Diff nein Nur dokumentieren „Aus Datenschutzgründen nur ‚Wert geändert'"
Zeitraum > 24 Monate Inline am Filter nein Nur dokumentieren „Ältere Einträge nur per Export"
Leere Liste (Filter zu eng) Leer-Zustand nein Nur dokumentieren „Keine Einträge für diese Filter" + Filter zurücksetzen

7. Validierte Screen-Liste

ID Screen/Zustand Typ Umsetzung Ort Status
S01 Protokoll-Ansicht (Reiter „Protokoll") Screen Bauen /admin/audit Validiert
S02 Exporte (Reiter im selben Screen) Screen/Tab Bauen /admin/audit, Reiter Validiert
M01 Detail-Drawer (Vorher/Nachher) Drawer Bauen aus S01 Validiert
M02 Export anlegen Modal Bauen aus S01/S02 Validiert
M03 Objekt-Verlauf-Drawer (wiederverwendbar) Drawer Bauen in jeder Detailseite Validiert
D01 Maskierungs-Hinweis Inline Nur dokumentieren in M01 Validiert
D02 24-Monate-Hinweis Inline Nur dokumentieren Filter in S01 Validiert

8. Grid

Verwaltung -> S01 <-> S02 (Reiter)
S01 -> M01 (Zeile oeffnen) -> M03 (Verlauf dieses Objekts)
S01/S02 -> M02 (Export anlegen) -> S02 (Job angelegt)
Detailseiten (Kontakt, Projekt, ...) -> M03

9. Screen-Pakete


10. Offene Fragen

  • Teilen M01 (Diff) und M03 (Objekt-Verlauf) eine Drawer-Komponente? → beim Subframe-Bau klären
  • Klartext-Sätze: genaue Formulierungs-Muster („Max hat … geändert") kommen von Dev (M002/i18n) — UI zeigt nur den Satz

Handoff-Check

  • Jeder Screen ist mit Umsetzung markiert.
  • Meldungs-/Error-State-Matrix ist ausgefüllt.
  • Banner/Inline-Meldungen sind dokumentiert.
  • Subframe-Link ist eingetragen. (Subframe erst nach explizitem OK)