5.3 KiB
R-P11a · P11 Globale Suche (Meilisearch, Cmd+K)
⚠️ KI→MCP-Pivot (AD-26): Die pgvector-
embedding-Spalte und derEmbeddingProviderJobruhen (RAG entfällt — HiveGrid hostet kein Embedding/LLM mehr, sondern wird MCP-Server, VR-MCP). v1 bleibt unverändert reine Meilisearch-Keyword-Suche; die früher als „v2-Andock-Halter" geführten Embedding-Teile werden in v2 nicht befüllt.
| Typ | Dev (Code) |
| Owner | Raffael |
| Phase | P11 — Globale Suche & Dashboard |
| Cycle/Fenster | W4 — USP, Härtung & Launch · 2026-07-03 → 2026-07-04 · Gate W4 |
| Status | geplant |
🟢 Kein Pivot-Sonderfall (P11 ist nicht Teil der projekt-zentrischen Kern-Kette). Aber: Der Such-Index greift auf den
Projekt-Kern zu — in der M24-Spec stehendeal | project | orderals Typen; im Pivot-Modell ist das EINProjekt-Entity-Typ (Pipeline-Typ = View, kein separater Index-Typ je Pipeline). v1 = Meilisearch-Keyword-Suche;pgvector/Hybrid → v2 (AD-5 sequenziert) — embedding-Spalte/EmbeddingProviderJob sind nur Andock-Halter.→ pgvector/Hybrid ruht (AD-26: RAG entfällt); embedding-Spalte/EmbeddingProviderJob bleiben ungenutzt.
Abhängigkeiten & Parallelität
- Blocked by:
R-P9b(Kern-Kette abgeschlossen — Projekt/Sub-Areas indexierbar),AK-INFRA2(Meilisearch zentral bereitgestellt) - Blocks:
R-P11b(Dashboard danach) - Sequenz (Raffaels Kern-Kette): nach abgeschlossener Kern-Kette (P6–P9). P11/P12/P13 folgen sequenziell.
- Läuft parallel zu: Akeshans Module W4 (
AK-P20/AK-P21Billing/DSGVO u.a.). Schema-Trennung nach AD-21.
Was wir bauen
Eine permission-aware Keyword-Suche über alle Entitäten via Meilisearch (SearchAdapter pro Modul, Outbox-Index-Updates), bedienbar per Cmd+K-Modal (global, debounced, gruppierte Treffer, Match-Highlight, RecentSearches) und als Vollbild-Such-View mit Filtern. Server-side Permission-Filter sorgt dafür, dass nie Treffer durchsickern.
Benötigte Screens (Backend bedient — Design liefert D-DASH-Paket)
| Screen [Route] | Kern-Inhalt |
|---|---|
| Cmd+K-Such-Modal [global] | Auto-Fokus + Live-Suche (300 ms debounce); Treffer gruppiert nach Entity-Typ (Icon/Titel/Subtitle/Match-Highlight/relative letzte Aktivität); Entity-Typ-Filter-Chips (Multi-Select); Tastatur-Navigation (↑↓/Enter/Cmd+Enter/Esc) + Shortcut-Anzeige; Leer-Zustand: RecentSearches + Tipps; „Alle {n} Treffer zeigen" → Vollbild |
Vollbild-Such-View [/search] |
Such-Feld (URL-Param), volle Trefferliste (cursor-paginiert 50/Page) mit Metadaten; Filter-Sidebar (Entity-Typ/Erstellt-Range/Verantwortlicher/Tags/modul-spezifisch + Archiviert-Toggle); Trefferanzahl-Klartext; Sortierung (Relevanz/Letzte Aktivität/Erstellt) |
Definition of Done
- Meilisearch-Keyword-Suche permission-aware über SearchAdapter (Modul-Registrierung: Kontakt/Firma/Lead/Projekt/File/Task/User);
pgvector/Hybrid → v2→ ruht (AD-26) - Entity-Mutationen aktualisieren den Index über Outbox-Index-Pattern;
SearchIndexEntry+RecentSearchbefü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 (nie durchsickern; Trefferanzahl = erlaubte Treffer; Klartext „weitere Treffer, die du nicht siehst")
- Konnektor
tenantHasModule('search')(Suche gated) - Permissions:
search.use/search.admin(Suche leichtgewichtig — Sichtbarkeit über Modul-Permissions)
Technische Bausteine
- Entities (eigene
prisma/schema/search.prisma):SearchIndexEntry(entity_type/id, title, body_text, tsvector_de,embedding [pgvector → v2-Andock-Halter]→ ruht, ungenutzt (AD-26), permission_subject, is_archived),RecentSearch(query_text/applied_filters/result_count),→ ruht (AD-26). Modul-EmbeddingProviderJob(async, Inhalt v2).prismas nur über polymorphe Referenz (AD-21). - RLS auf SearchIndexEntry/RecentSearch (AD-1); Permission-Filter zusätzlich server-seitig via
permission_subjectvor Meilisearch-Query. - Outbox-Pattern: Entity-Mutation → Outbox-Event → Index-Job (SearchAdapter pro Modul) → Meilisearch upsert/delete.
- SearchAdapter-Interface (INTEGRATION-CONTRACTS §8) je Modul registriert.
- Konnektor
tenantHasModule('search')gated. is_demo_data-Flag respektiert (Demo-Treffer bei Echt-Start-Bereinigung entfernt).
Quellen (granular)
ENTITY-MODEL.md→ Domäne 6: Suche & Dashboard (SearchIndexEntry/RecentSearch/EmbeddingProviderJob) — Hinweis: einProjekt-Entity-Typ statt deal/project/orderREQUIREMENTS.md→REQ-suche-datenmodell,REQ-suche-hybrid(Meilisearch/SearchAdapter),REQ-suche-ui(Phase 11)ROADMAP.md→ Phase 11 ·PHASE-SOURCES.md→ P11designer-briefs/P11-suche-dashboard.md(Cmd+K BESPOKE; kein Pivot-Sonderfall, aber Projekt-Kern-Hinweis)_bmad-output/specs/M24-globale-suche.md(⚠ Entity-Typen deal/project/order → im Pivot EIN Projekt-Typ; pgvector → v2)
Dev-Nachzug (nach Davids D-DASH-Delta)
- Spec/ENTITY-MODEL an Davids UI-Entscheidungen angepasst
- REQUIREMENTS/PHASE-SOURCES nachgezogen
- Plane-Ticket
R-P11aaktualisiert