Track HiveGrid Cloud planning reference

This commit is contained in:
david committed 2026-06-26 20:48:01 +02:00
1 parent b3d5ea6764
commit e341c5938a
5784 files changed
+1104929 -3

No files matched your search

@@ -0,0 +1,57 @@
# D-P3 · Screens P3 — Querschnitts-Oberflächen (Audit / Notif / Sprache DE)
> ⚠️ **KI→MCP-Pivot ([[AD-26]]):** Der Audit-Actor-Kind **„KI" wird zu „MCP/Agent" umgedeutet** — er kennzeichnet künftig externe KI-Clients, die über den MCP-Server ([[VR-MCP]]) auf HiveGrid zugreifen (kein eigenes LLM in v1). Marker-Liste = User / Automation / **MCP/Agent** / Admin.
| | |
|---|---|
| **Typ** | Screen (Design) |
| **Owner** | David |
| **Phase** | P3 — Querschnitts-Oberflächen (bedient `AK-P3`) |
| **Cycle/Fenster** | W2 — Plattform & CRM (Demo 1) · fällig 2026-06-21 · Gate W2 (Noah-Demo #1) |
| **Status** | geplant (NEU — schließt P3-Screen-Lücke) |
## Abhängigkeiten & Parallelität
- **Blocked by:** `D-D0a` (App-Shell + Topbar inkl. Notification-Bell-Slot), `D-D0b` (Archetypen A2 Liste + Drawer, A6 Settings) — die P3-Screens komponieren aus den D0-Archetypen
- **Bedient (Dev):** `AK-P3` (Audit-Viewer/Export, Notification-Center/Settings, Sprach-Settings DE)
- **Läuft parallel zu:** Akeshans `AK-P3` (gleiches Fenster); Service-Kerne (Hash-Kette, `notify()`, i18n-Engine) liegen schon in P1 — P3 liefert nur die Bedien-Oberflächen
- **Subframe:** Pflicht je Route (A2 Liste + Diff-Drawer, A6 Settings, Notification-Drawer aus Topbar)
## Was wir bauen
Die **Bedien-Oberflächen der in P1 gebauten Plattformdienste**: Audit-Viewer (gefilterter, permission-gegateter Trail mit deutschem Summary-Text, Actor-Kind-Marker, Diff-Detail-Drawer, NDJSON/CSV-Export ins Hetzner-Object-Storage mit Zweck-Pflichtfeld + Export-Job-Liste), Notification-Center (In-App via SSE, Read-Status, Deeplink, Tabs Alle/Ungelesen, Bulk-Clear), Notification-Settings (Event-Typen je Modul, In-App/Email-Toggle, Master „alle Emails aus") sowie der DE-Sprach-Hinweis (v1 DE-only).
## Benötigte Screens
| Screen [Route] | Kern-Inhalt | Archetyp |
|---|---|---|
| Audit-Viewer [`/admin/audit`] | Zeit, Actor (+Kind-Marker User/Automation/~~KI~~ **MCP/Agent** ([[AD-26]])/Admin visuell unterscheidbar), Aktion, Subjekt, **deutscher Summary-Text** · Filter (Zeitraum Default 30 T / max 24 Mon ohne Export, Actor, Kategorie, Subjekt-Typ) · Quick-Filter (Klick auf Actor/Subject/Action) · **Detail-Drawer mit Feld-für-Feld-Diff** (Vorher/Nachher, sensible Diffs nur „Wert geändert") + „Verlauf dieses Objekts"/„Ähnliche Einträge" · Export-Button (CSV/NDJSON, Zweck-Pflichtfeld) | A2 + Drawer |
| Audit-Export-Jobs [`/admin/audit/exports` + `/new` + `/:id`] | Export-Job-Liste · Anlage (Filter-Kriterien wie Listen-View, Format, Zweck-Pflichtfeld) · Job-Status + Download (signed-URL) | A2 |
| Notification-Center [Topbar-Drawer + `/notifications`] | Einträge: Titel, Body, Actor, Zeit, Read-Status, Prioritäts-Marker · Tabs Alle/Ungelesen · Mark-read/unread, Klick→Deeplink · Bulk-Clear · Klartext bei pausierten Emails (Bounce: „Emails an dich kommen aktuell nicht an") | A2 + Drawer |
| Notification-Settings [`/settings/notifications`] | Event-Typen nach Modul gruppiert, je **In-App/Email-Toggle** + Priority-Selektor · Master-Toggle „alle Emails aus" (Klartext: betrifft auch zukünftige Event-Typen) | A6 |
**Eingebettete Oberflächen (kein eigener Screen, aber zu designen):** Per-Subject-Audit-Drawer (wiederverwendbar in jeder Detail-View, filtert auf `subject_type+subject_id`, `audit.read`) · Per-User-Audit-Drawer in `/admin/users/:id` · DE-Sprach-Hinweis „fest DE" im Profil-Screen (P2/D-P2).
*(Quiet-Hours / Bündelung / Push-Devices-Liste / Retention-Editor / Legal-Hold / Saved-Views / Sprach-Wechsler → v2.)*
## Features (muss abgedeckt sein)
- [ ] Audit-Viewer permission-gegated (`audit.read`), server-side-Filter zwingend, deutscher Summary-Text, Actor-Kind-Marker
- [ ] Diff-Detail-Drawer (Feld-für-Feld Vorher/Nachher; Maskierung bei sensiblen Werten) + „Verlauf dieses Objekts"/„Ähnliche Einträge"
- [ ] Compliance-Export (NDJSON/CSV) mit Zweck-Pflichtfeld + Export-Job-Status/Download; fixe Default-Retention (kein Editor v1)
- [ ] Notification-Center (SSE, Read-Status, Deeplink, Tabs Alle/Ungelesen, Bulk-Clear, Bounce-Klartext)
- [ ] Notification-Präferenzen pro User (Event-Typen je Modul, In-App/Email-Toggle, Priority-Threshold, Master „alle Emails aus")
- [ ] DE-Sprach-Hinweis (v1 fest DE — kein Wechsler); alle Oberflächen-Strings durch `t()`
- [ ] Empty/Loading/Permission-Denied/Fehler-States (Klartext, z. B. leerer Center „Keine Benachrichtigungen …")
## UI-Elemente (Liste, KEIN Layout — Anordnung = Davids freie Hand)
Audit-Daten-Tabelle (server-paginiert) mit Actor-Kind-Marker (User/Automation/~~KI~~ **MCP/Agent** ([[AD-26]])/Admin visuell unterscheidbar), deutschem Summary-Text, Subjekt-Verlinkung; Filter-Bar (Datum-Range-Selektor mit Presets, Actor-/Kategorie-/Subjekt-Typ-Filter) mit Quick-Filter-Klick auf Tabellenwerte; Detail-Drawer mit Feld-für-Feld-Diff-Visualisierung (Hinzufügung/Löschung/Änderung farblich, JSON-Strukturdiff, Maskierungs-Hinweis) + „Verlauf dieses Objekts"/„Ähnliche Einträge"-Aktionen; Export-Button → Export-Job-Anlage-Dialog (Format CSV/NDJSON + Zweck-Pflichtfeld); Export-Job-Liste mit Status-Badge + Download-Link; wiederverwendbarer Per-Subject-/Per-User-Audit-Drawer; Notification-Liste/-Drawer (Titel/Body/Actor/Zeit/Read-Status/Prioritäts-Marker, Tabs Alle/Ungelesen, Mark-read/unread, Deeplink-Klick, Bulk-Clear, Bounce-Klartext); Notification-Bell-Anbindung (Badge liegt in D0-Topbar); Notification-Präferenzen-Editor (Event-Typen je Modul gruppiert, je Zeile In-App-/Email-Toggle + Priority-Selektor, Master-„alle-Emails-aus"-Toggle mit Klartext); DE-Sprach-Hinweis-Element; Empty-/Loading-/Permission-Denied-/Fehler-States (Klartext).
## Quellen (granular)
- `designer-briefs/P03-querschnitts-oberflaechen.md` (vollständiger Brief — diese Doc ist sein Ticket-Destillat)
- `ENTITY-MODEL.md` → **Domäne 2: Querschnitt** (AuditEntry, Notification, NotificationPreference, NotificationDevice; i18n = Felder, keine Tabelle)
- `ROADMAP.md` → Phase 3 · `REQUIREMENTS.md` → Modul 21/22/30 (`REQ-audit-retention-export`, `-audit-permissions`, `-notification-versand-pipeline`, `-i18n-outbound`) · `PHASE-SOURCES.md` → Phase 3
- `_bmad-output/specs/M21-audit-log.md`, `M22-notifications.md`, `M30-i18n.md` (Oberflächen-Teile; Service-Kerne liegen in P1)
- Dev-Pendant: `ticket-docs/AK-P3.md`
## Davids Delta (David füllt aus)
- [ ] Überschriebene/geänderte Spec-Punkte:
- [ ] Neue UI/UX-Entscheidungen:
- [ ] Subframe-Screen-Link(s):
- [ ] Offene Fragen an Dev: