Files
HiveGrid-Wireframes/hivegrid-cloud/.planning/designer-briefs/P11-suche-dashboard.md
T

6.5 KiB
Raw Blame History

Designer-Brief · P11 — Globale Suche & Dashboard

Phase: 11/21 · Module: M24 (Globale Suche) + M20 (Dashboard) · Owner-Dev: Raffael (R-P11a/b) · Designer: David (Paket Fr 03.07.) Quellen: ROADMAP.md §Phase 11 · ENTITY-MODEL.md Domäne 6 (Suche & Dashboard) · SCREEN-MAP.md §5 (Dashboard + Cmd+K) · REQUIREMENTS.md (REQ-suche-, REQ-dashboard-) · _bmad-output/specs/M24-globale-suche.md, _bmad-output/specs/M20-dashboard.md Subframe: Pflicht je Route. Cmd+K-Such-Modal ist BESPOKE (klein); Dashboard = KPI+Widget-Compose; Vollbild-Suche aus A2.

🟢 Kein Pivot-Sonderfall (P11 ist nicht Teil der projekt-zentrischen Kern-Kette). Aber: Such-Index + Dashboard-Widgets greifen auf den Projekt-Kern zu (nicht mehr getrennte Deal-/Project-Entitäten). In M24-Spec stehen Entity-Typen deal | project | order — im Pivot-Modell ist das EIN Projekt-Entity-Typ (Pipeline-Typ = View, kein separater Index-Typ je Pipeline). In M20-Spec sind 7 Rollen-Default-Dashboards beschrieben — v1 liefert nur 3 feste Rollen-Layouts (GF/Büro/Monteur) ohne Drag&Drop (Scope-Schnitt 12.06.; User-Layout-Persistenz + Custom-Widgets + Export → v2). Die Widget-Registry bleibt voll gebaut (Inversion M064→M147). pgvector/Hybrid-Suche ist v2 — v1 = Meilisearch-Keyword-Suche (AD-5 sequenziert); die embedding-Spalte/EmbeddingProviderJob sind nur Andock-Halter.

Was dieses Modul tut (Kurzfassung)

Suche (M24): Eine permission-aware Keyword-Suche über alle Entitäten via Meilisearch (SearchAdapter pro Modul, Outbox-Index-Updates), bedienbar per Cmd+K-Modal (global, debounced, RecentSearches) und als Vollbild-Such-View mit Filtern. Dashboard (M20): 3 feste Rollen-Dashboards (GF/Büro/Monteur, SHK-Default geseedet) aus einem Widget-Katalog (Sales/Projekte/Tasks/HR/KI/Activity/Comms), live aktualisiert (SSE/WebSocket, Aggregat-Cache); Edit = nur Widget-Filter/Zeitraum (kein Drag&Drop-Grid in v1).

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-spezifische Filter 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) mit Subtle-Animation + „Live-Updates pausieren" · Edit = nur Widget-Filter/Zeitraum konfigurieren · „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)

(SCREEN-MAP §5 nennt Flow-Editor/Booking/Kalender/Signatur im selben Paket — die gehören zu P12/P16, nicht in diesen Brief. Custom-Widgets/Export + Drag&Drop-Grid = v2.)

Geplante Features (muss abgedeckt sein)

  • Meilisearch-Keyword-Suche permission-aware über SearchAdapter (Modul-Registrierung: Kontakt/Firma/Lead/Projekt/File/Task/User); pgvector/Hybrid → v2
  • Entity-Mutationen aktualisieren den Index über Outbox-Pattern; SearchIndexEntry + RecentSearch befüllt (5–10 s Index-Latenz mit Klartext-Hinweis)
  • Cmd+K-Modal (global Hotkey, debounced, gruppierte Treffer, Match-Highlight, Tastatur-Navigation, RecentSearches) + Wechsel in Vollbild-Such-View mit Filtern
  • Server-side Permission-Filter in der Suche (nie durchsickern; 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); Widget-Registry voll gebaut
  • Dashboard-Widgets live (SSE/WebSocket) mit Aggregat-Cache + Lazy-Load/Skeleton; Widgets permission-gegated (Quellen-Modul-Permission), Monteur-Dashboard mobile-first
  • Permissions: search.use/search.admin (Suche selbst leichtgewichtig — Sichtbarkeit über Modul-Permissions); dashboard.read/customize (v1: nur Filter/Zeitraum), Drag&Drop-Customize → v2

Benötigte 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 (mit 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 + Embedding-Provider-Down-Banner (Klartext, alle aus M24 Block I / M20 Klartext-Hinweisen).

Davids Delta (David füllt aus)

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

Dev-Nachzug (wir nach Davids Delta)

  • Spec/ENTITY-MODEL an Davids Entscheidungen angepasst:
  • REQUIREMENTS/PHASE-SOURCES nachgezogen:
  • Plane-Ticket (R-P11a/b) aktualisiert: