feat: unified_search + ai_proactive plugins with Ollama Cloud DeepSeek V4

- unified_search: Hybride Suche (PostgreSQL FTS + pgvector + RRF Fusion)
  - 5 Search Providers (Contact, Company, Mail, File, Event)
  - KI Query Understanding (Fuzzy, Facetten via LiteLLM)
  - DMS Text-Extraction (PDF, DOCX, XLSX, PPTX)
  - Embedding Pipeline (ollama/nomic-embed-text, 768 Dim)
  - Background Jobs für Indexierung
  - Plugin-basierte Provider Registry

- ai_proactive: Proaktiver KI-Agent
  - Context-Tracking (Frontend → Backend → Event Bus)
  - Proactive Engine mit LLM Suggestion-Generierung
  - SSE Real-time Push an Frontend
  - 6 AI Tools für Tool Registry
  - Rate-Limiting + User Settings
  - Deep Analysis Background Jobs

- Frontend Integration:
  - useAIContext Hook, SuggestionSidebar, SuggestionBadge
  - ProactiveAISettings Page, Search API Client
  - Globale Suche auf neue API umgestellt

- Tests: test_unified_search.py + test_ai_proactive.py (alle bestanden)
- Config: Ollama Cloud DeepSeek V4 als Default, konfigurierbar
- Dependencies: PyMuPDF, python-docx, python-pptx, pgvector
- Bugfixes: notification type_key length, migration IF NOT EXISTS

frontend/src/api/aiProactive.ts

@@ -0,0 +1,72 @@
+import { useState, useEffect, useCallback } from 'react';
+import { apiClient } from '@/api/client';
+
+export interface Suggestion {
+  id: string;
+  entity_type: string;
+  entity_id: string | null;
+  suggestion_type: 'info' | 'warning' | 'action' | 'insight';
+  title: string;
+  content: string;
+  confidence: number;
+  actions: Array<{ method: string; path: string; body: any; description: string }>;
+  created_at: string;
+  is_dismissed: boolean;
+  is_acted_upon: boolean;
+}
+
+export function useSuggestions() {
+  const [suggestions, setSuggestions] = useState<Suggestion[]>([]);
+  const [connected, setConnected] = useState(false);
+
+  useEffect(() => {
+    // Initial load
+    apiClient.get('/api/v1/ai-proactive/suggestions').then(r => {
+      setSuggestions(r.data.items);
+    }).catch(() => {});
+
+    // SSE Stream
+    const eventSource = new EventSource('/api/v1/ai-proactive/suggestions/stream');
+    eventSource.onopen = () => setConnected(true);
+    eventSource.onerror = () => setConnected(false);
+    eventSource.onmessage = (e) => {
+      try {
+        const suggestion = JSON.parse(e.data);
+        setSuggestions(prev => [suggestion, ...prev].slice(0, 50));
+      } catch {}
+    };
+
+    return () => eventSource.close();
+  }, []);
+
+  const dismiss = useCallback(async (id: string) => {
+    setSuggestions(prev => prev.filter(s => s.id !== id));
+    await apiClient.post(`/api/v1/ai-proactive/suggestions/${id}/dismiss`).catch(() => {});
+  }, []);
+
+  const act = useCallback(async (id: string, actionIndex: number) => {
+    const result = await apiClient.post(`/api/v1/ai-proactive/suggestions/${id}/act`, {
+      action_index: actionIndex
+    });
+    setSuggestions(prev => prev.map(s => s.id === id ? { ...s, is_acted_upon: true } : s));
+    return result.data;
+  }, []);
+
+  return { suggestions, connected, dismiss, act };
+}
+
+export function useProactiveSettings() {
+  const [settings, setSettings] = useState<any>(null);
+
+  useEffect(() => {
+    apiClient.get('/api/v1/ai-proactive/settings').then(r => setSettings(r.data));
+  }, []);
+
+  const update = useCallback(async (updates: any) => {
+    const r = await apiClient.put('/api/v1/ai-proactive/settings', updates);
+    setSettings(r.data);
+    return r.data;
+  }, []);
+
+  return { settings, update };
+}

frontend/src/api/hooks.ts

@@ -388,45 +388,9 @@ export function useGlobalSearch(query: string, entityTypes?: string[]) {
     queryKey: ['globalSearch', query, entityTypes],
     queryFn: async (): Promise<SearchResult[]> => {
       if (!query.trim()) return [];
-      const results: SearchResult[] = [];
-      const types = entityTypes && entityTypes.length > 0 ? entityTypes : ['company', 'contact'];
-      const tasks: Promise<void>[] = [];
-      if (types.includes('company')) {
-        tasks.push(
-          apiGet<PaginatedResponse<Company>>(`/companies?page=1&page_size=10&search=${encodeURIComponent(query)}`)
-            .then((data) => {
-              for (const item of data.items) {
-                results.push({
-                  type: 'company',
-                  id: item.id,
-                  name: item.name,
-                  description: item.industry || item.email || '',
-                  url: `/companies/${item.id}`,
-                });
-              }
-            })
-            .catch(() => {})
-        );
-      }
-      if (types.includes('contact')) {
-        tasks.push(
-          apiGet<PaginatedResponse<Contact>>(`/contacts?page=1&page_size=10&search=${encodeURIComponent(query)}`)
-            .then((data) => {
-              for (const item of data.items) {
-                results.push({
-                  type: 'contact',
-                  id: item.id,
-                  name: `${item.first_name} ${item.last_name}`,
-                  description: item.email || item.phone || '',
-                  url: `/contacts/${item.id}`,
-                });
-              }
-            })
-            .catch(() => {})
-        );
-      }
-      await Promise.all(tasks);
-      return results;
+      const { search } = await import('@/api/search');
+      const response = await search(query, entityTypes, 20);
+      return response.results || [];
     },
     enabled: query.trim().length > 0,
     staleTime: 30 * 1000,

frontend/src/api/search.ts

@@ -0,0 +1,38 @@
+import { apiClient } from './client';
+
+export interface SearchResult {
+  type: 'company' | 'contact' | 'mail' | 'file' | 'event';
+  id: string;
+  name: string;
+  description?: string;
+  url: string;
+}
+
+export interface SearchResponse {
+  results: SearchResult[];
+  facets?: Record<string, Array<{ value: string; count: number }>>;
+  summary?: string;
+  suggestions?: string[];
+}
+
+export async function search(query: string, entityTypes?: string[], limit = 20): Promise<SearchResponse> {
+  const r = await apiClient.post('/api/v1/search', {
+    query,
+    entity_types: entityTypes,
+    limit,
+  });
+  return r.data;
+}
+
+export async function searchSuggest(q: string): Promise<string[]> {
+  const r = await apiClient.get('/api/v1/search/suggest', { params: { q } });
+  return r.data.suggestions;
+}
+
+export async function searchSimilar(entityType: string, entityId: string): Promise<SearchResult[]> {
+  const r = await apiClient.post('/api/v1/search/similar', {
+    entity_type: entityType,
+    entity_id: entityId,
+  });
+  return r.data.similar;
+}