- 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>
5.6 KiB
5.6 KiB
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
- Admin öffnet Aktivitäts-Protokoll → Tabelle mit Klartext-Sätzen, Default letzte 30 Tage.
- Filtern/Sortieren (Mitarbeiter, Zeitraum, Bereich, Änderungs-Art) oder Klick auf einen Tabellenwert als Schnellfilter.
- Zeile öffnen → Detail-Drawer mit Vorher/Nachher; von dort „Verlauf dieses Objekts" oder „Ähnliche Einträge".
- 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)