Architektur¶

Drei Maschinen¶

graph TB
    AlterPC[Alter PC<br/>Persoenlicher Arbeitsplatz<br/>Claude-Code-Desktop-App] -->|Remote Desktop| AgentPC[Agent-PC<br/>Claude-Werkbank<br/>CLI + Tools + Bots]
    AgentPC -->|SSH + git push| Heimserver[Heimserver 192.168.2.2<br/>Production + LLM<br/>Wiki-Web-UI]
    AgentPC -->|git push| GitHub[GitHub<br/>claude-werkbank<br/>private Repo]
    Heimserver -->|cron pull| GitHub
    AlterPC -.->|Browser| Heimserver

Maschine	Rolle	Claude-Tooling
Alter PC (nach Reset)	Persoenlicher Arbeitsplatz, Remote-Desktop-Client zum Agent-PC	Nur Claude-Code-Desktop-App, `~/.claude/` auf identischem Stand
Agent-PC	Claude-Werkbank: alle Tools, Bots, Auto-Start, Sessions	CLI + Desktop-App, vollstaendiges `~/.claude/`
Heimserver	Production + lokales LLM	Hostet das Wiki-Web-UI

Heimserver-Services¶

Stand: 2026-04-29 (aus inventory/raw/heimserver.json, 48 Container). Detail-Eintraege je Service unter docs/tools/.

Service	Port(s)	Image
schneider-dashboard	0.0.0.0:8011->8011/tcp, [::]:8011->8011/tcp	docker-schneider-dashboard
ark-server	-	acekorneya/asa_server:latest
prueftool-handwerk	0.0.0.0:3200->3000/tcp, [::]:3200->3000/tcp	prueftool-web
handwerk-backend-1	0.0.0.0:8091->8000/tcp, [::]:8091->8000/tcp	handwerk-backend
handwerk-frontend-1	0.0.0.0:3100->3000/tcp, [::]:3100->3000/tcp	handwerk-frontend
prueftool-pv	0.0.0.0:3500->3000/tcp, [::]:3500->3000/tcp	prueftool-pv:latest
prueftool-willkommen	0.0.0.0:3600->3000/tcp, [::]:3600->3000/tcp	prueftool-willkommen:latest
prueftool-seller	0.0.0.0:3800->3000/tcp, [::]:3800->3000/tcp	prueftool-seller-prueftool-seller
prufdas-patent	0.0.0.0:3350->3350/tcp, [::]:3350->3350/tcp	docker-prufdas-patent
seller-db	5432/tcp	postgres:16-alpine
pv-db	0.0.0.0:5443->5432/tcp, [::]:5443->5432/tcp	postgres:16-alpine
willkommen-db	5432/tcp	postgres:16-alpine
gsm-web	0.0.0.0:8212->8212/tcp, [::]:8212->8212/tcp	ark-server-gsm-web
dovecot	0.0.0.0:143->143/tcp, [::]:143->143/tcp, 8080/tcp, 9090/tcp, 31024/tcp, 31110/tcp, 31143/tcp, 31587/tcp, 31993/tcp, 31995/tcp, 0.0.0.0:993->993/tcp, [::]:993->993/tcp, 34190/tcp	dovecot-custom:2.4.2
paperless-ngx	0.0.0.0:8010->8000/tcp, [::]:8010->8000/tcp	ghcr.io/paperless-ngx/paperless-ngx:latest
paperless-db	5432/tcp	postgres:15
paperless-tika	9998/tcp	apache/tika:latest
buchhaltung-db	127.0.0.1:5442->5432/tcp	postgres:16-alpine
fetchmail	-	python:3-alpine
roundcube	0.0.0.0:8025->80/tcp, [::]:8025->80/tcp	roundcube/roundcubemail:latest
guacamole	0.0.0.0:8443->8080/tcp, [::]:8443->8080/tcp	guacamole/guacamole:latest
prueftool-miete	0.0.0.0:3300->3000/tcp, [::]:3300->3000/tcp	docker-prueftool-miete
miete-redis	6379/tcp	redis:7-alpine
commandcenter	0.0.0.0:8800->8800/tcp, [::]:8800->8800/tcp	commandcenter-commandcenter
n8n	0.0.0.0:5678->5678/tcp, [::]:5678->5678/tcp	n8nio/n8n:1
handwerk-db-1	127.0.0.1:5433->5432/tcp	pgvector/pgvector:pg16
ollama	0.0.0.0:11434->11434/tcp, [::]:11434->11434/tcp	0ff452f6a4c3
miete-db	5432/tcp	20edbde7749f
grafana	0.0.0.0:3000->3000/tcp, [::]:3000->3000/tcp	e932bd6ed0e0
buchhaltung-backend	0.0.0.0:8400->8000/tcp, [::]:8400->8000/tcp	buchhaltung-buchhaltung-backend
paperless-redis	6379/tcp	redis:7-alpine
whisper	0.0.0.0:9001->9000/tcp, [::]:9001->9000/tcp	onerahmet/openai-whisper-asr-webservice:latest
buchhaltung-frontend	0.0.0.0:3400->3000/tcp, [::]:3400->3000/tcp	buchhaltung-buchhaltung-frontend
buchhaltung-redis	6379/tcp	redis:7-alpine
nginx-proxy-manager	0.0.0.0:80-81->80-81/tcp, [::]:80-81->80-81/tcp, 0.0.0.0:443->443/tcp, [::]:443->443/tcp	jc21/nginx-proxy-manager:latest
n8n-redis	6379/tcp	redis:7-alpine
penpot-frontend	0.0.0.0:9002->8080/tcp, [::]:9002->8080/tcp	caefaf8ef815
penpot-backend	-	dbf308a07b19
penpot-exporter	-	b0324003d10d
homeassistant	-	4fb4ad85fad2
prometheus	0.0.0.0:9090->9090/tcp, [::]:9090->9090/tcp	4a61322ac110
cadvisor	0.0.0.0:8086->8080/tcp, [::]:8086->8080/tcp	gcr.io/cadvisor/cadvisor:latest
penpot-valkey	6379/tcp	17b48e45a38d
node-exporter	0.0.0.0:9100->9100/tcp, [::]:9100->9100/tcp	3ac34ce007ac
guacd	4822/tcp	guacamole/guacd:latest
penpot-postgres	5432/tcp	f30e3de0ac9c
n8n-db	5432/tcp	20edbde7749f
portainer	0.0.0.0:9000->9000/tcp, [::]:9000->9000/tcp, 8000/tcp, 0.0.0.0:9443->9443/tcp, [::]:9443->9443/tcp	3267f1869e0f

Wiki-Datenfluss¶

sequenceDiagram
    participant Claude
    participant Repo as C:\Tools\WIKI (Agent-PC)
    participant GitHub
    participant Heimserver as werkbank-wiki Container
    participant Browser

    Claude->>Repo: Edit *.md / claude/*
    Repo->>GitHub: git push (manuell oder Hook)
    Heimserver->>GitHub: cron git pull (alle 15 min)
    Heimserver->>Heimserver: mkdocs build
    Browser->>Heimserver: GET https://werkbank.heimserver.local
    Heimserver->>Browser: HTML