docs(deploy): Update Dokumetation Workflow

docs/docker/architecture.md

@@ -0,0 +1,33 @@
+# 🏗 Bruchtal Docker-Architektur
+
+## Übersicht
+
+Die Bruchtal-Infrastruktur läuft vollständig containerisiert auf einer VM.  
+Alle Dienste kommunizieren über ein dediziertes Docker-Netzwerk, nutzen Git zur Versionierung und automatisches Deploy über Webhooks.  
+
+**Hauptkomponenten:**
+
+| Service        | Containername        | Funktion |
+|----------------|-------------------|---------|
+| Gitea          | `gitea`           | Git-Server für Infrastruktur & Dokumentation |
+| Wiki.js        | `wikijs`          | Wissensmanagement & Dokumentation |
+| MkDocs         | `bruchtal-docs`   | Statische Markdown-Dokumentation |
+| Webhook        | `bruchtal-webhook`| Automatisches Deploy bei Git Push |
+| Docker Host    | VM                | Plattform für alle Container |
+
+---
+
+## 🔗 Netzwerke
+
+Alle Container laufen im **gemeinsamen Docker-Netzwerk** `bruchtal-net`:
+
+- Kommunikation per Service-Namen (`gitea`, `bruchtal-webhook`)  
+- Keine Abhängigkeit von Host-IP  
+- Isoliert von anderen VM-Netzwerken  
+
+Beispiel Docker-Compose-Netzwerkdefinition:
+
+```yaml
+networks:
+  bruchtal-net:
+    external: true

docs/workflows/docker-workflow.md

@@ -7,7 +7,6 @@ Ziel:
 - Alles versioniert in Git
 - Reproduzierbare Deployments
 - Dokumentation immer synchron zur Infrastruktur
-
 ---
 
 ## Grundprinzip
@@ -18,9 +17,17 @@ Die VM ist nur noch Laufzeitumgebung.
 
 1. Lokal ändern, egal was
 2. Committen & Pushen
-3. Auf VM pullen
+3. der Pull auf der VM wird automatisch über einen Webhook ausgeführt
 4. Container neu starten
 
+```mermaid
+flowchart LR
+    Dev -->|git push| Gitea
+    Gitea -->|POST Hook| Webhook
+    Webhook -->|git pull| Workspace
+    Workspace -->|Markdown changes| MkDocs
+    MkDocs -->|serve| Browser
+
 ---
 
 ## Workflow "neuer Container"