{
"tool_response": {
"type": "text",
"file": {
"filePath": "\/var\/www\/claude.md",
"content": "# Server st\n\n## Pfade\n\n- Docs (statisch): `\/var\/www\/docs\/`\n- Docs (online): `https:\/\/dev.campus.systemische-tools.de\/docs`\n- Credentials: `\/var\/www\/docs\/credentials\/credentials.md`\n- Backup-Script: `\/opt\/scripts\/backup.sh`\n- Sync-Script: `\/opt\/scripts\/sync-dev-prod.sh`\n- PHP-Check-Script: `\/opt\/scripts\/php-check.sh`\n- Contracts: `\/var\/www\/docs\/contracts\/`\n\n## PHP Quality & Security Tools\n\n- **Installation:** `\/opt\/php-tools\/`\n- **PHPStan:** 2.1.33 + Strict Rules (Level 5)\n- **PHP-CS-Fixer:** 3.92.3 (PSR-12)\n- **Semgrep:** 1.146.0 (OWASP Security Scanner)\n- **Composer Audit:** CVE-Check für Dependencies\n- **Docs:** `\/docs\/modul\/php-quality`\n\n**4 Checks:**\n1. PHPStan + Strict Rules (Typen, Bugs)\n2. PHP-CS-Fixer (PSR-12 Style)\n3. Composer Audit (Dependency CVEs)\n4. Semgrep (SQL Injection, XSS, Command Injection, etc.)\n\n**Automatisierung:**\n- PostToolUse Hook: Style-Check nach jeder PHP-Änderung (Warnung)\n- Pre-Sync: Alle 4 Checks vor Deployment (blockierend)\n\n**Verwendung:**\n```bash\n\/opt\/scripts\/php-check.sh # dev prüfen\n\/opt\/scripts\/php-check.sh \/pfad --fix # mit Korrektur\n```\n\n## Datenbanken\n\n### ki_dev (Entwicklung\/Infrastruktur)\nAlles für Claude Code, MCP, Tasks, Contracts, Docs, Pipeline:\n- **Logs:** protokoll, mcp_log, file_backup_history\n- **Tasks:** tasks, task_assignments, task_results, task_comments\n- **Contracts:** contracts, contract_history, contract_validations\n- **Docs:** dokumentation, dokumentation_chunks, dokumentation_history\n- **Pipeline:** pipeline_log, pipeline_queue, prompts, system_prompts\n\n### ki_content (Inhalt\/User-facing)\nAlles für Content, Chat, Wissen, Taxonomie:\n- **Content:** content_*, author_profiles, critics\n- **Chat:** chat_messages, chat_sessions\n- **Wissen:** chunks, entities, documents, taxonomy_terms\n\n## Claude Code Hooks\n\n### KI-Protokoll\n- **Script:** `\/var\/www\/tools\/ki-protokoll\/claude-hook\/log_to_db.py`\n- **Datenbank:** `ki_dev.protokoll`\n- **Trigger:** Alle Hooks (UserPromptSubmit, PreToolUse, PostToolUse, etc.)\n- **Docs:** `\/docs\/modul\/ki-protokoll`\n\n### File Backup Hook\n- **Script:** `\/var\/www\/tools\/ki-protokoll\/claude-hook\/file_backup_hook.py`\n- **Datenbank:** `ki_dev.file_backup_history`\n- **Trigger:** PreToolUse (Edit, Write)\n- **Docs:** `\/docs\/modul\/file-backup-hook`\n\n### Hooks-Konfiguration\n- **Pfad:** `\/var\/www\/dev.campus.systemische-tools.de\/.claude\/settings.local.json`\n\n## KI-Tasks\n\nTask-Management-System für Mensch-KI-Kollaboration.\n\n- **Web-UI:** `\/tasks` (https:\/\/dev.campus.systemische-tools.de\/tasks)\n- **API:** `\/api\/v1\/tasks`\n- **CLI:** `\/var\/www\/tools\/ki-tasks\/cli.php`\n- **Datenbank:** `ki_dev` (tasks, task_assignments, task_results, task_comments)\n- **Docs:** `\/docs\/ki-tasks`\n\n**Task-Typen:** human_task, ai_task, mixed\n**Status:** pending → in_progress → completed | failed | cancelled\n**Assignees:** human, ollama, claude, anthropic_api\n\n**CLI-Befehle:**\n```bash\nphp \/var\/www\/tools\/ki-tasks\/cli.php create --title=\"Aufgabe\" --type=ai_task\nphp \/var\/www\/tools\/ki-tasks\/cli.php list --status=pending\nphp \/var\/www\/tools\/ki-tasks\/cli.php execute <id> --model=mistral\nphp \/var\/www\/tools\/ki-tasks\/cli.php stats\n```\n\n**API-Endpoints:**\n- `GET \/api\/v1\/tasks` - Liste mit Filtern\n- `POST \/api\/v1\/tasks` - Task erstellen\n- `POST \/api\/v1\/tasks\/{id}\/execute` - KI-Ausführung\n- `PUT \/api\/v1\/tasks\/{id}\/status` - Status ändern\n\n**Hook-Integration:** `task_hook.py` erkennt `TODO:`, `TASK:`, `@task`, `#task` in Prompts und erstellt automatisch Tasks.\n\n## Contracts\n\nContracts werden in der Datenbank verwaltet mit Web-UI und MCP-API.\n\n- **Web-UI:** `\/contracts` (https:\/\/dev.campus.systemische-tools.de\/contracts)\n- **Datenbank:** `ki_dev.contracts`\n- **MCP-Tools:** contracts_list, contracts_get, contracts_create, contracts_update, contracts_validate, contracts_history\n- **Legacy-Pfad:** `\/var\/www\/docs\/contracts\/` (migriert)\n- **Docs:** `\/docs\/modul\/contracts`\n\n### Betriebsdokumentation\n- **Contract:** `\/var\/www\/docs\/contracts\/betriebsdokumentation-pruefung_v1.1.yaml`\n- **Scope:** Alle `.php` Dateien in `\/src\/View\/docs\/`\n- **Platform:** Debian 13, Systemd, Apache 2.4\n\n**Validierungsfaktoren (Priorität):**\n1. path_existence (critical) - Dateipfade müssen existieren\n2. command_validity (critical) - Befehle müssen korrekt sein\n3. service_accuracy (critical) - Ports\/Versionen müssen stimmen\n4. config_correctness (major) - Konfig-Beispiele müssen passen\n5. structure_compliance (major) - Breadcrumb, h1, Intro, Tabelle, Commands\n6. link_integrity (major) - Interne Links müssen funktionieren\n7. terminology (minor) - Einheitliche Begriffe\n\n**Pass-Schwelle:**\n- 0 critical violations (sonst: rejected)\n- max 2 major violations (sonst: revision required)\n- max 5 minor violations\n\n**Enforcement:** Kein Sync zu prod bei critical violations.\n\n### Layered Architecture\n- **Contract:** `\/var\/www\/docs\/contracts\/layered-architecture-pruefung_v1.0.yaml`\n- **Status:** active (migriert 2025-12-20)\n\n**Aktuelle Architektur:**\n```\n\/src\/ # Backend (MVC)\n├── Framework\/ # App, Router, Controller-Base\n├── Controller\/ # HTTP Controller\n├── Domain\/Entity\/ # Entitäten (leer, für Erweiterung)\n├── Domain\/Repository\/ # Repository-Interfaces (leer)\n├── UseCases\/ # Anwendungsfälle (leer)\n├── Infrastructure\/ # DB, External Services\n│ └── Persistence\/ # Connection.php\n└── View\/ # Server-Templates\n\n\/app\/ # Frontend (MVP)\n├── Presenter\/ # UI-Logik (leer, für Erweiterung)\n└── View\/ # Passive Views (leer)\n```\n\n**Namespace-Mapping (autoload.php):**\n- `Framework\\` → `\/src\/Framework\/`\n- `Controller\\` → `\/src\/Controller\/`\n- `Domain\\` → `\/src\/Domain\/`\n- `UseCases\\` → `\/src\/UseCases\/`\n- `Infrastructure\\` → `\/src\/Infrastructure\/`\n- `Presenter\\` → `\/app\/Presenter\/`\n\n### JS Browser Architecture (ZUKÜNFTIG)\n- **Contract:** `\/var\/www\/docs\/contracts\/js-browser-architecture-contract_v2.yaml`\n- **Status:** future (keine komplexe JS-App vorhanden)\n\n## Dokumentation\n\n### Server\n- `\/docs\/server` - Übersicht, Domains, Sicherheit, System\n- `\/docs\/modul\/backup` - Tägliches Backup (03:00)\n- `\/docs\/modul\/file-backup-hook` - Claude Code Pre-Hook\n\n### KI-Stack\n- `\/docs\/modul\/ki-protokoll` - Claude Logging\n- `\/docs\/modul\/ollama` - LLM Runtime\n- `\/docs\/modul\/qdrant` - Vektor-Datenbank\n- `\/docs\/modul\/nvidia` - NVIDIA CUDA\n\n### Anwendungen\n- `\/docs\/anwendungen` - Übersicht\n- `\/docs\/modul\/apache` - Webserver\n- `\/docs\/modul\/php` - PHP 8.4\n- `\/docs\/modul\/mariadb` - Datenbank\n- `\/docs\/modul\/phpmyadmin` - Web-Verwaltung\n- `\/docs\/modul\/nextcloud` - Cloud-Speicher\n- `\/docs\/modul\/php-quality` - PHPStan, PHP-CS-Fixer\n\n## Dokumentations-Template\n\n```php\n<?php ob_start(); ?>\n\n<nav class=\"breadcrumb\">\n <a href=\"\/docs\">Dokumentation<\/a> » <a href=\"\/docs\/server\">Server<\/a> » Modulname\n<\/nav>\n\n<h1>Modulname<\/h1>\n<p>Kurzbeschreibung.<\/p>\n\n<table>\n <tr><th>Eigenschaft<\/th><td>Wert<\/td><\/tr>\n<\/table>\n\n<h2>Verwendung<\/h2>\n<pre><code>befehl --optionen<\/code><\/pre>\n\n<?php $content = ob_get_clean(); ?>\n<?php require VIEW_PATH . '\/layout.php'; ?>\n```\n\n## MCP-Server (Pflicht)\n\n### MCP-DB - Datenbankzugriff\n**IMMER** für Datenbank-Lesezugriffe verwenden:\n- `db_select(query)` - SELECT-Abfragen\n- `db_schema()` - Schema anzeigen\n- `db_stats()` - Statistiken\n\n**NIEMALS** direkte mysql\/mariadb-Befehle mit Passwörtern ausführen.\n\nVorteile: Keine Credentials im Verlauf, Audit-Logging, SQL-Injection-Schutz.\nDocs: `\/docs\/mcp\/mcp-db`\n\n### MCP-Tasks - Task-Management\n**IMMER** für Task-Operationen verwenden:\n- `tasks_list(compact=True, limit=10)` - Tasks auflisten (Token-optimiert)\n- `tasks_create()` - Task erstellen\n- `tasks_get(id)` - Task-Details (vollständig)\n- `tasks_status(id, status)` - Status ändern\n- `tasks_execute(id)` - Mit Ollama ausführen\n- `quality_check()` - PHP-Prüfung\n- `quality_report()` - Vollständiger Report\n\n**Token-Optimierung (tasks_list):**\n- `compact=True` (default): nur id\/title\/description(100)\/status\/type\n- `compact=False`: alle 13 Felder\n- `limit=10` (default), max 100\n\n**NIEMALS** direkte SQL auf tasks\/task_assignments\/task_results.\n\n**Workflow:**\n1. `tasks_create()` → Task erstellen\n2. `tasks_status(id, \"in_progress\")` → Starten\n3. Arbeit erledigen\n4. `quality_check()` → Bei Code-Änderungen\n5. `tasks_status(id, \"completed\")` → Abschließen\n\nDocs: `\/docs\/mcp\/mcp-tasks`\n\n### MCP-Contracts - Contract-Management\n**IMMER** für Contract-Operationen verwenden:\n- `contracts_list(compact=True)` - Contracts auflisten (Token-optimiert)\n- `contracts_get(id)` - Contract-Details\n- `contracts_create()` - Contract erstellen\n- `contracts_update()` - Neue Version (mit Historie)\n- `contracts_validate(id)` - Validierung ausführen\n- `contracts_history(id)` - Änderungshistorie\n- `contracts_statistics()` - Statistiken\n\n**Token-Optimierung (contracts_list):**\n- `compact=True` (default): nur id\/name\/version\/status\n- `compact=False`: inkl. yaml_content\n\n**NIEMALS** direkte SQL auf contracts\/contract_history\/contract_validations.\n\nDocs: `\/docs\/mcp\/mcp-contracts`\n\n### MCP-Docs - Dokumentations-Management\n**IMMER** für Dokumentations-Operationen verwenden:\n- `docs_list(compact=True)` - Dokumente auflisten (Token-optimiert)\n- `docs_get(id)` oder `docs_get(path=\"\/server\/ssh\")` - Dokument abrufen\n- `docs_create()` - Neues Dokument erstellen\n- `docs_update(id)` - Dokument bearbeiten\n- `docs_delete(id)` - Dokument löschen\n- `docs_move(id, new_parent_id)` - Position ändern\n- `docs_hierarchy()` - Kompletter Baum\n- `docs_search(query)` - Volltextsuche\n- `docs_statistics()` - Statistiken\n\n**Token-Optimierung (docs_list):**\n- `compact=True` (default): nur id\/path\/title\/status (ohne Content)\n- `compact=False`: vollständige Ausgabe inkl. Content\n\n**NIEMALS** direkte SQL auf ki_dev.dokumentation.\n\nDocs: `\/docs\/mcp\/mcp-docs`\n\n## Wichtige Regeln\n\n- **KEIN GIT** - Git ist auf diesem Server verboten\n- **Backup vor Änderungen** - File Backup Hook sichert automatisch\n- **Entwicklung zuerst auf dev** - dann sync zu prod\n- **Credentials** nu... [TRUNCATED-02b7a1a08c4ba894]",
"numLines": 294,
"startLine": 1,
"totalLines": 294
}
}
}