chore(repo): sync wireframe structure and references
This commit is contained in:
1 parent
05d2d5777f
commit
d953a79e95
453 files changed
+36639
-621
No files matched your search
@@ -0,0 +1,61 @@
|
||||
---
|
||||
kind: screen
|
||||
project: HiveGrid Screen Project
|
||||
ticket: D-P3
|
||||
package: WF-P3 Audit Log
|
||||
id: M01
|
||||
screen: Detail-Drawer
|
||||
typ: Drawer
|
||||
umsetzung: Bauen
|
||||
status: Validiert
|
||||
route: "aus S01, Zeile oeffnen"
|
||||
subframe: ""
|
||||
---
|
||||
|
||||
# M01 — Detail-Drawer
|
||||
|
||||
## Ziel
|
||||
|
||||
Einen Eintrag im Detail verstehen: was genau hat sich geändert?
|
||||
|
||||
## Pattern / Archetyp
|
||||
|
||||
Drawer (A2/A3-Baustein) über der Protokoll-Tabelle.
|
||||
|
||||
## Daten
|
||||
|
||||
- Kopf: Klartext-Satz, Actor mit Art-Marker, Zeit, Subjekt (verlinkt)
|
||||
- **Feld-für-Feld-Vergleich**: hinzugefügt / geändert / entfernt farblich unterschieden, Vorher → Nachher
|
||||
- Struktur-Vergleich für komplexe Felder (JSON aufgeklappt)
|
||||
- Maskierungs-Hinweis bei sensiblen Werten
|
||||
|
||||
## Aktionen
|
||||
|
||||
- „Verlauf dieses Objekts" → [[M03 Objekt-Verlauf-Drawer]] (gefiltert auf das Subjekt)
|
||||
- „Ähnliche Einträge" → setzt Quick-Filter in S01
|
||||
- Subjekt öffnen (Sprung zur Detailseite)
|
||||
|
||||
## Meldungsentscheidung
|
||||
|
||||
| Ereignis | UI-Form | Blockiert? | Umsetzung | Copy/Notiz |
|
||||
|---|---|---|---|---|
|
||||
| Sensibler Wert | Inline im Diff | nein | Nur dokumentieren | „Aus Datenschutzgründen nur ‚Wert geändert'" |
|
||||
|
||||
## Zustände
|
||||
|
||||
| Zustand | Beschreibung | Umsetzung |
|
||||
|---|---|---|
|
||||
| Laden | Skeleton (A7) | Wiederverwenden |
|
||||
| Fehler | A7-Fehlerzustand | Wiederverwenden |
|
||||
|
||||
## Permissions / Gates
|
||||
|
||||
Wie S01.
|
||||
|
||||
## Subframe
|
||||
|
||||
- (erst nach explizitem OK)
|
||||
|
||||
## Notizen
|
||||
|
||||
- Beim Bau echte Drawer-Struktur verwenden (kein Fake-Overlay) — Regel aus AI README.
|
||||
@@ -0,0 +1,59 @@
|
||||
---
|
||||
kind: screen
|
||||
project: HiveGrid Screen Project
|
||||
ticket: D-P3
|
||||
package: WF-P3 Audit Log
|
||||
id: M02
|
||||
screen: Export anlegen
|
||||
typ: Modal
|
||||
umsetzung: Bauen
|
||||
status: Validiert
|
||||
route: "aus S01/S02, Exportieren-Knopf"
|
||||
subframe: ""
|
||||
---
|
||||
|
||||
# M02 — Export anlegen
|
||||
|
||||
## Ziel
|
||||
|
||||
Protokoll-Auszug als Datei anfordern — mit dokumentiertem Zweck (Compliance).
|
||||
|
||||
## Pattern / Archetyp
|
||||
|
||||
A5 Dialog (echtes Modal: DialogLayout → Dialog → Dialog.Content).
|
||||
|
||||
## Daten
|
||||
|
||||
- Format-Wahl: CSV / NDJSON
|
||||
- **Zweck (Pflicht-Textfeld)** — z. B. „Anfrage Steuerberater"
|
||||
- Zusammenfassung der übernommenen Filter (Zeitraum, Mitarbeiter, Bereich …) mit „Filter ändern"-Hinweis (führt zurück zu S01)
|
||||
|
||||
## Aktionen
|
||||
|
||||
- „Export anlegen" → Job wird erstellt, Wechsel zum Reiter [[S02 Exporte]] + Toast
|
||||
- Abbrechen
|
||||
|
||||
## Meldungsentscheidung
|
||||
|
||||
| Ereignis | UI-Form | Blockiert? | Umsetzung | Copy/Notiz |
|
||||
|---|---|---|---|---|
|
||||
| Zweck leer | Inline-Validierung | ja (Feld) | Nur dokumentieren | „Bitte Zweck angeben — wird protokolliert" |
|
||||
|
||||
## Zustände
|
||||
|
||||
| Zustand | Beschreibung | Umsetzung |
|
||||
|---|---|---|
|
||||
| Anlegen läuft | Button-Spinner | Wiederverwenden |
|
||||
| Fehler | Toast mit Klartext | Wiederverwenden |
|
||||
|
||||
## Permissions / Gates
|
||||
|
||||
Wie S01.
|
||||
|
||||
## Subframe
|
||||
|
||||
- (erst nach explizitem OK)
|
||||
|
||||
## Notizen
|
||||
|
||||
- Der Zweck erscheint später in der Job-Liste (S02) und ist selbst audit-geloggt.
|
||||
@@ -0,0 +1,60 @@
|
||||
---
|
||||
kind: screen
|
||||
project: HiveGrid Screen Project
|
||||
ticket: D-P3
|
||||
package: WF-P3 Audit Log
|
||||
id: M03
|
||||
screen: Objekt-Verlauf-Drawer
|
||||
typ: Drawer (wiederverwendbar)
|
||||
umsetzung: Bauen
|
||||
status: Validiert
|
||||
route: "in jeder Detailseite (Kontakt, Projekt, ...)"
|
||||
subframe: ""
|
||||
---
|
||||
|
||||
# M03 — Objekt-Verlauf-Drawer
|
||||
|
||||
## Ziel
|
||||
|
||||
Direkt an einem Datensatz sehen: „Was ist mit diesem Objekt passiert?" — ohne ins Admin-Protokoll zu wechseln. **Wiederverwendbares Muster für alle Detailseiten.**
|
||||
|
||||
## Pattern / Archetyp
|
||||
|
||||
Drawer mit kompakter A2-Liste, gefiltert auf das aktuelle Objekt.
|
||||
|
||||
## Daten
|
||||
|
||||
- Kompakte Einträge: Zeit · Actor mit Art-Marker · Klartext-Satz
|
||||
- Kopf: Objekt-Name + Typ
|
||||
|
||||
## Aktionen
|
||||
|
||||
- Eintrag öffnen → [[M01 Detail-Drawer]] (Vorher/Nachher)
|
||||
- „Im Protokoll öffnen" → [[S01 Protokoll-Ansicht]] mit gesetztem Objekt-Filter
|
||||
|
||||
## Meldungsentscheidung
|
||||
|
||||
| Ereignis | UI-Form | Blockiert? | Umsetzung | Copy/Notiz |
|
||||
|---|---|---|---|---|
|
||||
| — | — | — | — | — |
|
||||
|
||||
## Zustände
|
||||
|
||||
| Zustand | Beschreibung | Umsetzung |
|
||||
|---|---|---|
|
||||
| Leer | „Noch keine Änderungen protokolliert" | Nur dokumentieren |
|
||||
| Laden | Skeleton (A7) | Wiederverwenden |
|
||||
| Fehler | A7-Fehlerzustand | Wiederverwenden |
|
||||
|
||||
## Permissions / Gates
|
||||
|
||||
Nur sichtbar mit `audit.read` — ohne Recht wird der Einstiegs-Knopf auf der Detailseite gar nicht angezeigt.
|
||||
|
||||
## Subframe
|
||||
|
||||
- (erst nach explizitem OK)
|
||||
|
||||
## Notizen
|
||||
|
||||
- Einstieg auf Detailseiten: kleiner „Verlauf"-Knopf (genaue Platzierung entscheidet das jeweilige Feature-Paket, z. B. D-CRM Kontakt-Detail).
|
||||
- Offen: teilt sich mit M01 eine Drawer-Komponente? → Subframe-Bau.
|
||||
@@ -0,0 +1,64 @@
|
||||
---
|
||||
kind: screen
|
||||
project: HiveGrid Screen Project
|
||||
ticket: D-P3
|
||||
package: WF-P3 Audit Log
|
||||
id: S01
|
||||
screen: Protokoll-Ansicht
|
||||
typ: Admin Liste
|
||||
umsetzung: Bauen
|
||||
status: Validiert
|
||||
route: "/admin/audit"
|
||||
subframe: ""
|
||||
---
|
||||
|
||||
# S01 — Protokoll-Ansicht
|
||||
|
||||
## Ziel
|
||||
|
||||
Auf einen Blick nachvollziehen, wer wann was geändert hat — in verständlichen deutschen Sätzen.
|
||||
|
||||
## Pattern / Archetyp
|
||||
|
||||
A2 Liste (server-paginiert) mit Filter-Leiste und Reitern „Protokoll" / „Exporte" ([[S02 Exporte]]).
|
||||
|
||||
## Daten
|
||||
|
||||
- Tabelle, neueste zuerst: Zeit · Mitarbeiter/Actor mit **Art-Marker** (Mensch / Automation / MCP-Agent / Admin, visuell unterscheidbar) · Bereich (Modul) · Änderungs-Art (erstellt/geändert/gelöscht …) · Subjekt (verlinkt) · **deutscher Klartext-Satz**
|
||||
- Filter-Leiste: Zeitraum (Presets, Default 30 Tage, max. 24 Monate), Mitarbeiter, Bereich (z. B. Aufgaben, Kontakte, Projekte), Änderungs-Art, Subjekt-Typ
|
||||
- Sortierbare Spalten (Zeit, Mitarbeiter, Bereich)
|
||||
- Quick-Filter: Klick auf einen Tabellenwert (Mitarbeiter, Subjekt, Aktion) setzt den Filter
|
||||
|
||||
## Aktionen
|
||||
|
||||
- Zeile öffnen → [[M01 Detail-Drawer]]
|
||||
- „Exportieren" → [[M02 Export anlegen]] (übernimmt aktuelle Filter)
|
||||
- Reiter-Wechsel zu [[S02 Exporte]]
|
||||
- Filter zurücksetzen
|
||||
|
||||
## Meldungsentscheidung
|
||||
|
||||
| Ereignis | UI-Form | Blockiert? | Umsetzung | Copy/Notiz |
|
||||
|---|---|---|---|---|
|
||||
| Zeitraum > 24 Monate | Inline am Filter | nein | Nur dokumentieren | „Ältere Einträge nur per Export" |
|
||||
|
||||
## Zustände
|
||||
|
||||
| Zustand | Beschreibung | Umsetzung |
|
||||
|---|---|---|
|
||||
| Leer | „Keine Einträge für diese Filter" + Zurücksetzen-Knopf | Nur dokumentieren |
|
||||
| Laden | Skeleton-Tabelle (A7) | Wiederverwenden |
|
||||
| Fehler | A7-Fehlerzustand | Wiederverwenden |
|
||||
| Keine Berechtigung | A7 „kein Zugriff" (Recht `audit.read`) | Wiederverwenden |
|
||||
|
||||
## Permissions / Gates
|
||||
|
||||
Nur mit `audit.read` (Admin-Bereich). Filter laufen server-seitig.
|
||||
|
||||
## Subframe
|
||||
|
||||
- (erst nach explizitem OK)
|
||||
|
||||
## Notizen
|
||||
|
||||
- Klartext-Satz-Formulierungen liefert Dev (Fehler-/Text-Katalog); UI reserviert dafür die Hauptspalte.
|
||||
@@ -0,0 +1,59 @@
|
||||
---
|
||||
kind: screen
|
||||
project: HiveGrid Screen Project
|
||||
ticket: D-P3
|
||||
package: WF-P3 Audit Log
|
||||
id: S02
|
||||
screen: Exporte
|
||||
typ: Admin Liste (Reiter)
|
||||
umsetzung: Bauen
|
||||
status: Validiert
|
||||
route: "/admin/audit (Reiter Exporte)"
|
||||
subframe: ""
|
||||
---
|
||||
|
||||
# S02 — Exporte
|
||||
|
||||
## Ziel
|
||||
|
||||
Angeforderte Protokoll-Exporte im Blick: Status sehen, fertige herunterladen.
|
||||
|
||||
## Pattern / Archetyp
|
||||
|
||||
A2 Liste als zweiter Reiter der Protokoll-Ansicht ([[S01 Protokoll-Ansicht]]).
|
||||
|
||||
## Daten
|
||||
|
||||
- Job-Liste: angelegt am · von wem · Zweck (Pflichttext aus der Anlage) · Format (CSV/NDJSON) · Filter-Zusammenfassung (Zeitraum, Bereich …) · Status-Badge (in Arbeit / fertig / fehlgeschlagen) · Download-Link (wenn fertig)
|
||||
|
||||
## Aktionen
|
||||
|
||||
- Download (fertiger Job)
|
||||
- „Erneut versuchen" (fehlgeschlagener Job)
|
||||
- „Exportieren" → [[M02 Export anlegen]]
|
||||
|
||||
## Meldungsentscheidung
|
||||
|
||||
| Ereignis | UI-Form | Blockiert? | Umsetzung | Copy/Notiz |
|
||||
|---|---|---|---|---|
|
||||
| Export fehlgeschlagen | Status-Badge + Aktion | nein | Nur dokumentieren | Klartext-Grund + „erneut versuchen" |
|
||||
|
||||
## Zustände
|
||||
|
||||
| Zustand | Beschreibung | Umsetzung |
|
||||
|---|---|---|
|
||||
| Leer | „Noch keine Exporte" + Exportieren-Knopf | Nur dokumentieren |
|
||||
| Laden | Skeleton (A7) | Wiederverwenden |
|
||||
| Fehler | A7-Fehlerzustand | Wiederverwenden |
|
||||
|
||||
## Permissions / Gates
|
||||
|
||||
Wie S01 (`audit.read`).
|
||||
|
||||
## Subframe
|
||||
|
||||
- (erst nach explizitem OK)
|
||||
|
||||
## Notizen
|
||||
|
||||
- Nach Anlage in M02 wechselt die Ansicht hierher + Toast „Export angelegt".
|
||||
Reference in new issue
Block a user