Apache Webserver

Erstellt: 2025-12-20 | Aktualisiert: 2025-12-20

Webserver der alle HTTP/HTTPS-Anfragen entgegennimmt und an PHP weiterleitet. Hostet die drei Domains mit virtuellen Hosts und sorgt für SSL-Terminierung.

Module

ssl http2 brotli rewrite headers proxy proxy_http proxy_fcgi proxy_wstunnel setenvif

Brotli-Kompression

Datei: /etc/apache2/conf-available/brotli.conf

<IfModule mod_brotli.c>
    AddOutputFilterByType BROTLI_COMPRESS text/html text/plain text/xml text/css text/javascript application/javascript application/json application/xml
    BrotliCompressionQuality 4
</IfModule>

Virtual Hosts

• campus.systemische-tools.de → /var/www/prod.../public
• dev.campus.systemische-tools.de → /var/www/dev.../public
• files.campus.systemische-tools.de → /var/www/nextcloud

Befehle

systemctl status apache2
systemctl restart apache2
apache2 -v

PHP 8.4

Erstellt: 2025-12-20 | Aktualisiert: 2025-12-27

Serverseitige Programmiersprache für die Webanwendung. Läuft als FPM (FastCGI Process Manager) für bessere Performance und Ressourcennutzung.

Installierte Erweiterungen

• mysql, curl, gd, mbstring, xml, zip
• intl, bcmath, opcache, apcu, redis, imagick

Installation

apt-get install -y php8.4 php8.4-cli php8.4-fpm php8.4-mysql \
    php8.4-curl php8.4-gd php8.4-mbstring php8.4-xml php8.4-zip \
    php8.4-intl php8.4-bcmath php8.4-opcache php8.4-apcu php8.4-redis \
    php8.4-imagick libapache2-mod-php8.4

Befehle

php -v
systemctl status php8.4-fpm
systemctl restart php8.4-fpm

MariaDB

Erstellt: 2025-12-20 | Aktualisiert: 2025-12-31

Relationale Datenbank für strukturierte Daten. MySQL-kompatibel, schnell und zuverlässig. Speichert alle Anwendungsdaten des KI-Systems.

Datenbanken

Zugriff via MCP

Wichtig: Datenbankzugriff erfolgt ausschließlich über MCP-DB. Keine direkten SQL-Befehle!

# MCP-Tools verwenden:
db_select("SELECT * FROM tasks LIMIT 10", database="ki_dev")
db_tables(database="ki_dev")
db_describe(table="tasks", database="ki_dev")

Datenbank erstellen (nur Admin)

mariadb -e "CREATE DATABASE dbname CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci;"
mariadb -e "CREATE USER 'user'@'localhost' IDENTIFIED BY 'password';"
mariadb -e "GRANT ALL PRIVILEGES ON dbname.* TO 'user'@'localhost';"
mariadb -e "FLUSH PRIVILEGES;"

Befehle

mariadb -V
systemctl status mariadb
mariadb-dump --all-databases > backup.sql

Verwandte Themen

• MCP-DB - Datenbankzugriff via MCP
• KI-Datenbank - Schema-Details
• Backup - Datenbank-Sicherung

phpMyAdmin

Erstellt: 2025-12-20 | Aktualisiert: 2025-12-20

Web-basierte Datenbankverwaltung für MariaDB/MySQL. Ermöglicht Datenbankoperationen, Tabellenmanagement und SQL-Abfragen im Browser.

Zugang

Funktionen

• Datenbanken erstellen, bearbeiten, löschen
• Tabellen und Strukturen verwalten
• SQL-Abfragen ausführen
• Daten importieren/exportieren
• Benutzer und Berechtigungen verwalten

Sicherheit

• Zugriff nur unter /myadm (nicht /phpmyadmin)
• Standard-Pfad /phpmyadmin deaktiviert
• Nur auf dev-Domain aktiv

Konfiguration

/etc/apache2/conf-available/phpmyadmin-myadm.conf
/etc/phpmyadmin/config.inc.php
/etc/phpmyadmin/config-db.php

Nextcloud

Erstellt: 2025-12-20 | Aktualisiert: 2025-12-20

Self-hosted Cloud-Speicher für Dateien und Dokumente. Ersetzt Dropbox/Google Drive mit voller Datenkontrolle und DSGVO-Konformität.

Installation

cd /var/www
curl -LO https://download.nextcloud.com/server/releases/latest.tar.bz2
tar -xjf latest.tar.bz2
chown -R www-data:www-data nextcloud

Datenbank

mariadb -e "CREATE DATABASE nextcloud CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci;"
mariadb -e "CREATE USER 'nextcloud'@'localhost' IDENTIFIED BY 'PASSWORD';"
mariadb -e "GRANT ALL PRIVILEGES ON nextcloud.* TO 'nextcloud'@'localhost';"

Python

Erstellt: 2025-12-20 | Aktualisiert: 2025-12-20

Skriptsprache für KI/ML-Aufgaben und Automatisierung. Basis für viele KI-Tools, Bibliotheken und Embedding-Generierung.

Zusätzliche Pakete

apt-get install -y python3-pip python3-venv python3-dev build-essential

Virtuelle Umgebung

python3 -m venv /opt/myproject/venv
source /opt/myproject/venv/bin/activate
pip install --upgrade pip

Version prüfen

python3 --version
pip3 --version

tmux

Erstellt: 2025-12-20 | Aktualisiert: 2025-12-20

Terminal-Multiplexer für persistente Shell-Sessions. Prozesse laufen weiter auch wenn die SSH-Verbindung abbricht. Ermöglicht mehrere Terminals in einer Verbindung.

Tastenkürzel

Befehle

tmux new -s session
tmux attach -t session
tmux ls
tmux kill-session -t session

Kitty-Verbindung

ssh -p 2022 root@SERVER -t "tmux new -A -s main"

Semantic Explorer

Erstellt: 2025-12-20 | Aktualisiert: 2025-12-29

Exploration und Suche in der Dokumentations-Pipeline. Zeigt hierarchische Dokumente, deren Seiten und die extrahierten Text-Chunks mit Taxonomie-Klassifizierung, Keywords und Entities.

Datenmodell

Web-UI Komponenten

Detail-Ansichten

• /semantic-explorer/entitaeten/{id} - Entity-Details mit Vorkommen
• /semantic-explorer/chunks/{id} - Chunk-Details: Entities, Keywords, Semantik

API-Endpoints

Chunk-Analyse

Die Pipeline extrahiert aus jedem Chunk:

• entities: Erkannte Entitäten mit Typ (PERSON, ORGANIZATION, CONCEPT, etc.)
• keywords: Relevante Schlüsselwörter
• token_count: Anzahl Tokens für LLM-Budgetierung
• embedding_model: Verwendetes Embedding-Modell
• qdrant_id: ID im Vektor-Index

HybridSearch

Die Suche kombiniert semantische Vektorsuche (Qdrant) mit Keyword-Matching (MariaDB).

API-Aufruf

# Einfache Suche
curl -X POST https://dev.campus.systemische-tools.de/api/v1/explorer/search \
  -H "Content-Type: application/json" \
  -d '{"query": "Systemische Therapie", "limit": 10}'

Response-Format

{
  "success": true,
  "data": {
    "query": "Systemische Therapie",
    "results": [
      {
        "id": 42,
        "content": "...",
        "document_title": "Handbuch",
        "score": 0.87
      }
    ],
    "count": 5
  }
}

Statistiken abrufen

curl https://dev.campus.systemische-tools.de/api/v1/explorer/stats

Response

{
  "success": true,
  "data": {
    "documents": 12,
    "chunks": {
      "total": 234,
      "tokens": 125000
    },
    "entities": 450,
    "relations": 320
  }
}

Pipeline-Integration

Die Chunks werden von der Analyse-Pipeline generiert:

1. /var/www/scripts/pipeline/pipeline.py - Haupt-Pipeline
2. /var/www/scripts/pipeline/step_chunk.py - Chunk-Erstellung
3. /var/www/scripts/pipeline/step_embed.py - Embedding-Generierung
4. /var/www/scripts/pipeline/step_semantic.py - Semantik-Analyse

Siehe: RAG-Prozess

Contracts Web-UI

Erstellt: 2025-12-20 | Aktualisiert: 2025-12-29

Web-Oberfläche zur Verwaltung von Contracts - YAML-basierte Qualitätsverträge für Code und Dokumentation.

Funktionen

• Liste: Alle Contracts mit Status-Filter (draft, active, deprecated)
• Erstellen: Neue Contracts mit YAML-Editor
• Bearbeiten: Contract-YAML ändern (erstellt neue Version)
• Validieren: Contract gegen Scope ausführen
• Historie: Änderungshistorie mit Versionierung

Routes

Views

Contract-Struktur (YAML)

name: example-contract
version: "1.0"
scope:
  paths:
    - /src/View/example/
  patterns:
    - "*.php"
rules:
  - type: structure
    check: required_elements
    elements: [h1, table]
  - type: content  
    check: no_hardcoded_paths
thresholds:
  critical: 0
  major: 2
  minor: 5

Versionierung

Jede Änderung an einem Contract erstellt automatisch eine neue Version. Die Historie wird in ki_dev.contract_history gespeichert.

Integration

• MCP-Contracts: API-Zugriff via MCP-Tools (contracts_list, contracts_validate, etc.)
• Pre-Sync Hook: Validierung vor Deployment zu prod
• Claude Code: Automatische Prüfung bei Code-Änderungen

Siehe auch

• MCP-Contracts - MCP-Server für Contract-API
• Contracts (Konzept) - Contract-System Konzept und alle aktiven Contracts
• PHP-Quality - PHPStan, PHP-CS-Fixer Integration

Erstellt: 2025-12-22 | Aktualisiert: 2025-12-22

Content Pipeline

System zur Verarbeitung von Dokumenten aus Nextcloud mit konfigurierbaren Pipeline-Stufen.

Übersicht

Die Content Pipeline verarbeitet Dokumente in mehreren Schritten:

1. Import - Dokumente aus Nextcloud scannen und in Queue aufnehmen
2. Extract - Text aus PDF, DOCX, PPTX, MD, TXT extrahieren
3. Chunk - Semantisches Chunking mit Struktur-Erhaltung
4. Embed - Vektorisierung via Ollama → Qdrant
5. Analyze - Entitäten, Relationen, Taxonomie extrahieren

Sub-Seiten

• /content-pipeline/import - Import-Konfiguration

Technische Basis