Files
HiveGrid-Wireframes/02 Wireframes/P3 Querschnitt/WF-P3 Audit Log/WF-P3 Audit Log.md
T
davidandClaude Fable 5 e48a5a46e8 Plan Querschnitt-Pakete P3-P5 und Infrastruktur-Entscheidungen
- Feature Map: Regelwerk, Kanten-System, Paket-Canvas-Verknuepfungen, MD-Links
- Infrastruktur & Navigation: Sidebar-Abgleich, Einstellungen-Modell, Mobile, Gating
- WF-P3 Benachrichtigungen + Audit Log (validiert)
- WF-P4 Aufgaben (inkl. Topbar-Drawer-Delta) + Dateien (inkl. Teilen v1, CR an Dev)
- WF-P5 Integrationen (Sync-Verlauf als eigene Seiten)

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-08 20:47:46 +02:00

132 lines
5.6 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
---
kind: wireframe-package
project: HiveGrid Screen Project
ticket: D-P3
package: WF-P3 Audit Log
typ: Flow
status: Validiert
subframe: ""
canvas: "WF-P3 Audit Log.canvas"
---
# WF-P3 Audit Log
Status: Validiert (Screen-Liste)
Subframe-Link: -
Canvas: [Canvas](<WF-P3 Audit Log.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
```text
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
- [[S01 Protokoll-Ansicht]]
- [[S02 Exporte]]
- [[M01 Detail-Drawer]]
- [[M02 Export anlegen]]
- [[M03 Objekt-Verlauf-Drawer]]
---
## 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
- [x] Jeder Screen ist mit Umsetzung markiert.
- [x] Meldungs-/Error-State-Matrix ist ausgefüllt.
- [x] Banner/Inline-Meldungen sind dokumentiert.
- [ ] Subframe-Link ist eingetragen. *(Subframe erst nach explizitem OK)*