Files
HiveGrid-Wireframes/03 Quellen und Referenzen/hivegrid-cloud/.planning/ticket-docs/D-DASH.md
T

5.8 KiB

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: Die Spotlight-Suche ist BESPOKE (klein); das Dashboard ist KPI+Widget-Compose. Deckt alle P11-Screens (Spotlight-Suche + Dashboard).

Scope-Schnitt 2026-07-12 (verbindlich): Es gibt in v1 keine nutzerseitige /search-Vollseite. Globale Suche bedeutet Desktop-Modal per Cmd+K/Ctrl+K oder Header-Suchsymbol und mobiles viewportfüllendes Overlay über das Header-Suchsymbol. /search/api ist ein interner Resource-Endpunkt und kein Design-Screen. R-P11a darf nach AD-28 mit Interim-UI fertig werden; das finale D-DASH-Delta bleibt als design-nachzug offen.

🟢 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); der Spotlight-Scope-Schnitt lässt R-P11b unverändert
  • Subframe: Pflicht je Screen. Spotlight-Suche BESPOKE (klein); Dashboard = KPI+Widget-Compose.

Was wir bauen

Die globale Spotlight-Suche (Desktop-Modal, mobiles viewportfüllendes Overlay, gruppierte Treffer mit Match-Highlight) und das Dashboard mit 3 festen Rollen-Layouts (GF/Büro/Monteur) inkl. Dashboard-Switcher.

Benötigte Screens

Screen [Route] Kern-Inhalt Archetyp
Spotlight-Suche [global, keine nutzerseitige Route] Desktop als Modal, Mobile als viewportfüllendes Overlay · 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/Ctrl+Enter neuer Tab, Esc schließen) + Shortcut-Anzeige · Leer-Zustand: RecentSearches + Tipps · Loading-, Keine-Treffer- und Fehlerzustand · Klick/Enter öffnet direkt die Ziel-Route BESPOKE (klein)
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 gehören zu P12/P16, nicht hierher. Custom-Widgets/Export + Drag&Drop-Grid = v2. Forecast/KPI-Datenquellen kommen aus P8.)

Features (muss abgedeckt sein)

  • Spotlight-Suche (Desktop per Cmd+K/Ctrl+K oder Header-Suchsymbol als Modal, Mobile per Header-Suchsymbol viewportfüllend; debounced, gruppierte Treffer, Match-Highlight, Tastatur-Navigation, RecentSearches)
  • 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; Desktop-Modal und mobiles viewportfüllendes Overlay; Trefferliste gruppiert nach Entity-Typ mit Typ-Icon; Match-Highlight-Snippet; Relativ-Zeit; Entity-Typ-Filter-Chips (Multi-Select); Tastatur-Navigations-Highlight + Shortcut-Leiste; private RecentSearches-Liste ohne manuelle Löschverwaltung in R-P11a; Loading-, Empty-/Keine-Treffer-/Fehler-/Permission-Denied-States (Klartext); 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.

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)

Davids Delta (David füllt aus)

  • Überschriebene/geänderte Spec-Punkte:
  • Neue UI/UX-Entscheidungen:
  • Subframe-Screen-Link(s):
  • Offene Fragen an Dev: