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.basicgaten 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: