{
"tool_response": {
"type": "update",
"filePath": "\/var\/www\/dev.campus.systemische-tools.de\/dokumentation-qualitaetsbericht.md",
"content": "# Dokumentations-Qualitätsbericht (Vollständige Analyse)\n\n**Erstellt:** 2025-12-29\n**Analysiert:** 141 Dokumente in ki_dev.dokumentation (ALLE Dokumente)\n**Methode:** Parallelisierte Vollanalyse via 5 MCP-Docs Agenten\n\n---\n\n## Zusammenfassung\n\n| Kategorie | Anzahl | Schweregrad |\n|-----------|--------|-------------|\n| Markdown-Format (statt HTML) | 4 | Kritisch |\n| Hierarchie-Probleme | 6 | Major |\n| Redundanz-Probleme | 2 Paare | Major |\n| Veraltete Inhalte | 6 | Major |\n\n**Gesamtergebnis:** 16 Dokumente mit Problemen von 141 = **88.7% gesund**\n\n---\n\n## Analysemethode\n\nDie Analyse wurde durch 5 parallel laufende Agenten durchgeführt:\n\n| Agent | Bereich | Ergebnis |\n|-------|---------|----------|\n| Agent 1 | Docs 1-50: Markdown-Check | 0 gefunden |\n| Agent 2 | Docs 51-100: Markdown-Check | 0 gefunden |\n| Agent 3 | Docs 101-160: Markdown-Check | 4 gefunden |\n| Agent 4 | Alle Docs: Hierarchie-Analyse | 6 + 2 Redundanzen |\n| Agent 5 | Alle Docs: Veraltete Inhalte | 6 gefunden |\n\n---\n\n## 1. Dokumente im Markdown-Format (KRITISCH)\n\nDiese 4 Dokumente verwenden Markdown-Syntax (`# Heading`, `**bold**`, ` ```code``` `, `| table |`) statt HTML.\n\n### 1.1 Doc #143: PDF-Rotationserkennung\n- **Pfad:** `\/prozesse\/rag-prozess\/dokument-import\/pdf-rotation`\n- **Markdown-Elemente:** `#` Headings, ` ``` ` Code-Blöcke, `|` Tabellen, `-` Listen\n- **Aktion:** In HTML konvertieren\n\n### 1.2 Doc #154: db.py Refactoring Plan\n- **Pfad:** `\/prozesse\/db-py-refactoring-plan`\n- **Markdown-Elemente:** `#` Headings, ` ``` ` Code-Blöcke, `|` Tabellen, `-` Listen, `**` Bold\n- **Aktion:** In HTML konvertieren\n\n### 1.3 Doc #155: Hook-System Python-Erweiterung\n- **Pfad:** `\/prozesse\/claude-hooks-prozess\/hook-system-python-erweiterung`\n- **Markdown-Elemente:** `#` Headings, ` ``` ` Code-Blöcke, `|` Tabellen, `**` Bold\n- **Aktion:** In HTML konvertieren\n\n### 1.4 Doc #156: MCP Server Refactoring Plan\n- **Pfad:** `\/mcp\/mcp-server-refactoring-plan`\n- **Markdown-Elemente:** `#` Headings, ` ``` ` Code-Blöcke, `|` Tabellen, `-` Listen, `**` Bold\n- **Zeilen:** ~800+ Zeilen Markdown\n- **Aktion:** In HTML konvertieren\n\n---\n\n## 2. Hierarchie-Probleme (MAJOR)\n\nDiese 6 Dokumente sind thematisch falsch eingeordnet.\n\n### 2.1 Doc #90: Enforcement-System\n- **Aktuell:** `\/server\/enforcement-system`\n- **Empfohlen:** `\/qualitaet\/enforcement-system` oder `\/betrieb\/enforcement-system`\n- **Begründung:** Qualitätssicherungs-Mechanismus (Pre-\/Post-Hooks, Regeldurchsetzung), nicht Server-Konfiguration\n\n### 2.2 Doc #156: MCP Server Refactoring Plan\n- **Aktuell:** `\/mcp\/mcp-server-refactoring-plan`\n- **Empfohlen:** `\/prozesse\/mcp-server-refactoring-plan`\n- **Begründung:** Refactoring-Pläne sind Prozess-Dokumente, nicht technische Referenzen\n\n### 2.3 Doc #85: Code-Refactoring Abschluss 2025-12-22\n- **Aktuell:** `\/betrieb\/refactoring-2025-12-22`\n- **Empfohlen:** `\/prozesse\/refactoring-2025-12-22`\n- **Begründung:** Refactoring-Dokumentation gehört zu Prozessen, nicht zu Betrieb\n\n### 2.4 Doc #140: Chat UI Redesign: 3-Spalten-Layout\n- **Aktuell:** `\/frontend\/chat-ui-redesign-3-spalten`\n- **Empfohlen:** `\/prozesse\/chat-ui-redesign-3-spalten`\n- **Begründung:** Redesign-Plan, nicht Frontend-Pattern oder Komponenten-Referenz\n\n### 2.5 Doc #89: Pipeline Qualitätsreport: LLM-Modellvergleich\n- **Aktuell:** `\/anwendungen\/content-pipeline\/pipeline-quality-report-llm-comparison`\n- **Empfohlen:** `\/qualitaet\/pipeline-llm-vergleich`\n- **Begründung:** Qualitätsreport gehört zur Qualitätssicherung\n\n### 2.6 Doc #139: Pipeline-Vergleich: Ollama vs Anthropic\n- **Aktuell:** `\/anwendungen\/content-pipeline\/pipeline-vergleich-ollama-anthropic`\n- **Empfohlen:** `\/qualitaet\/pipeline-vergleich-ollama-anthropic`\n- **Begründung:** Vergleichsanalysen gehören zur Qualitätssicherung\n\n---\n\n## 3. Redundanz-Probleme (MAJOR)\n\nDiese Dokumentpaare überschneiden sich thematisch und sollten konsolidiert werden.\n\n### 3.1 Claude Hooks Redundanz\n| ID | Titel | Pfad |\n|----|-------|------|\n| 80 | Claude Hooks | `\/betrieb\/claude-hooks` |\n| 92 | Claude Hooks Prozess | `\/prozesse\/claude-hooks-prozess` |\n\n**Empfehlung:** Konsolidieren - technische Implementierung unter `\/betrieb`, Prozess-Abläufe unter `\/prozesse`, aber keine Inhaltsduplizierung\n\n### 3.2 Contracts Redundanz\n| ID | Titel | Pfad |\n|----|-------|------|\n| 59 | Contracts | `\/betrieb\/contracts` |\n| 67 | Contracts | `\/anwendungen\/contracts` |\n\n**Empfehlung:** Konsolidieren oder klare Abgrenzung definieren\n\n---\n\n## 4. Veraltete Inhalte (MAJOR)\n\nDiese 6 Dokumente enthalten veraltete Informationen.\n\n### 4.1 Doc #22: Entitäten\n- **Pfad:** `\/ki-system\/ki-entitaeten`\n- **Probleme:**\n 1. Modell `gpt-oss:20b (Ollama)` existiert nicht\n 2. Tabelle `entity_semantics` existiert nicht\n 3. Tabelle `document_entities` heißt jetzt `chunk_entities`\n- **Aktion:** Modellname und Tabellennamen korrigieren\n\n### 4.2 Doc #26: Content\n- **Pfad:** `\/ki-system\/ki-content`\n- **Probleme:**\n 1. Erwähnt `author_profiles`, `content_contracts`, `content_structures` als separate Tabellen\n 2. Diese wurden zu `content_config` zusammengefasst\n- **Aktion:** Tabellenliste aktualisieren\n\n### 4.3 Doc #27: Datenbank\n- **Pfad:** `\/ki-system\/ki-datenbank`\n- **Probleme:**\n 1. Dokumentation (3 Tabellen) zeigt `dokumentation`, `dokumentation_chunks`, `dokumentation_history`\n 2. Korrekte Namen: `documents`, `chunks`\n 3. Row-Counts veraltet (dokumentation: 61, dokumentation_chunks: 323)\n- **Aktion:** Tabellennamen und Statistiken aktualisieren\n\n### 4.4 Doc #37: MCP-DB Tools\n- **Pfad:** `\/mcp\/mcp-db\/mcp-db-tools`\n- **Probleme:**\n 1. Default-Datenbank `ki_protokoll` in mehreren Stellen\n 2. Korrekt: `ki_dev`\n 3. db_delete Beispiel nutzt `database=\"ki_protokoll\"`\n- **Aktion:** Datenbank-Referenzen auf `ki_dev` ändern\n\n### 4.5 Doc #64: Doc2Vector Explorer\n- **Pfad:** `\/anwendungen\/semantic-explorer`\n- **Probleme:**\n 1. `Datenbank: ki_system (dokumentation, dokumentation_chunks)` falsch\n 2. Korrekt: `ki_content` mit Tabellen `documents`, `chunks`\n 3. Pipeline-Pfad `\/opt\/scripts\/pipeline\/analyze.py` existiert nicht mehr\n 4. Pipeline-Pfad `\/opt\/scripts\/pipeline\/sync_qdrant.py` veraltet\n- **Aktion:** Vollständige Überarbeitung mit aktuellen Werten\n\n### 4.6 Doc #79: Explorer API\n- **Pfad:** `\/api\/explorer`\n- **Probleme:**\n 1. `Datenbank: ki_system.dokumentation, dokumentation_chunks` falsch\n 2. Datenmodell zeigt veraltete Tabellennamen\n 3. API-Endpoint `\/api\/v1\/explorer\/dokumente` referenziert alte Struktur\n- **Aktion:** Datenmodell und API-Referenzen aktualisieren\n\n---\n\n## 5. Gesunde Dokumente\n\nDie folgenden Dokumentbereiche sind korrekt formatiert und aktuell:\n\n- **IDs 1-50:** Alle 50 Dokumente korrekt in HTML\n- **IDs 51-100:** 49 Dokumente korrekt in HTML (ID 98 existiert nicht)\n- **IDs 101-160:** 32 von 36 existierenden Dokumenten korrekt in HTML\n- **API-Dokumentation** (Docs #152, #153): Korrektes HTML mit CDATA-Wrapper\n- **Frontend-Dokumentation** (Docs #145, #150, #151): Korrektes HTML\n- **RAG-Prozess** (Doc #100): Detailliert und aktuell\n- **MCP-Server-Dokumentation** (Docs #36, #47, #65, #66, #142): Korrekte Struktur\n\n---\n\n## 6. Empfohlene Maßnahmen\n\n### Priorität 1: Markdown → HTML konvertieren (4 Docs)\n```\ndocs_update(id=143, content=\"<h1>PDF-Rotationserkennung<\/h1>...\")\ndocs_update(id=154, content=\"<h1>db.py Refactoring Plan<\/h1>...\")\ndocs_update(id=155, content=\"<h2>Hook-System Python-Erweiterung<\/h2>...\")\ndocs_update(id=156, content=\"<h1>MCP Server Refactoring Plan<\/h1>...\")\n```\n\n### Priorität 2: Hierarchie korrigieren (6 Docs)\n```\ndocs_move(id=90, new_parent_id=55) # 55 = \/betrieb oder \/qualitaet\ndocs_move(id=156, new_parent_id=38) # 38 = \/prozesse\ndocs_move(id=85, new_parent_id=38) # 38 = \/prozesse\ndocs_move(id=140, new_parent_id=38) # 38 = \/prozesse\ndocs_move(id=89, new_parent_id=?) # → \/qualitaet\ndocs_move(id=139, new_parent_id=?) # → \/qualitaet\n```\n\n### Priorität 3: Redundanzen klären (2 Paare)\n- Docs #80 + #92 (Claude Hooks): Inhalte zusammenführen oder abgrenzen\n- Docs #59 + #67 (Contracts): Inhalte zusammenführen oder abgrenzen\n\n### Priorität 4: Veraltete Inhalte aktualisieren (6 Docs)\n- Doc #22: Modellname und Tabellennamen korrigieren\n- Doc #26: Tabellenliste auf `content_config` aktualisieren\n- Doc #27: Tabellennamen `documents`, `chunks` verwenden\n- Doc #37: `ki_protokoll` → `ki_dev` ändern\n- Doc #64: Vollständige Überarbeitung (DB, Tabellen, Pfade)\n- Doc #79: Datenmodell und API-Referenzen aktualisieren\n\n---\n\n## 7. Statistik der vollständigen Analyse\n\n| Metrik | Wert |\n|--------|------|\n| Dokumente gesamt | 141 |\n| Dokumente analysiert | **141 (100%)** |\n| Existierende Dokumente | 135 (6 IDs nicht belegt) |\n| Kritische Probleme (Markdown) | 4 |\n| Major Probleme (Hierarchie) | 6 |\n| Major Probleme (Redundanz) | 4 (2 Paare) |\n| Major Probleme (Veraltet) | 6 |\n| Gesunde Dokumente | **119 (88.1%)** |\n\n---\n\n## 8. Konversions-Vorlage Markdown → HTML\n\n| Markdown | HTML |\n|----------|------|\n| `# Heading` | `<h1>Heading<\/h1>` |\n| `## Heading` | `<h2>Heading<\/h2>` |\n| `### Heading` | `<h3>Heading<\/h3>` |\n| `**bold**` | `<strong>bold<\/strong>` |\n| `*italic*` | `<em>italic<\/em>` |\n| `` `code` `` | `<code>code<\/code>` |\n| ` ```code block``` ` | `<pre><code>code block<\/code><\/pre>` |\n| `- item` | `<ul><li>item<\/li><\/ul>` |\n| `1. item` | `<ol><li>item<\/li><\/ol>` |\n| `| table |` | `<table><tr><td>table<\/td><\/tr><\/table>` |\n| `[link](url)` | `<a href=\"url\">link<\/a>` |\n\n---\n\n## 9. Änderungshistorie\n\n| Datum | Änderung |\n|-------|----------|\n| 2025-12-29 | Initiale Stichproben-Analyse (~30 Docs) |\n| 2025-12-29 | **Vollständige Analyse aller 141 Dokumente** via 5 parallele Agenten |\n\n---\n\n*Bericht generiert von Claude Code - Vollständige Dokumentations-Qualitätsanalyse*\n",
"structuredPatch": [
{
"oldStart": 1,
"oldLines": 8,
"newStart": 1,
"newLines": 8,
"lines": [
"-# Dokumentations-Qualitätsbericht",
"+# Dokumentations-Qualitätsbericht (Vollständige Analyse)",
" ",
" **Erstellt:** 2025-12-29",
"-**Analysiert:** 141 Dokumente in ki_dev.dokumentation",
"-**Methode:** Systematische Stichprobenanalyse via MCP-Docs",
"+**Analysiert:** 141 Dokumente in ki_dev.dokumentation (ALLE Dokumente)",
"+**Methode:** Parallelisierte Vollanalyse via 5 MCP-Docs Agenten",
" ",
" ---",
" "
]
},
{
"oldStart": 11,
"oldLines": 89,
"newStart": 11,
"newLines": 176,
"lines": [
" | Kategorie | Anzahl | Schweregrad |",
" |-----------|--------|-------------|",
" | Markdown-Format (statt HTML) | 4 | Kritisch |",
"-| Hierarchie-Probleme | 1 | Major |",
"-| Veraltete Inhalte | 2 | Major |",
"-| Faktische Fehler | 1 | Minor |",
"+| Hierarchie-Probleme | 6 | Major |",
"+| Redundanz-Probleme | 2 Paare | Major |",
"+| Veraltete Inhalte | 6 | Major |",
" ",
"+**Gesamtergebnis:** 16 Dokumente mit Problemen von 141 = **88.7% gesund**",
"+",
" ---",
" ",
"+## Analysemethode",
"+",
"+Die Analyse wurde durch 5 parallel laufende Agenten durchgeführt:",
"+",
"+| Agent | Bereich | Ergebnis |",
"+|-------|---------|----------|",
"+| Agent 1 | Docs 1-50: Markdown-Check | 0 gefunden |",
"+| Agent 2 | Docs 51-100: Markdown-Check | 0 gefunden |",
"+| Agent 3 | Docs 101-160: Markdown-Check | 4 gefunden |",
"+| Agent 4 | Alle Docs: Hierarchie-Analyse | 6 + 2 Redundanzen |",
"+| Agent 5 | Alle Docs: Veraltete Inhalte | 6 gefunden |",
"+",
"+---",
"+",
" ## 1. Dokumente im Markdown-Format (KRITISCH)",
" ",
"-Diese Dokumente verwenden Markdown-Syntax (`# Heading`, `**bold**`, ` ```code``` `, `| table |`) statt HTML. Das Docs-System erwartet HTML-Content.",
"+Diese 4 Dokumente verwenden Markdown-Syntax (`# Heading`, `**bold**`, ` ```code``` `, `| table |`) statt HTML.",
" ",
"-### 1.1 Doc #156: MCP Server Refactoring Plan",
"-- **Pfad:** `\/mcp\/mcp-server-refactoring-plan`",
"-- **Problem:** Vollständiges Markdown mit `# Headings`, `**bold**`, Code-Blöcken, Tabellen",
"-- **Zeilen:** ~800+ Zeilen Markdown",
"-- **Aktion erforderlich:** In HTML konvertieren",
"+### 1.1 Doc #143: PDF-Rotationserkennung",
"+- **Pfad:** `\/prozesse\/rag-prozess\/dokument-import\/pdf-rotation`",
"+- **Markdown-Elemente:** `#` Headings, ` ``` ` Code-Blöcke, `|` Tabellen, `-` Listen",
"+- **Aktion:** In HTML konvertieren",
" ",
" ### 1.2 Doc #154: db.py Refactoring Plan",
" - **Pfad:** `\/prozesse\/db-py-refactoring-plan`",
"-- **Problem:** Markdown-Format mit `## Headings`, ```` ```python ``` ````, Tabellen",
"-- **Aktion erforderlich:** In HTML konvertieren",
"+- **Markdown-Elemente:** `#` Headings, ` ``` ` Code-Blöcke, `|` Tabellen, `-` Listen, `**` Bold",
"+- **Aktion:** In HTML konvertieren",
" ",
" ### 1.3 Doc #155: Hook-System Python-Erweiterung",
" - **Pfad:** `\/prozesse\/claude-hooks-prozess\/hook-system-python-erweiterung`",
"-- **Problem:** Markdown-Format mit Tabellen, Code-Blöcken",
"-- **Aktion erforderlich:** In HTML konvertieren",
"+- **Markdown-Elemente:** `#` Headings, ` ``` ` Code-Blöcke, `|` Tabellen, `**` Bold",
"+- **Aktion:** In HTML konvertieren",
" ",
"-### 1.4 Doc #143: PDF-Rotationserkennung",
"-- **Pfad:** `\/prozesse\/rag-prozess\/dokument-import\/pdf-rotation`",
"-- **Problem:** Markdown-Format mit Headings, Tabellen, Code-Blöcken",
"-- **Aktion erforderlich:** In HTML konvertieren",
"+### 1.4 Doc #156: MCP Server Refactoring Plan",
"+- **Pfad:** `\/mcp\/mcp-server-refactoring-plan`",
"+- **Markdown-Elemente:** `#` Headings, ` ``` ` Code-Blöcke, `|` Tabellen, `-` Listen, `**` Bold",
"+- **Zeilen:** ~800+ Zeilen Markdown",
"+- **Aktion:** In HTML konvertieren",
" ",
" ---",
" ",
" ## 2. Hierarchie-Probleme (MAJOR)",
" ",
"+Diese 6 Dokumente sind thematisch falsch eingeordnet.",
"+",
" ### 2.1 Doc #90: Enforcement-System",
"-- **Aktueller Pfad:** `\/server\/enforcement-system`",
"-- **Problem:** Thematisch falsch eingeordnet. Das Enforcement-System ist kein Server-Bestandteil, sondern ein Entwicklungs-\/Qualitätswerkzeug.",
"-- **Empfohlener Pfad:** `\/betrieb\/enforcement-system` oder `\/qualitaet\/enforcement-system`",
"-- **Begründung:**",
"- - Gehört zur Code-Qualitätssicherung und Deployment-Pipeline",
"- - Steht in Zusammenhang mit Contracts, Hooks und Pre-Sync-Validierung",
"- - Alle verwandten Dokumente sind unter `\/betrieb` oder `\/qualitaet`",
"+- **Aktuell:** `\/server\/enforcement-system`",
"+- **Empfohlen:** `\/qualitaet\/enforcement-system` oder `\/betrieb\/enforcement-system`",
"+- **Begründung:** Qualitätssicherungs-Mechanismus (Pre-\/Post-Hooks, Regeldurchsetzung), nicht Server-Konfiguration",
" ",
"+### 2.2 Doc #156: MCP Server Refactoring Plan",
"+- **Aktuell:** `\/mcp\/mcp-server-refactoring-plan`",
"+- **Empfohlen:** `\/prozesse\/mcp-server-refactoring-plan`",
"+- **Begründung:** Refactoring-Pläne sind Prozess-Dokumente, nicht technische Referenzen",
"+",
"+### 2.3 Doc #85: Code-Refactoring Abschluss 2025-12-22",
"+- **Aktuell:** `\/betrieb\/refactoring-2025-12-22`",
"+- **Empfohlen:** `\/prozesse\/refactoring-2025-12-22`",
"+- **Begründung:** Refactoring-Dokumentation gehört zu Prozessen, nicht zu Betrieb",
"+",
"+### 2.4 Doc #140: Chat UI Redesign: 3-Spalten-Layout",
"+- **Aktuell:** `\/frontend\/chat-ui-redesign-3-spalten`",
"+- **Empfohlen:** `\/prozesse\/chat-ui-redesign-3-spalten`",
"+- **Begründung:** Redesign-Plan, nicht Frontend-Pattern oder Komponenten-Referenz",
"+",
"+### 2.5 Doc #89: Pipeline Qualitätsreport: LLM-Modellvergleich",
"+- **Aktuell:** `\/anwendungen\/content-pipeline\/pipeline-quality-report-llm-comparison`",
"+- **Empfohlen:** `\/qualitaet\/pipeline-llm-vergleich`",
"+- **Begründung:** Qualitätsreport gehört zur Qualitätssicherung",
"+",
"+### 2.6 Doc #139: Pipeline-Vergleich: Ollama vs Anthropic",
"+- **Aktuell:** `\/anwendungen\/content-pipeline\/pipeline-vergleich-ollama-anthropic`",
"+- **Empfohlen:** `\/qualitaet\/pipeline-vergleich-ollama-anthropic`",
"+- **Begründung:** Vergleichsanalysen gehören zur Qualitätssicherung",
"+",
" ---",
" ",
"-## 3. Veraltete Inhalte (MAJOR)",
"+## 3. Redundanz-Probleme (MAJOR)",
" ",
"-### 3.1 Doc #64: Doc2Vector Explorer",
"-- **Pfad:** `\/anwendungen\/semantic-explorer`",
"-- **Probleme:**",
"- 1. **Datenbank falsch:** Referenziert `ki_system` statt `ki_content`",
"- 2. **Tabellen falsch:** Referenziert `dokumentation, dokumentation_chunks` statt `documents, chunks`",
"- 3. **Pipeline-Pfade veraltet:** `\/opt\/scripts\/pipeline\/analyze.py` existiert nicht mehr",
"- 4. **API-Pfade möglicherweise veraltet:** `\/api\/v1\/explorer\/dokumente` etc.",
"-- **Letzte Aktualisierung:** 2025-12-20 (9 Tage alt, aber inzwischen geändert)",
"-- **Aktion erforderlich:** Vollständige Überarbeitung mit aktuellem Datenmodell",
"+Diese Dokumentpaare überschneiden sich thematisch und sollten konsolidiert werden.",
" ",
"-### 3.2 Doc #67: Contracts (Anwendung)",
"-- **Pfad:** `\/anwendungen\/contracts`",
"-- **Problem:** Referenziert `ki_protokoll.contracts`, aber Contracts-Tabelle ist in `ki_dev`",
"-- **Letzte Aktualisierung:** 2025-12-20",
"-- **Aktion erforderlich:** Datenbank-Referenz korrigieren",
"+### 3.1 Claude Hooks Redundanz",
"+| ID | Titel | Pfad |",
"+|----|-------|------|",
"+| 80 | Claude Hooks | `\/betrieb\/claude-hooks` |",
"+| 92 | Claude Hooks Prozess | `\/prozesse\/claude-hooks-prozess` |",
" ",
"+**Empfehlung:** Konsolidieren - technische Implementierung unter `\/betrieb`, Prozess-Abläufe unter `\/prozesse`, aber keine Inhaltsduplizierung",
"+",
"+### 3.2 Contracts Redundanz",
"+| ID | Titel | Pfad |",
"+|----|-------|------|",
"+| 59 | Contracts | `\/betrieb\/contracts` |",
"+| 67 | Contracts | `\/anwendungen\/contracts` |",
"+",
"+**Empfehlung:** Konsolidieren oder klare Abgrenzung definieren",
"+",
" ---",
" ",
"-## 4. Faktische Fehler (MINOR)",
"+## 4. Veraltete Inhalte (MAJOR)",
" ",
"-### 4.1 Doc #10: PHP 8.4",
"-- **Pfad:** `\/anwendungen\/php`",
"-- **Problem:** Gibt Version `8.4.16` an - diese sollte verifiziert werden",
"-- **Verifizierung:** `php -v` auf dem Server ausführen",
"-- **Risiko:** Gering, da Versionsnummer sich ändern kann",
"+Diese 6 Dokumente enthalten veraltete Informationen.",
" ",
"+### 4.1 Doc #22: Entitäten",
"+- **Pfad:** `\/ki-system\/ki-entitaeten`",
"+- **Probleme:**",
"+ 1. Modell `gpt-oss:20b (Ollama)` existiert nicht",
"+ 2. Tabelle `entity_semantics` existiert nicht",
"+ 3. Tabelle `document_entities` heißt jetzt `chunk_entities`",
"+- **Aktion:** Modellname und Tabellennamen korrigieren",
"+",
"+### 4.2 Doc #26: Content",
"+- **Pfad:** `\/ki-system\/ki-content`",
"+- **Probleme:**",
"+ 1. Erwähnt `author_profiles`, `content_contracts`, `content_structures` als separate Tabellen",
"+ 2. Diese wurden zu `content_config` zusammengefasst",
"+- **Aktion:** Tabellenliste aktualisieren",
"+",
"+### 4.3 Doc #27: Datenbank",
"+- **Pfad:** `\/ki-system\/ki-datenbank`",
"+- **Probleme:**",
"+ 1. Dokumentation (3 Tabellen) zeigt `dokumentation`, `dokumentation_chunks`, `dokumentation_history`",
"+ 2. Korrekte Namen: `documents`, `chunks`",
"+ 3. Row-Counts veraltet (dokumentation: 61, dokumentation_chunks: 323)",
"+- **Aktion:** Tabellennamen und Statistiken aktualisieren",
"+",
"+### 4.4 Doc #37: MCP-DB Tools",
"+- **Pfad:** `\/mcp\/mcp-db\/mcp-db-tools`",
"+- **Probleme:**",
"+ 1. Default-Datenbank `ki_protokoll` in mehreren Stellen",
"+ 2. Korrekt: `ki_dev`",
"+ 3. db_delete Beispiel nutzt `database=\"ki_protokoll\"`",
"+- **Aktion:** Datenbank-Referenzen auf `ki_dev` ändern",
"+",
"+### 4.5 Doc #64: Doc2Vector Explorer",
"+- **Pfad:** `\/anwendungen\/semantic-explorer`",
"+- **Probleme:**",
"+ 1. `Datenbank: ki_system (dokumentation, dokumentation_chunks)` falsch",
"+ 2. Korrekt: `ki_content` mit Tabellen `documents`, `chunks`",
"+ 3. Pipeline-Pfad `\/opt\/scripts\/pipeline\/analyze.py` existiert nicht mehr",
"+ 4. Pipeline-Pfad `\/opt\/scripts\/pipeline\/sync_qdrant.py` veraltet",
"+- **Aktion:** Vollständige Überarbeitung mit aktuellen Werten",
"+",
"+### 4.6 Doc #79: Explorer API",
"+- **Pfad:** `\/api\/explorer`",
"+- **Probleme:**",
"+ 1. `Datenbank: ki_system.dokumentation, dokumentation_chunks` falsch",
"+ 2. Datenmodell zeigt veraltete Tabellennamen",
"+ 3. API-Endpoint `\/api\/v1\/explorer\/dokumente` referenziert alte Struktur",
"+- **Aktion:** Datenmodell und API-Referenzen aktualisieren",
"+",
" ---",
" ",
"-## 5. Positive Befunde",
"+## 5. Gesunde Dokumente",
" ",
" Die folgenden Dokumentbereiche sind korrekt formatiert und aktuell:",
" ",
"+- **IDs 1-50:** Alle 50 Dokumente korrekt in HTML",
"+- **IDs 51-100:** 49 Dokumente korrekt in HTML (ID 98 existiert nicht)",
"+- **IDs 101-160:** 32 von 36 existierenden Dokumenten korrekt in HTML",
" - **API-Dokumentation** (Docs #152, #153): Korrektes HTML mit CDATA-Wrapper",
" - **Frontend-Dokumentation** (Docs #145, #150, #151): Korrektes HTML",
"-- **Betrieb-Dokumentation** (Doc #80): Umfangreich und gut strukturiert",
" - **RAG-Prozess** (Doc #100): Detailliert und aktuell",
" - **MCP-Server-Dokumentation** (Docs #36, #47, #65, #66, #142): Korrekte Struktur",
" "
]
},
{
"oldStart": 101,
"oldLines": 50,
"newStart": 188,
"newLines": 64,
"lines": [
" ",
" ## 6. Empfohlene Maßnahmen",
" ",
"-### Priorität 1: Markdown → HTML konvertieren",
"+### Priorität 1: Markdown → HTML konvertieren (4 Docs)",
" ```",
"-docs_update(id=156, content=\"<h1>MCP Server Refactoring Plan<\/h1>...\")",
"+docs_update(id=143, content=\"<h1>PDF-Rotationserkennung<\/h1>...\")",
" docs_update(id=154, content=\"<h1>db.py Refactoring Plan<\/h1>...\")",
" docs_update(id=155, content=\"<h2>Hook-System Python-Erweiterung<\/h2>...\")",
"-docs_update(id=143, content=\"<h1>PDF-Rotationserkennung<\/h1>...\")",
"+docs_update(id=156, content=\"<h1>MCP Server Refactoring Plan<\/h1>...\")",
" ```",
" ",
"-### Priorität 2: Hierarchie korrigieren",
"+### Priorität 2: Hierarchie korrigieren (6 Docs)",
" ```",
"-docs_move(id=90, new_parent_id=55) # 55 = \/betrieb",
"+docs_move(id=90, new_parent_id=55) # 55 = \/betrieb oder \/qualitaet",
"+docs_move(id=156, new_parent_id=38) # 38 = \/prozesse",
"+docs_move(id=85, new_parent_id=38) # 38 = \/prozesse",
"+docs_move(id=140, new_parent_id=38) # 38 = \/prozesse",
"+docs_move(id=89, new_parent_id=?) # → \/qualitaet",
"+docs_move(id=139, new_parent_id=?) # → \/qualitaet",
" ```",
" ",
"-### Priorität 3: Veraltete Inhalte aktualisieren",
"-- Doc #64 komplett überarbeiten mit aktuellen Tabellennamen und Pfaden",
"-- Doc #67 Datenbank-Referenz korrigieren",
"+### Priorität 3: Redundanzen klären (2 Paare)",
"+- Docs #80 + #92 (Claude Hooks): Inhalte zusammenführen oder abgrenzen",
"+- Docs #59 + #67 (Contracts): Inhalte zusammenführen oder abgrenzen",
" ",
"+### Priorität 4: Veraltete Inhalte aktualisieren (6 Docs)",
"+- Doc #22: Modellname und Tabellennamen korrigieren",
"+- Doc #26: Tabellenliste auf `content_config` aktualisieren",
"+- Doc #27: Tabellennamen `documents`, `chunks` verwenden",
"+- Doc #37: `ki_protokoll` → `ki_dev` ändern",
"+- Doc #64: Vollständige Überarbeitung (DB, Tabellen, Pfade)",
"+- Doc #79: Datenmodell und API-Referenzen aktualisieren",
"+",
" ---",
" ",
"-## 7. Statistik der Analyse",
"+## 7. Statistik der vollständigen Analyse",
" ",
" | Metrik | Wert |",
" |--------|------|",
" | Dokumente gesamt | 141 |",
"-| Dokumente analysiert | ~30 (Stichprobe) |",
"-| Kritische Probleme | 4 |",
"-| Major Probleme | 3 |",
"-| Minor Probleme | 1 |",
"-| Gesunde Dokumente | ~90% |",
"+| Dokumente analysiert | **141 (100%)** |",
"+| Existierende Dokumente | 135 (6 IDs nicht belegt) |",
"+| Kritische Probleme (Markdown) | 4 |",
"+| Major Probleme (Hierarchie) | 6 |",
"+| Major Probleme (Redundanz) | 4 (2 Paare) |",
"+| Major Probleme (Veraltet) | 6 |",
"+| Gesunde Dokumente | **119 (88.1%)** |",
" ",
" ---",
" ",
" ## 8. Konversions-Vorlage Markdown → HTML",
" ",
"-Für die Konvertierung der Markdown-Dokumente:",
"-",
" | Markdown | HTML |",
" |----------|------|",
" | `# Heading` | `<h1>Heading<\/h1>` |",
" | `## Heading` | `<h2>Heading<\/h2>` |",
"+| `### Heading` | `<h3>Heading<\/h3>` |",
" | `**bold**` | `<strong>bold<\/strong>` |",
" | `*italic*` | `<em>italic<\/em>` |",
" | `` `code` `` | `<code>code<\/code>` |",
"-| ```` ```code block``` ```` | `<pre><code>code block<\/code><\/pre>` |",
"+| ` ```code block``` ` | `<pre><code>code block<\/code><\/pre>` |",
" | `- item` | `<ul><li>item<\/li><\/ul>` |",
" | `1. item` | `<ol><li>item<\/li><\/ol>` |",
" | `| table |` | `<table><tr><td>table<\/td><\/tr><\/table>` |"
]
},
{
"oldStart": 152,
"oldLines": 4,
"newStart": 253,
"newLines": 13,
"lines": [
" ",
" ---",
" ",
"-*Bericht generiert von Claude Code - Dokumentations-Qualitätsanalyse*",
"+## 9. Änderungshistorie",
"+",
"+| Datum | Änderung |",
"+|-------|----------|",
"+| 2025-12-29 | Initiale Stichproben-Analyse (~30 Docs) |",
"+| 2025-12-29 | **Vollständige Analyse aller 141 Dokumente** via 5 parallele Agenten |",
"+",
"+---",
"+",
"+*Bericht generiert von Claude Code - Vollständige Dokumentations-Qualitätsanalyse*"
]
}
],
"originalFile": "# Dokumentations-Qualitätsbericht\n\n**Erstellt:** 2025-12-29\n**Analysiert:** 141 Dokumente in ki_dev.dokumentation\n**Methode:** Systematische Stichprobenanalyse via MCP-Docs\n\n---\n\n## Zusammenfassung\n\n| Kategorie | Anzahl | Schweregrad |\n|-----------|--------|-------------|\n| Markdown-Format (statt HTML) | 4 | Kritisch |\n| Hierarchie-Probleme | 1 | Major |\n| Veraltete Inhalte | 2 | Major |\n| Faktische Fehler | 1 | Minor |\n\n---\n\n## 1. Dokumente im Markdown-Format (KRITISCH)\n\nDiese Dokumente verwenden Markdown-Syntax (`# Heading`, `**bold**`, ` ```code``` `, `| table |`) statt HTML. Das Docs-System erwartet HTML-Content.\n\n### 1.1 Doc #156: MCP Server Refactoring Plan\n- **Pfad:** `\/mcp\/mcp-server-refactoring-plan`\n- **Problem:** Vollständiges Markdown mit `# Headings`, `**bold**`, Code-Blöcken, Tabellen\n- **Zeilen:** ~800+ Zeilen Markdown\n- **Aktion erforderlich:** In HTML konvertieren\n\n### 1.2 Doc #154: db.py Refactoring Plan\n- **Pfad:** `\/prozesse\/db-py-refactoring-plan`\n- **Problem:** Markdown-Format mit `## Headings`, ```` ```python ``` ````, Tabellen\n- **Aktion erforderlich:** In HTML konvertieren\n\n### 1.3 Doc #155: Hook-System Python-Erweiterung\n- **Pfad:** `\/prozesse\/claude-hooks-prozess\/hook-system-python-erweiterung`\n- **Problem:** Markdown-Format mit Tabellen, Code-Blöcken\n- **Aktion erforderlich:** In HTML konvertieren\n\n### 1.4 Doc #143: PDF-Rotationserkennung\n- **Pfad:** `\/prozesse\/rag-prozess\/dokument-import\/pdf-rotation`\n- **Problem:** Markdown-Format mit Headings, Tabellen, Code-Blöcken\n- **Aktion erforderlich:** In HTML konvertieren\n\n---\n\n## 2. Hierarchie-Probleme (MAJOR)\n\n### 2.1 Doc #90: Enforcement-System\n- **Aktueller Pfad:** `\/server\/enforcement-system`\n- **Problem:** Thematisch falsch eingeordnet. Das Enforcement-System ist kein Server-Bestandteil, sondern ein Entwicklungs-\/Qualitätswerkzeug.\n- **Empfohlener Pfad:** `\/betrieb\/enforcement-system` oder `\/qualitaet\/enforcement-system`\n- **Begründung:**\n - Gehört zur Code-Qualitätssicherung und Deployment-Pipeline\n - Steht in Zusammenhang mit Contracts, Hooks und Pre-Sync-Validierung\n - Alle verwandten Dokumente sind unter `\/betrieb` oder `\/qualitaet`\n\n---\n\n## 3. Veraltete Inhalte (MAJOR)\n\n### 3.1 Doc #64: Doc2Vector Explorer\n- **Pfad:** `\/anwendungen\/semantic-explorer`\n- **Probleme:**\n 1. **Datenbank falsch:** Referenziert `ki_system` statt `ki_content`\n 2. **Tabellen falsch:** Referenziert `dokumentation, dokumentation_chunks` statt `documents, chunks`\n 3. **Pipeline-Pfade veraltet:** `\/opt\/scripts\/pipeline\/analyze.py` existiert nicht mehr\n 4. **API-Pfade möglicherweise veraltet:** `\/api\/v1\/explorer\/dokumente` etc.\n- **Letzte Aktualisierung:** 2025-12-20 (9 Tage alt, aber inzwischen geändert)\n- **Aktion erforderlich:** Vollständige Überarbeitung mit aktuellem Datenmodell\n\n### 3.2 Doc #67: Contracts (Anwendung)\n- **Pfad:** `\/anwendungen\/contracts`\n- **Problem:** Referenziert `ki_protokoll.contracts`, aber Contracts-Tabelle ist in `ki_dev`\n- **Letzte Aktualisierung:** 2025-12-20\n- **Aktion erforderlich:** Datenbank-Referenz korrigieren\n\n---\n\n## 4. Faktische Fehler (MINOR)\n\n### 4.1 Doc #10: PHP 8.4\n- **Pfad:** `\/anwendungen\/php`\n- **Problem:** Gibt Version `8.4.16` an - diese sollte verifiziert werden\n- **Verifizierung:** `php -v` auf dem Server ausführen\n- **Risiko:** Gering, da Versionsnummer sich ändern kann\n\n---\n\n## 5. Positive Befunde\n\nDie folgenden Dokumentbereiche sind korrekt formatiert und aktuell:\n\n- **API-Dokumentation** (Docs #152, #153): Korrektes HTML mit CDATA-Wrapper\n- **Frontend-Dokumentation** (Docs #145, #150, #151): Korrektes HTML\n- **Betrieb-Dokumentation** (Doc #80): Umfangreich und gut strukturiert\n- **RAG-Prozess** (Doc #100): Detailliert und aktuell\n- **MCP-Server-Dokumentation** (Docs #36, #47, #65, #66, #142): Korrekte Struktur\n\n---\n\n## 6. Empfohlene Maßnahmen\n\n### Priorität 1: Markdown → HTML konvertieren\n```\ndocs_update(id=156, content=\"<h1>MCP Server Refactoring Plan<\/h1>...\")\ndocs_update(id=154, content=\"<h1>db.py Refactoring Plan<\/h1>...\")\ndocs_update(id=155, content=\"<h2>Hook-System Python-Erweiterung<\/h2>...\")\ndocs_update(id=143, content=\"<h1>PDF-Rotationserkennung<\/h1>...\")\n```\n\n### Priorität 2: Hierarchie korrigieren\n```\ndocs_move(id=90, new_parent_id=55) # 55 = \/betrieb\n```\n\n### Priorität 3: Veraltete Inhalte aktualisieren\n- Doc #64 komplett überarbeiten mit aktuellen Tabellennamen und Pfaden\n- Doc #67 Datenbank-Referenz korrigieren\n\n---\n\n## 7. Statistik der Analyse\n\n| Metrik | Wert |\n|--------|------|\n| Dokumente gesamt | 141 |\n| Dokumente analysiert | ~30 (Stichprobe) |\n| Kritische Probleme | 4 |\n| Major Probleme | 3 |\n| Minor Probleme | 1 |\n| Gesunde Dokumente | ~90% |\n\n---\n\n## 8. Konversions-Vorlage Markdown → HTML\n\nFür die Konvertierung der Markdown-Dokumente:\n\n| Markdown | HTML |\n|----------|------|\n| `# Heading` | `<h1>Heading<\/h1>` |\n| `## Heading` | `<h2>Heading<\/h2>` |\n| `**bold**` | `<strong>bold<\/strong>` |\n| `*italic*` | `<em>italic<\/em>` |\n| `` `code` `` | `<code>code<\/code>` |\n| ```` ```code block``` ```` | `<pre><code>code block<\/code><\/pre>` |\n| `- item` | `<ul><li>item<\/li><\/ul>` |\n| `1. item` | `<ol><li>item<\/li><\/ol>` |\n| `| table |` | `<table><tr><td>table<\/td><\/tr><\/table>` |\n| `[link](url)` | `<a href=\"url\">link<\/a>` |\n\n---\n\n*Bericht generiert von Claude Code - Dokumentations-Qualitätsanalyse*\n"
}
}