docs: add doctor service, fix FHIR Spec MCP port, add DNS troubleshooting

- index.md: add Doctor service to Betrieb section
- installation.md: replace manual curl checks with docker compose run --rm doctor
- mcp-bridge.md: fix FHIR Spec MCP URL (was :3001, correct :8080)
- troubleshooting.md: add Snowstorm DNS resolution issue, replace
  bash health check script with doctor service documentation

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Author: ThomasDeBe

input/pagecontent/index.md

@@ -44,6 +44,12 @@ Details: [Terminology MCP Server](terminologie-mcp.html) · [Terminologie-Tools]
 | Zotero Comfort | 3001 | Literaturverwaltung MCP (Gruppen- + persönliche Bibliothek) |
 | FHIR Spec MCP | 8002 | FHIR R4 Spezifikationsnavigator |
 
+#### Betrieb
+
+| Service | Aufruf | Funktion |
+|---------|--------|----------|
+| Doctor | `docker compose run --rm doctor` | Funktionaler Health Check aller Services (DNS, SNOMED Routing, LOINC Tools) |
+
 ### Schnellstart
 
 ```bash

input/pagecontent/installation.md

@@ -111,38 +111,31 @@ Beim ersten Start passiert automatisch:
 
 ### Schritt 8: Verifizierung
 
-Prüfe den Status aller Services:
+Prüfe den Status aller Container:
 
 ```bash
 docker compose ps
 ```
 
-Health-Checks für einzelne Services:
+Führe den integrierten Doctor-Service aus, um alle Services, DNS-Auflösung und funktionale Routen zu prüfen:
 
 ```bash
-# Elasticsearch
-curl -s http://localhost:9200/_cluster/health | jq .status
+docker compose run --rm doctor
+```
 
-# Snowstorm
-curl -s http://localhost:8090/fhir/metadata | jq .software
+Der Doctor prüft DNS-Auflösung, Snowstorm FHIR-Endpunkte, SNOMED-Routing durch den Terminology Proxy, LOINC deutsche Labels und Panel-Index sowie alle Health-Endpunkte. Bei Problemen zeigt er genau an, welcher Check fehlschlägt.
 
-# Terminology MCP (HTTP Proxy)
-curl -s http://localhost:3000/health
+Alternativ für einzelne Services:
 
-# Terminology MCP (MCP SSE)
-curl -s http://localhost:3002/health
+```bash
+# Snowstorm
+curl -s http://localhost:8090/fhir/metadata | jq .software
 
-# AskMII
-curl -s http://localhost:2026/health
+# Terminology MCP
+curl -s http://localhost:3002/health | jq .
 
 # MCP Bridge
-curl -s http://localhost:8000/health
-
-# Ollama
-curl -s http://localhost:11434
-
-# Open WebUI
-curl -s http://localhost:3080
+curl -s http://localhost:8000/health | jq .
 ```
 
 ### Elasticsearch-Speicher anpassen

input/pagecontent/mcp-bridge.md

@@ -26,7 +26,7 @@ Beim Start fragt die Bridge alle konfigurierten MCP-Server nach ihren Tools ab:
 |-----------|-----|-------|
 | Terminology MCP | `http://terminology-mcp:3000` | 8 Terminologie-Tools |
 | AskMII | `http://ask-mii:2026` | FDPG Query Tools |
-| FHIR Spec MCP | `http://fhir-spec:3001` | FHIR-Navigations-Tools |
+| FHIR Spec MCP | `http://fhir-spec-mcp:8080` | FHIR-Navigations-Tools |
 
 Die entdeckten Tools werden in das OpenAI Function Format konvertiert und bei jedem Chat-Request an Ollama mitgegeben.
 

input/pagecontent/troubleshooting.md

@@ -48,6 +48,27 @@ docker volume rm ceir-os_sct_files
 docker compose up -d
 ```
 
+### Snowstorm DNS-Auflösung fehlgeschlagen
+
+**Symptom:** Der Terminology MCP Server kann Snowstorm nicht erreichen. `lookup_code` für SNOMED CT schlägt fehl, obwohl Snowstorm läuft.
+
+**Ursache:** Wenn Snowstorm einzeln neu gestartet wird (z.B. `docker restart ceir-snowstorm`), verliert der Container seinen DNS-Alias im Docker-Netzwerk. Andere Container können `snowstorm` dann nicht mehr auflösen.
+
+**Diagnose:**
+
+```bash
+# Doctor-Service ausführen — prüft DNS und alle Routen
+docker compose run --rm doctor
+```
+
+**Lösung:** Snowstorm und abhängige Services über Docker Compose neu erstellen:
+
+```bash
+docker compose up -d --force-recreate snowstorm terminology-mcp
+```
+
+> **Wichtig:** `docker restart` reicht nicht — es muss `--force-recreate` sein, damit Docker die DNS-Einträge im Netzwerk neu registriert.
+
 ### SNOMED-Import dauert sehr lange
 
 Der initiale Import kann je nach Paketgröße 10-30 Minuten dauern. Fortschritt prüfen:
@@ -184,40 +205,37 @@ BRIDGE_PORT=8001
 
 ### Health Checks für alle Services
 
-Nutze folgendes Skript, um den Status aller Services zu prüfen:
+CEIR-OS enthält einen integrierten **Doctor-Service**, der alle Services, DNS-Auflösung und funktionale Routen prüft:
 
 ```bash
-echo "=== CEIR-OS Health Check ==="
-
-echo -n "Elasticsearch:    "
-curl -sf http://localhost:9200/_cluster/health | jq -r .status 2>/dev/null || echo "NICHT ERREICHBAR"
-
-echo -n "Snowstorm:        "
-curl -sf http://localhost:8090/fhir/metadata | jq -r .software.version 2>/dev/null || echo "NICHT ERREICHBAR"
-
-echo -n "Terminology HTTP: "
-curl -sf http://localhost:3000/health | jq -r .status 2>/dev/null || echo "NICHT ERREICHBAR"
+docker compose run --rm doctor
+```
 
-echo -n "Terminology MCP:  "
-curl -sf http://localhost:3002/health | jq -r .status 2>/dev/null || echo "NICHT ERREICHBAR"
+Der Doctor führt 20 Checks aus:
 
-echo -n "AskMII:           "
-curl -sf http://localhost:2026/health | jq -r .status 2>/dev/null || echo "NICHT ERREICHBAR"
+| Kategorie | Was wird geprüft |
+|-----------|-----------------|
+| DNS-Auflösung | Alle 5 Service-Hostnamen im Docker-Netzwerk |
+| Elasticsearch | Cluster Health |
+| Snowstorm (direkt) | FHIR Metadata, CodeSystems, Concept Lookup, FHIR CodeSystem Lookup |
+| SNOMED Routing | Terminology Proxy → Snowstorm (POST /lookup mit echten SNOMED-Codes) |
+| LOINC Local Tools | Deutsche Labels (Körpertemperatur, Kreatinin), Panel-Index |
+| Service Health | Proxy HTTP, MCP SSE, Snowstorm-Verbindung, LOINC-Panels geladen |
+| MCP Bridge | Health Check |
 
-echo -n "MCP Bridge:       "
-curl -sf http://localhost:8000/health | jq -r .status 2>/dev/null || echo "NICHT ERREICHBAR"
+Alternativ gibt es das Host-seitige Script `./doctor.sh`, das zusätzlich Container-Status und Cross-Service-Konnektivität von außen prüft.
 
-echo -n "Ollama:           "
-curl -sf http://localhost:11434 >/dev/null 2>&1 && echo "OK" || echo "NICHT ERREICHBAR"
+Für einzelne Services:
 
-echo -n "OpenWebUI:        "
-curl -sf http://localhost:3080 >/dev/null 2>&1 && echo "OK" || echo "NICHT ERREICHBAR"
+```bash
+# Snowstorm
+curl -s http://localhost:8090/fhir/metadata | jq .software
 
-echo -n "FHIR Spec MCP:    "
-curl -sf http://localhost:8002/health | jq -r .status 2>/dev/null || echo "NICHT ERREICHBAR"
+# Terminology MCP
+curl -s http://localhost:3002/health | jq .
 
-echo -n "Zotero Comfort:   "
-curl -sf http://localhost:3001/health | jq -r .status 2>/dev/null || echo "NICHT ERREICHBAR"
+# MCP Bridge
+curl -s http://localhost:8000/health | jq .
 ```
 
 ### Vollständiger Neustart