diff --git a/300 areas/360 Dev-Ops Network Computers/FAMILY CONSOLE.md b/300 areas/360 Dev-Ops Network Computers/FAMILY CONSOLE.md
index 61b7faf..444e6c6 100644
--- a/300 areas/360 Dev-Ops Network Computers/FAMILY CONSOLE.md	
+++ b/300 areas/360 Dev-Ops Network Computers/FAMILY CONSOLE.md	
@@ -47,6 +47,31 @@ A per-user DeepSeek chat harness (`dsh-sam·jo·harry·finn.lab`), **custom Fast
 - **Kids:** jo/harry/finn get a reduced view (no AI/chat, no admin-only tools) and no shell in dsh.
 - **Storage:** Garage S3 buckets `sam, jo-media, harry, finn, shared-media` (S3 needs ≥3-char names). Per-user files land in `shared-media/<user>/`.
 
+## Architecture (Mermaid)
+
+```mermaid
+flowchart LR
+    U[Family browsers / phones] -->|https *.lab.audasmedia.com.au| C[<b>Caddy</b> :35 reverse proxy]
+    C -->|console.lab| P[<b>Console portal</b> FastAPI+HTMX :8500]
+    C -->|dsh-*.lab| D[<b>dsh chat</b> per-user x4 SSE]
+    C -->|gimp/video/audio.lab| M[<b>WeWebtop media tools</b> GIMP/KdenLive/Audacity/LMMS]
+    C -->|metube/outline/jellyfin/nextcloud +| APPS[~40 self-hosted apps]
+    P -->|logins/admin| PG[(Postgres+Redis)]
+    P -->|transcribe| W[<b>Celery workers</b> RabbitMQ]
+    D -->|LLM| OR[<b>OmniRoute</b> :20129 gateway]
+    OR -->|chat/reasoning/coding| OC[opencode-go · deepseek flash/pro]
+    D -->|vision/video| OL[OpenRouter → GPT-5 · GLM-5v]
+    W -->|MIDI/sheet| BP[Basic Pitch · MuScriptor]
+    U -->|Voice page| V[<b>Jervis</b> voice agent :8501]
+    V -->|HA REST/MQTT| HA[Home Assistant :30]
+    P -->|Files / S3| G[(Garage S3 + shared-media .13)]
+    G -.->|Borg backup| BACK[(Amazon S3 offsite)]
+```
+
+## Diagrams
+- **Archify map** (interactive HTML): repo → `docs/family-home-lab-map.html` (+ source JSON `docs/archify/family-home-lab.architecture.json`)
+- **Mermaid**: see "Architecture (Mermaid)" above.
+
 ## Project management
 - **Tasks:** [[Vikunja]] → project "Family Home Lab" — https://vikunja.lab.audasmedia.com.au/projects/8
 - **Docs (AI bots):** Outline → collection "Family Home Lab" — https://outline.lab.audasmedia.com.au/collection/family-home-lab-XgbVukpg1g