56 lines
5.9 KiB
Markdown
56 lines
5.9 KiB
Markdown
# D-DASH · Dashboard (3 Rollen-Layouts) + Cmd+K
|
|
|
|
> ⚠️ **KI→MCP-Pivot ([[AD-26]]):** Die **„KI"-Widget-Quelle entfällt** aus dem Widget-Katalog (kein KI-Layer in v1 — HiveGrid wird MCP-Server, [[VR-MCP]]). Die Widget-Registry/-Katalog bleibt; nur KI-Widgets fallen weg.
|
|
|
|
| | |
|
|
|---|---|
|
|
| **Typ** | Screen (Design) |
|
|
| **Owner** | David |
|
|
| **Phase** | P11 — Globale Suche & Dashboard (bedient `R-P11a`/`R-P11b`) |
|
|
| **Cycle/Fenster** | W3 — Kern-Kette & Kommunikation (Demo 2) · 2026-07-01 → fällig 2026-07-03 |
|
|
| **Status** | geplant |
|
|
|
|
> 🟦 **Bespoke + Compose:** Das **Cmd+K-Such-Modal ist BESPOKE** (klein); das **Dashboard** ist KPI+Widget-Compose; die Vollbild-Such-View aus A2. Deckt alle P11-Screens (Suche + Dashboard).
|
|
|
|
> 🟢 **Kein Pivot-Sonderfall** (P11 nicht Teil der projekt-zentrischen Kern-Kette). Aber: Such-Index + Dashboard-Widgets greifen auf den **`Projekt`-Kern** zu (EIN `Projekt`-Entity-Typ, kein separater Index-Typ je Pipeline). **v1 = nur 3 feste Rollen-Layouts (GF/Büro/Monteur)** ohne Drag&Drop (Layout-Persistenz + Custom-Widgets + Export → v2). Such-Backend = **Meilisearch-Keyword**; pgvector/Hybrid/RAG entfällt nach AD-26.
|
|
|
|
## Abhängigkeiten & Parallelität
|
|
- **Blocked by:** `D-D0b` (Archetypen, KPI-Kacheln, Charts, A5 Modal für Cmd+K)
|
|
- **Blockt:** `D-POLISH` (Politur baut u. a. auf Dashboard auf)
|
|
- **Bedient (Dev):** `R-P11a`/`R-P11b` (M24 Globale Suche + M20 Dashboard)
|
|
- **Subframe:** Pflicht je Route. Cmd+K-Modal **BESPOKE** (klein); Dashboard = KPI+Widget-Compose; Vollbild-Suche aus A2.
|
|
|
|
## Was wir bauen
|
|
Das **Cmd+K-Such-Modal** (global, gruppierte Treffer mit Match-Highlight), die **Vollbild-Such-View** mit Filtern und das **Dashboard mit 3 festen Rollen-Layouts** (GF/Büro/Monteur) inkl. Dashboard-Switcher.
|
|
|
|
## Benötigte Screens
|
|
| Screen [Route] | Kern-Inhalt | Archetyp |
|
|
|---|---|---|
|
|
| **Cmd+K-Such-Modal** [global] | Auto-fokussiertes Such-Eingabefeld, Live-Suche (300ms debounce) · Trefferliste **gruppiert nach Entity-Typ** mit Icon, Titel, Subtitle, **Match-Highlight-Snippet**, letzte-Aktivität (relativ) · Filter-Chips für Entity-Typ (Multi-Select: Kontakte/Projekte/Files/Tasks/Leads …) · Tastatur-Navigation (↑↓ + Enter öffnen, Cmd+Enter neuer Tab, Esc schließen) + Shortcut-Anzeige · Leer-Zustand: **RecentSearches** + Tipps · „Alle {n} Treffer zeigen" → Vollbild-Suche · Loading-Indikator | **BESPOKE** (klein) |
|
|
| Vollbild-Such-View [`/search`] | Such-Feld (aus URL-Param), volle Trefferliste (cursor-paginiert 50/Page) mit erweiterten Metadaten (Erstellt, Verantwortlicher, Tags) · **Filter-Sidebar** (Entity-Typ, Erstellt-Range, Verantwortlicher, Tags, modul-spezifisch z.B. Pipeline-Status, Toggle „Archivierte einbeziehen") · Trefferanzahl-Klartext („1.247 Treffer in 0,3 s") · Sortierung (Relevanz/Letzte Aktivität/Erstellt) · Klick → Ziel-Route | A2 |
|
|
| **Dashboard** [`/dashboard` bzw. `/`] | **3 feste Rollen-Layouts (kein Drag&Drop v1):** **GF** (Begrüßung, Sales-KPIs, Umsatz-Forecast einfach, Projekt-KPIs, Auslastung, offene Mängel, Team-heute) · **Büro** (Begrüßung, Projekt-KPIs, meine Tasks, Anrufe heute, HR-Anträge) · **Monteur 📱** (meine Termine heute, meine Projekte, meine Tasks) · Widgets: KPI-Kachel, Liste, Trend-Chart · Live-Update (SSE/WebSocket) + „Live-Updates pausieren" · Edit = **nur Widget-Filter/Zeitraum** · „Daten zuletzt aktualisiert vor X Min" bei veralteten Aggregaten | KPI + Widget-Compose |
|
|
| Dashboard-Switcher [im Dashboard-Header] | Verfügbare Dashboards (rollen-gematcht) auswählbar · Default-Routing nach Rolle | (Teil des Dashboard) |
|
|
|
|
*(Flow-Editor/Booking/Kalender/Signatur aus SCREEN-MAP §5 gehören zu P12/P16, nicht hierher. Custom-Widgets/Export + Drag&Drop-Grid = v2. Forecast/KPI-Datenquellen kommen aus P8.)*
|
|
|
|
## Features (muss abgedeckt sein)
|
|
- [ ] Cmd+K-Modal (global Hotkey, debounced, gruppierte Treffer, Match-Highlight, Tastatur-Navigation, RecentSearches) + Wechsel in Vollbild-Such-View mit Filtern
|
|
- [ ] Meilisearch-Keyword-Suche permission-aware (SearchAdapter je Modul); Server-side Permission-Filter (Trefferanzahl = erlaubte Treffer; Klartext „weitere Treffer, die du nicht siehst")
|
|
- [ ] 3 feste Rollen-Dashboards (GF/Büro/Monteur, SHK-Default geseedet) aus Widget-Katalog (Sales/Projekte/Tasks/HR/Activity/Comms/~~KI~~ → KI entfällt [[AD-26]])
|
|
- [ ] Dashboard-Widgets live (SSE/WebSocket) mit Aggregat-Cache + Lazy-Load/Skeleton; permission-gegated; Monteur-Dashboard mobile-first
|
|
- [ ] Edit nur Widget-Filter/Zeitraum (kein Grid-Editor v1); „zuletzt aktualisiert"-Hinweis
|
|
|
|
## UI-Elemente (Liste, KEIN Layout — Anordnung = Davids freie Hand)
|
|
Such-Eingabefeld mit Auto-Fokus + Debounce; Trefferliste gruppiert nach Entity-Typ mit Typ-Icon; Match-Highlight-Snippet; Relativ-Zeit; Entity-Typ-Filter-Chips (Multi-Select); Tastatur-Navigations-Highlight + Shortcut-Leiste; RecentSearches-Liste (Einzel-/Alle-Löschen); „Alle Treffer zeigen"-Link; Filter-Sidebar (Entity-Typ/Date-Range/Verantwortlicher/Tags/modul-spezifisch + Archiviert-Toggle); Sortier-Auswahl; Trefferanzahl-Klartext; Pagination; KPI-Kachel (Wert/Label/Trend-Pfeil/Vergleich); Listen-Widget; Trend-Chart (Linie/Balken/Donut); Begrüßungs-Widget; Dashboard-Switcher; Widget-Filter-/Zeitraum-Konfig (kein Grid-Editor v1); „Live-Updates pausieren"-Toggle; „zuletzt aktualisiert"-Hinweis; Skeleton-Loading; Empty-/Keine-Treffer-/Fehler-/Permission-Denied-States (Klartext).
|
|
|
|
## Quellen (granular)
|
|
- `designer-briefs/P11-suche-dashboard.md` (vollständiger Brief — Suche + Dashboard, diese Doc ist sein Ticket-Destillat)
|
|
- `ENTITY-MODEL.md` → Domäne 6 (Suche & Dashboard; Projekt-Kern als EIN Index-/Widget-Typ)
|
|
- `SCREEN-MAP.md` → §5 Dashboard/Cmd+K · `ROADMAP.md` → Phase 11 · `_bmad-output/specs/M24-globale-suche.md`, `M20-dashboard.md`
|
|
|
|
## Davids Delta (David füllt aus)
|
|
- [ ] Überschriebene/geänderte Spec-Punkte:
|
|
- [ ] Neue UI/UX-Entscheidungen:
|
|
- [ ] Subframe-Screen-Link(s):
|
|
- [ ] Offene Fragen an Dev:
|