{
"tool_response": {
"filePath": "\/var\/www\/dev.campus.systemische-tools.de\/docs\/plan-form-components-refactoring.md",
"oldString": "## 0c. Ressourcen-Übersicht",
"newString": "## 0d. Context Limit (Hardcoded + LocalStorage)\n\n### 0d.1 Architektur-Entscheidung\n\n**Gewählt: KISS - Hardcoded mit LocalStorage-Persistenz**\n\n- Feste Werte: `[3, 5, 10, 15]`\n- Kein DB-Eintrag, keine Admin-Seite\n- User-Auswahl wird in LocalStorage gespeichert\n- Beim Laden: Wert aus LocalStorage wiederherstellen\n\n### 0d.2 Partial: context-limit.php\n\n```php\n\/\/ \/src\/View\/partials\/form\/context-limit.php\n<?php\n$selected = $selected ?? null; \/\/ null = aus LocalStorage laden\n$name = $name ?? 'context_limit';\n$id = $id ?? 'context_limit';\n$variant = $variant ?? 'default';\n$class = $variant === 'inline' ? 'form-select--inline' : 'form-select';\n$limits = [3, 5, 10, 15];\n$default = 5;\n?>\n<select name=\"<?= $name ?>\" id=\"<?= $id ?>\" class=\"<?= $class ?>\"\n data-localstorage-key=\"pref_context_limit\"\n data-default=\"<?= $default ?>\">\n <?php foreach ($limits as $limit): ?>\n <option value=\"<?= $limit ?>\" <?= $selected === $limit ? 'selected' : '' ?>>\n <?= $limit ?> Quellen\n <\/option>\n <?php endforeach; ?>\n<\/select>\n```\n\n### 0d.3 JavaScript: LocalStorage-Handler\n\n```javascript\n\/\/ \/public\/js\/form-persistence.js\n\ndocument.addEventListener('DOMContentLoaded', function() {\n \/\/ Alle Elemente mit data-localstorage-key finden\n document.querySelectorAll('[data-localstorage-key]').forEach(el => {\n const key = el.dataset.localstorageKey;\n const defaultVal = el.dataset.default;\n\n \/\/ Wert aus LocalStorage laden (falls nicht server-seitig gesetzt)\n if (!el.dataset.serverValue) {\n const stored = localStorage.getItem(key);\n if (stored !== null) {\n el.value = stored;\n } else if (defaultVal) {\n el.value = defaultVal;\n }\n }\n\n \/\/ Bei Änderung speichern\n el.addEventListener('change', function() {\n localStorage.setItem(key, this.value);\n });\n });\n});\n```\n\n### 0d.4 Verhalten\n\n| Szenario | Verhalten |\n|----------|-----------|\n| Erster Besuch | Default = 5 |\n| User wählt 10 | LocalStorage: `pref_context_limit = 10` |\n| Neuer Tab\/Seite | Select zeigt 10 (aus LocalStorage) |\n| Session hat Wert | Server-Wert überschreibt LocalStorage |\n| LocalStorage löschen | Zurück zu Default 5 |\n\n### 0d.5 Integration mit Session-Werten\n\nWenn eine Chat-Session oder Content-Order bereits einen Wert hat:\n\n```php\n\/\/ Controller übergibt gespeicherten Wert\n$this->view('chat.index', [\n 'contextLimit' => $session['context_limit'] ?? null, \/\/ null = LocalStorage\n]);\n\n\/\/ Partial prüft\n<?php if ($selected !== null): ?>\n data-server-value=\"<?= $selected ?>\"\n<?php endif; ?>\n```\n\n**Priorität:**\n1. Server-Wert (Session\/Order hat bereits einen Wert)\n2. LocalStorage (User-Präferenz)\n3. Default (5)\n\n### 0d.6 Migrations-Schritte (Context Limit)\n\n1. [ ] `\/public\/js\/form-persistence.js` erstellen\n2. [ ] In Layout einbinden\n3. [ ] Partial `context-limit.php` erstellen\n4. [ ] Chat auf Partial umstellen\n5. [ ] Content New auf Partial umstellen\n6. [ ] Content Show auf Partial umstellen\n7. [ ] Testen: LocalStorage-Persistenz funktioniert\n\n---\n\n## 0c. Ressourcen-Übersicht",
"originalFile": "# Plan: Einheitliche Form-Komponenten (Chat & Content Studio)\n\n## Status: PLANUNG\n**Erstellt:** 2025-12-21\n**Ziel:** DRY, KISS, SRP - Shared Partials für alle wiederverwendbaren Form-Elemente\n\n---\n\n## 0. LLM-Verwaltung (Grundlage für Modell-Dropdown)\n\n### 0.1 Architektur-Entscheidung\n\n**Gewählt: Variante B - Dedizierte LLM-Verwaltung**\n\nStatt dynamischer API-Abfrage bei jedem Seitenaufruf:\n- Zentrale Admin-Seite `\/ressourcen\/llm`\n- Datenbank-Tabelle als Single Source of Truth\n- Sync-Buttons für Provider (Anthropic, Ollama, weitere)\n- Sprechende Namen und Zusatzmetadaten\n\n### 0.2 Datenbank-Tabelle `llm_models`\n\n```sql\nCREATE TABLE llm_models (\n id INT AUTO_INCREMENT PRIMARY KEY,\n provider ENUM('anthropic', 'ollama', 'openai', 'google', 'mistral', 'custom') NOT NULL,\n model_id VARCHAR(100) NOT NULL, -- API-ID: \"claude-opus-4-5-20251101\"\n display_name VARCHAR(100) NOT NULL, -- Anzeige: \"Claude Opus 4.5\"\n description TEXT, -- Kurzbeschreibung\n context_window INT, -- Max. Tokens Input: 200000\n max_output_tokens INT, -- Max. Tokens Output: 8192\n input_price_per_mtok DECIMAL(10,4), -- Preis Input $\/MTok\n output_price_per_mtok DECIMAL(10,4), -- Preis Output $\/MTok\n capabilities JSON, -- {\"vision\": true, \"function_calling\": true}\n is_local BOOLEAN DEFAULT FALSE, -- Lokal (Ollama) vs. Cloud\n is_active BOOLEAN DEFAULT TRUE, -- In Dropdowns anzeigen?\n sort_order INT DEFAULT 0, -- Reihenfolge in Dropdowns\n last_synced_at DATETIME, -- Letzte Synchronisation\n created_at DATETIME DEFAULT CURRENT_TIMESTAMP,\n updated_at DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,\n UNIQUE KEY unique_provider_model (provider, model_id)\n) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;\n```\n\n### 0.3 Admin-Seite `\/ressourcen\/llm`\n\n**URL:** `\/ressourcen\/llm`\n**Controller:** `RessourcenController::llmIndex()`\n\n**Funktionen:**\n\n| Button | Aktion |\n|--------|--------|\n| \"Anthropic synchronisieren\" | `GET api.anthropic.com\/v1\/models` → DB aktualisieren |\n| \"Ollama synchronisieren\" | `ollama list` → DB aktualisieren |\n| \"Neuer Provider\" | Manuell weiteren Provider hinzufügen |\n\n**Tabellen-Ansicht:**\n\n| Provider | Model-ID | Display-Name | Context | Preis In\/Out | Lokal | Aktiv | Aktionen |\n|----------|----------|--------------|---------|--------------|-------|-------|----------|\n| Anthropic | claude-opus-4-5-20251101 | Claude Opus 4.5 | 200k | $15\/$75 | - | ✓ | Bearbeiten |\n| Ollama | mistral:latest | Mistral 7B | 32k | - | ✓ | ✓ | Bearbeiten |\n\n**Bearbeiten-Dialog:**\n- Display-Name ändern\n- Beschreibung hinzufügen\n- Context-Window \/ Max-Output korrigieren\n- Preise eintragen (für Kostenberechnung)\n- Aktivieren\/Deaktivieren\n- Sortierung ändern\n\n### 0.4 Sync-Logik\n\n**Anthropic Sync:**\n```php\n\/\/ GET https:\/\/api.anthropic.com\/v1\/models\n\/\/ Response: {\"data\": [{\"id\": \"claude-opus-4-5-20251101\", ...}]}\n\nforeach ($apiModels as $model) {\n \/\/ INSERT ... ON DUPLICATE KEY UPDATE\n \/\/ Neue Modelle: is_active = true, display_name = model_id (initial)\n \/\/ Existierende: last_synced_at aktualisieren\n \/\/ Fehlende: NICHT löschen, nur last_synced_at bleibt alt\n}\n```\n\n**Ollama Sync:**\n```php\n\/\/ $ ollama list\n\/\/ NAME ID SIZE MODIFIED\n\/\/ mistral:latest abc123... 4.1 GB 2 days ago\n\n$output = shell_exec('ollama list');\n\/\/ Parsen und in DB einfügen\n```\n\n### 0.5 Dropdown-Query\n\n```php\n\/\/ ModelService::getActiveModels()\npublic function getActiveModels(): array\n{\n return $this->db->query(\"\n SELECT model_id, display_name, provider, is_local, context_window\n FROM llm_models\n WHERE is_active = 1\n ORDER BY is_local ASC, sort_order ASC, display_name ASC\n \")->fetchAll();\n}\n```\n\n### 0.6 Partial nutzt DB-Daten\n\n```php\n\/\/ \/src\/View\/partials\/form\/model-select.php\n<?php\n$models = $models ?? [];\n$selected = $selected ?? '';\n$variant = $variant ?? 'default';\n$class = $variant === 'inline' ? 'form-select--inline' : 'form-select';\n?>\n<select name=\"model\" id=\"model\" class=\"<?= $class ?>\">\n <optgroup label=\"Cloud\">\n <?php foreach ($models as $m): ?>\n <?php if (!$m['is_local']): ?>\n <option value=\"<?= $m['model_id'] ?>\" <?= $selected === $m['model_id'] ? 'selected' : '' ?>>\n <?= htmlspecialchars($m['display_name']) ?>\n <\/option>\n <?php endif; ?>\n <?php endforeach; ?>\n <\/optgroup>\n <optgroup label=\"Lokal\">\n <?php foreach ($models as $m): ?>\n <?php if ($m['is_local']): ?>\n <option value=\"<?= $m['model_id'] ?>\" <?= $selected === $m['model_id'] ? 'selected' : '' ?>>\n <?= htmlspecialchars($m['display_name']) ?>\n <\/option>\n <?php endif; ?>\n <?php endforeach; ?>\n <\/optgroup>\n<\/select>\n```\n\n### 0.7 Migrations-Schritte (LLM-Verwaltung)\n\n1. [ ] Tabelle `llm_models` in `ki_dev` erstellen\n2. [ ] `LlmModelRepository` erstellen\n3. [ ] `LlmSyncService` erstellen (Anthropic + Ollama)\n4. [ ] Route `\/ressourcen\/llm` anlegen\n5. [ ] `RessourcenController::llmIndex()` implementieren\n6. [ ] View `\/ressourcen\/llm\/index.php` erstellen\n7. [ ] Sync-Buttons implementieren\n8. [ ] Bearbeiten-Funktionalität\n9. [ ] Initial-Sync durchführen (bestehende Modelle importieren)\n10. [ ] `ModelConfig.php` durch `LlmModelRepository` ersetzen\n11. [ ] Partial `model-select.php` erstellen\n12. [ ] Chat und Content auf Partial umstellen\n\n---\n\n## 0b. Collection-Verwaltung (Grundlage für Collection-Dropdown)\n\n### 0b.1 Architektur-Entscheidung\n\n**Gewählt: DB-Tabelle analog zu LLMs**\n\n- Zentrale Admin-Seite `\/ressourcen\/collections`\n- Datenbank-Tabelle als Single Source of Truth\n- Sync mit Qdrant (Metadaten abrufen)\n- Sprechende Namen und Beschreibungen\n- **Multi-Select** als einheitliche Darstellung\n\n### 0b.2 Datenbank-Tabelle `rag_collections`\n\n```sql\nCREATE TABLE rag_collections (\n id INT AUTO_INCREMENT PRIMARY KEY,\n collection_id VARCHAR(100) NOT NULL UNIQUE, -- Qdrant-Name: \"documents\"\n display_name VARCHAR(100) NOT NULL, -- Anzeige: \"Dokumente\"\n description TEXT, -- \"PDF-Dokumente aus Nextcloud\"\n\n -- Qdrant-Metadaten (via Sync)\n vector_size INT, -- 1024\n distance_metric VARCHAR(20), -- \"Cosine\"\n points_count INT DEFAULT 0, -- Anzahl Vektoren\n\n -- Konfiguration\n embedding_model VARCHAR(100), -- \"mxbai-embed-large\"\n chunk_size INT, -- 2000\n chunk_overlap INT, -- 200\n\n -- Verwaltung\n source_type ENUM('nextcloud', 'mail', 'manual', 'system') DEFAULT 'manual',\n source_path VARCHAR(500), -- \"\/var\/www\/nextcloud\/data\/...\"\n is_active BOOLEAN DEFAULT TRUE, -- In Dropdowns anzeigen?\n is_searchable BOOLEAN DEFAULT TRUE, -- Für RAG verfügbar?\n sort_order INT DEFAULT 0,\n\n -- Timestamps\n last_synced_at DATETIME,\n created_at DATETIME DEFAULT CURRENT_TIMESTAMP,\n updated_at DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP\n) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;\n```\n\n### 0b.3 Impact-Analyse: Wer nutzt Collections?\n\n| System\/Seite | Aktueller Zugriff | Neuer Zugriff | Änderung |\n|--------------|-------------------|---------------|----------|\n| **Chat** | `$qdrantService->listCollections()` | `CollectionRepository::getActive()` | Query aus DB |\n| **Content Studio** | `$qdrantService->listCollections()` | `CollectionRepository::getActive()` | Query aus DB |\n| **Content Show** | `$qdrantService->listCollections()` | `CollectionRepository::getActive()` | Query aus DB |\n| **Pipeline (Python)** | `config.py QDRANT_COLLECTIONS` | DB-Query oder Config-Sync | Python liest DB |\n| **Semantic Explorer** | Direkt Qdrant | `CollectionRepository` + Qdrant | Metadaten aus DB |\n| **System Explorer** | - | Statistiken aus DB | Neu |\n| **API \/api\/v1\/search** | Qdrant direkt | Validierung gegen DB | Nur aktive Collections |\n| **Embedding-Service** | `config.py` | DB oder Sync | Konsistenz |\n\n### 0b.4 Admin-Seite `\/ressourcen\/collections`\n\n**URL:** `\/ressourcen\/collections`\n**Controller:** `RessourcenController::collectionsIndex()`\n\n**Funktionen:**\n\n| Button | Aktion |\n|--------|--------|\n| \"Qdrant synchronisieren\" | Collections + Metadaten von Qdrant abrufen |\n| \"Neue Collection\" | Manuell Collection registrieren |\n\n**Tabellen-Ansicht:**\n\n| Collection-ID | Display-Name | Vektoren | Größe | Quelle | Aktiv | Suchbar | Aktionen |\n|---------------|--------------|----------|-------|--------|-------|---------|----------|\n| documents | Dokumente | 1.247 | 1024d | Nextcloud | ✓ | ✓ | Bearbeiten |\n| dokumentation_chunks | Doku-Chunks | 892 | 1024d | System | ✓ | ✓ | Bearbeiten |\n| mail | E-Mails | 3.421 | 1024d | Mail | ✓ | ✓ | Bearbeiten |\n| entities | Entitäten | 156 | 1024d | System | ✓ | - | Bearbeiten |\n\n**Bearbeiten-Dialog:**\n- Display-Name ändern\n- Beschreibung hinzufügen\n- Quelle\/Pfad dokumentieren\n- Aktivieren\/Deaktivieren (Dropdown)\n- Suchbar ja\/nein (RAG-Verfügbarkeit)\n- Sortierung ändern\n\n### 0b.5 Sync-Logik\n\n**Qdrant Sync:**\n```php\n\/\/ QdrantService::getCollectionsInfo()\npublic function syncCollections(): array\n{\n $qdrantCollections = $this->client->getCollections();\n\n foreach ($qdrantCollections as $col) {\n $info = $this->client->getCollectionInfo($col['name']);\n\n \/\/ INSERT ... ON DUPLICATE KEY UPDATE\n $this->repository->upsert([\n 'collection_id' => $col['name'],\n 'display_name' => $col['name'], \/\/ Initial = ID\n 'vector_size' => $info['config']['params']['size'],\n 'distance_metric' => $info['config']['params']['distance'],\n 'points_count' => $info['points_count'],\n 'last_synced_at' => now(),\n ]);\n }\n}\n```\n\n### 0b.6 Repository-Interface\n\n```php\n\/\/ CollectionRepository.php\ninterface CollectionRepositoryInterfac... [TRUNCATED-ecf4432bbcd66713]",
"structuredPatch": [
{
"oldStart": 379,
"oldLines": 6,
"newStart": 379,
"newLines": 113,
"lines": [
" ",
" ---",
" ",
"+## 0d. Context Limit (Hardcoded + LocalStorage)",
"+",
"+### 0d.1 Architektur-Entscheidung",
"+",
"+**Gewählt: KISS - Hardcoded mit LocalStorage-Persistenz**",
"+",
"+- Feste Werte: `[3, 5, 10, 15]`",
"+- Kein DB-Eintrag, keine Admin-Seite",
"+- User-Auswahl wird in LocalStorage gespeichert",
"+- Beim Laden: Wert aus LocalStorage wiederherstellen",
"+",
"+### 0d.2 Partial: context-limit.php",
"+",
"+```php",
"+\/\/ \/src\/View\/partials\/form\/context-limit.php",
"+<?php",
"+$selected = $selected ?? null; \/\/ null = aus LocalStorage laden",
"+$name = $name ?? 'context_limit';",
"+$id = $id ?? 'context_limit';",
"+$variant = $variant ?? 'default';",
"+$class = $variant === 'inline' ? 'form-select--inline' : 'form-select';",
"+$limits = [3, 5, 10, 15];",
"+$default = 5;",
"+?>",
"+<select name=\"<?= $name ?>\" id=\"<?= $id ?>\" class=\"<?= $class ?>\"",
"+ data-localstorage-key=\"pref_context_limit\"",
"+ data-default=\"<?= $default ?>\">",
"+ <?php foreach ($limits as $limit): ?>",
"+ <option value=\"<?= $limit ?>\" <?= $selected === $limit ? 'selected' : '' ?>>",
"+ <?= $limit ?> Quellen",
"+ <\/option>",
"+ <?php endforeach; ?>",
"+<\/select>",
"+```",
"+",
"+### 0d.3 JavaScript: LocalStorage-Handler",
"+",
"+```javascript",
"+\/\/ \/public\/js\/form-persistence.js",
"+",
"+document.addEventListener('DOMContentLoaded', function() {",
"+ \/\/ Alle Elemente mit data-localstorage-key finden",
"+ document.querySelectorAll('[data-localstorage-key]').forEach(el => {",
"+ const key = el.dataset.localstorageKey;",
"+ const defaultVal = el.dataset.default;",
"+",
"+ \/\/ Wert aus LocalStorage laden (falls nicht server-seitig gesetzt)",
"+ if (!el.dataset.serverValue) {",
"+ const stored = localStorage.getItem(key);",
"+ if (stored !== null) {",
"+ el.value = stored;",
"+ } else if (defaultVal) {",
"+ el.value = defaultVal;",
"+ }",
"+ }",
"+",
"+ \/\/ Bei Änderung speichern",
"+ el.addEventListener('change', function() {",
"+ localStorage.setItem(key, this.value);",
"+ });",
"+ });",
"+});",
"+```",
"+",
"+### 0d.4 Verhalten",
"+",
"+| Szenario | Verhalten |",
"+|----------|-----------|",
"+| Erster Besuch | Default = 5 |",
"+| User wählt 10 | LocalStorage: `pref_context_limit = 10` |",
"+| Neuer Tab\/Seite | Select zeigt 10 (aus LocalStorage) |",
"+| Session hat Wert | Server-Wert überschreibt LocalStorage |",
"+| LocalStorage löschen | Zurück zu Default 5 |",
"+",
"+### 0d.5 Integration mit Session-Werten",
"+",
"+Wenn eine Chat-Session oder Content-Order bereits einen Wert hat:",
"+",
"+```php",
"+\/\/ Controller übergibt gespeicherten Wert",
"+$this->view('chat.index', [",
"+ 'contextLimit' => $session['context_limit'] ?? null, \/\/ null = LocalStorage",
"+]);",
"+",
"+\/\/ Partial prüft",
"+<?php if ($selected !== null): ?>",
"+ data-server-value=\"<?= $selected ?>\"",
"+<?php endif; ?>",
"+```",
"+",
"+**Priorität:**",
"+1. Server-Wert (Session\/Order hat bereits einen Wert)",
"+2. LocalStorage (User-Präferenz)",
"+3. Default (5)",
"+",
"+### 0d.6 Migrations-Schritte (Context Limit)",
"+",
"+1. [ ] `\/public\/js\/form-persistence.js` erstellen",
"+2. [ ] In Layout einbinden",
"+3. [ ] Partial `context-limit.php` erstellen",
"+4. [ ] Chat auf Partial umstellen",
"+5. [ ] Content New auf Partial umstellen",
"+6. [ ] Content Show auf Partial umstellen",
"+7. [ ] Testen: LocalStorage-Persistenz funktioniert",
"+",
"+---",
"+",
" ## 0c. Ressourcen-Übersicht",
" ",
" ### Navigationsstruktur"
]
}
],
"userModified": false,
"replaceAll": false
}
}