Files
HiveGrid-Wireframes/03 Quellen und Referenzen/hivegrid-cloud/.planning/designer-briefs/P25-ki-tiefe-hivemind-rag.md
T

4.8 KiB

Designer-Brief · P25 — KI-Tiefe: HiveMind/RAG (v2-P4)

⛔ ABGELÖST (KI→MCP-Pivot, AD-26, 2026-06-22): HiveMind/RAG/Whisper-UI entfällt (zurückgestellt). Ersetzt durch VD-MCP (MCP-Verbindungen/Settings). Brief unten = historisch.

Phase: 25/34 (v2-P4) · Modul: M18 (M087 + Whisper-EU + pgvector-Hybrid-Suche + zweiter EU-Provider) · Owner-Dev: Raffael (VR-P25) · Designer: David · Slot: v2-W1→W2 (Start 18./19.07.) Quellen: ROADMAP-V2.md §v2-P4 (Screens/Features = Hauptquelle) · ROADMAP.md §Phase 25 · _bmad-output/specs/M18-ki-layer.md (RAG/HiveMind/Whisper-Teile) Subframe: Pflicht je Route. Archetypen aus D0 (A2 Liste, A3 Detail, A5 Modal, A6 Settings, Chat-Panel).

🔴 DSGVO-Hard-Constraint: Nur EU-Provider (kein OpenAI/Anthropic/Gemini), AVV mit allen Providern. Aufbau auf dem v1-LLM-Gateway (Multi-Provider-Abstraktion) — NICHT neu bauen. Der HiveMind-Agent läuft erst nach etabliertem Werkzeug-Modus (Reifegrad-Gate) autonom und immer mit Action-Boundary: keine schreibenden Aktionen ohne explizite Bestätigung. Hilfe-Korpus für RAG kommt aus v2-P9 (Help-Center) per Retro-Integration.

Was dieses Modul tut (Kurzfassung)

Aus dem v1-LLM-Gateway wird semantische Tiefe: eine Embedding-Pipeline (pgvector, permission-vorgefiltert) speist RAG für Programm-Hilfe, Lead-Zusammenfassungen und eine hybride globale Suche (Volltext + Vektor, RRF). Whisper-EU transkribiert Voice-Notes async. Der HiveMind-Agent liefert proaktive Vorschläge (Insights) mit Bestätigungs-Workflow, Audit-Trail und Scheduled-Actions. Multi-Provider-Failover (Mistral→Scaleway→AlephAlpha) + Promptfoo-Eval in CI.

Benötigte Screens

Screen [Route] Kern-Inhalt Archetyp
KI-Chat/Assistent-Panel [überall einblendbar / /assistant] Chat mit RAG-Antworten (Quellen-Zitate), Conversation-History, Use-Case-Kontext (aktuelle UI-Sicht), Graceful-Degradation-Hinweis bei Provider-Down (Fallback Help-Volltext) Chat-Panel
HiveMind-Insight-Anzeige [Dashboard-Widget / Detail] Proaktive Vorschläge (Stuck-Deals/Stuck-Projects), Bestätigungs-Workflow (annehmen/verwerfen) mit Action-Boundary, Begründung/Quelle A2/Widget
Custom-Tool-Editor + Scheduled-Actions [/admin/ai/tools] Tenant-definierte HiveMind-Tools anlegen/bearbeiten, Cron-basierte Scheduled-Actions, Action-Log (Audit-Trail autonomer Actions) A2 + A3
AI-Usage-Dashboard [/admin/usage/ai] Token-/Credit-Verbrauch (AiCredits/AiTokenUsage), pro Use-Case/Provider, Quota/Failover-Status A6
Whisper-Aufnahme/Transkription [in Abnahme/Notes eingebettet] Voice-Note aufnehmen/hochladen, async Transkriptions-Status, Resultat + Klartext-Fehlerpfad A5/eingebettet

Geplante Features (muss abgedeckt sein)

  • Embedding-Pipeline → TenantEmbedding (pgvector, HNSW/IVFFlat), Re-Embed per Hash-Diff, Permission-Pre-Filter vor Vector-Search
  • RAG bedient Programm-Hilfe (Help-Embeddings aus P9), Lead-Zusammenfassung, hybride globale Suche (Volltext+Vektor, RRF); Graceful Degradation bei Provider-Down
  • Whisper-EU (Scaleway-GPU) transkribiert Voice-Notes async mit Klartext-Fehlerpfad
  • HiveMind-Agent: proaktive Vorschläge mit Action-Boundary (keine Writes ohne Bestätigung), Audit-Trail, Scheduled-Actions, Screen-Context-Bewusstsein
  • Multi-Provider-Failover (Mistral→Scaleway→AlephAlpha) + Promptfoo-Eval in CI (scheitert bei erfolgreicher Injection)
  • Permissions: ai.use_chat / ai.use_transcription / ai.basic gaten Chat/Whisper/Read
  • Wiederverwendung v1: LLM-Gateway, RetrievalProvider-Interface + Outbox-Index-Events, AiCredits/AiTokenUsage, Activity-Stream/Custom-Felder/Forms als RAG-Quellen

Benötigte UI-Elemente (Liste, KEIN Layout — Anordnung = Davids freie Hand)

Chat-Panel (Nachrichten-Stream, Eingabefeld, Streaming-Antwort), Quellen-Zitat-Chips/Aufklapp (RAG-Belege), Conversation-History-Liste, Insight-Karten mit Annehmen/Verwerfen + Begründung, Action-Boundary-Bestätigungs-Dialog (zeigt geplante Action vor Ausführung), Audit-Trail-Timeline (autonome Actions), Custom-Tool-Editor (Tool-Definition-Felder), Scheduled-Action-Konfig (Cron + Tool-Auswahl), Voice-Recorder-Control (Aufnahme/Stop/Upload) + Transkriptions-Status-Indikator, Usage-/Quota-Charts pro Provider/Use-Case, Provider-Down-/Degradation-Banner (Klartext-Fallback-Hinweis), Permission-Denied-/Empty-/Loading-States (Klartext), DSGVO-/EU-Provider-Hinweis (Transparenz).

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 (VR-P25) aktualisiert: