From 22a3c3145fbfeb5abcd8bada13f7e6dc32486b31 Mon Sep 17 00:00:00 2001
From: admin <christian@shoshin-aikido.de>
Date: Tue, 10 Mar 2026 23:00:38 +0100
Subject: [PATCH] docs(workflows):

---
 docs/workflows/docker-workflow.md | 55 +++++++++++++++++++++++++++----
 mkdocs.yml                        |  2 +-
 2 files changed, 50 insertions(+), 7 deletions(-)

diff --git a/docs/workflows/docker-workflow.md b/docs/workflows/docker-workflow.md
index b8f32f5..0e403d3 100644
--- a/docs/workflows/docker-workflow.md
+++ b/docs/workflows/docker-workflow.md
@@ -14,7 +14,6 @@ Ziel:
 **Konfiguration passiert lokal in VS Code.**
 Die VM ist nur noch Laufzeitumgebung.
 
-
 1. Lokal ändern, egal was
 2. Committen & Pushen
 3. der Pull auf der VM wird automatisch über einen Webhook ausgeführt
@@ -28,22 +27,66 @@ flowchart LR
     Workspace -->|Markdown changes| MkDocs
     MkDocs -->|serve| Browser
 ```
-
 ---
 
+## Verzeichnisstruktur
+```
+/srv/docker
+├─ compose/                  # Docker-Compose Stacks für jeden Container
+│  ├─ nextcloud/
+│  │   └─ docker-compose.yml
+│  ├─ tvheadend/
+│  │   └─ docker-compose.yml
+│  ├─ signal-rest-api/
+│  │   └─ docker-compose.yml
+│  └─ ... (weitere aktive Container)
+│
+├─ scripts/                  # Deploy-Scripts, Webhooks, Utilities
+│  ├─ deploy-changed-containers-final.sh
+│  ├─ webhook-deploy.sh
+│  └─ ... (weitere Scripts)
+│
+├─ docs/                     # MkDocs / Markdown Dokumentation
+│  ├─ backup_restore
+│  |  ├─ docker
+|  |     └─ docker_backup.md
+|  |  ├─ hetzner
+│  ├─ docker
+│  |   ├─ adguardhome
+|  |   |  └─ adguardhome.md
+│  |   ├─ heimdall
+|  |       └─ heimdall.md
+|  |   └─ ... (weitere .md Dateien)
+│
+├─ mkdocs.yml                # MkDocs Konfiguration
+│
+├─ daten/                    # Docker-Volumes / persistent data
+│  ├─ nextcloud/
+│  │   ├─ www/               # Nextcloud Webdaten
+│  │   ├─ db/                # MariaDB Daten
+│  │   └─ redis/             # Redis Daten
+│  ├─ tvheadend/
+│  │   └─ config/            # TVHeadend config / recordings
+│  ├─ signal-rest-api/
+│  │   └─ data/
+│  └─ ... (weitere Container-Daten)
+│
+└─ .gitignore                # ignoriert daten/ und ggf. temp files
+```
+
+
 ## Workflow "neuer Container"
 - VSCode starten in ~Bruchtal mit code . => VS startet sauber mit der Giteinstellung
 **ALLE ÄNDERUNGEN NUR IN VS**
 
-### neuen Containeranlegen
-- `Bruchtal/<Containername>` anlegen
-- `Bruchtal/<Containername>/docker-compose.yml` anlegen
+- `compose/<Containername>` anlegen
+- `compose/<Containername>/docker-compose.yml` anlegen
 - docker-compose.yml editieren, 
 - commit mit Message `"infra(<Containername>): docker-compose.yml neu angelegt"`
 - push
 
 ### neuen Container dokumentieren
-- `Bruchtal/docs/<Containername>` anlegen
+- `docker/docs/<Containername>` anlegen
 - `Bruchtal/docs/<Containername>/<Containername>.md` anlegen
 - `<Containername>.md` editieren, Blaupause z.B: wikijs.md
 - commit message `docs(<Containername>): Dokumentation angelegt`
diff --git a/mkdocs.yml b/mkdocs.yml
index 8611e4d..27bc2df 100644
--- a/mkdocs.yml
+++ b/mkdocs.yml
@@ -11,7 +11,7 @@ nav:
   - Workflows:
       - Docker-workflow: workflows/docker-workflow.md
       - Adguardhome-Kea-Caddy: workflows/adguard-kea-caddy.md
-   
+         
   - Netzwerk:
       - Topologie: network/topology.md
       - Tunnel: network/tunnel.md