From 7fae0c4cbc4aa38c03a90e0bd0dd12fd4b94e138 Mon Sep 17 00:00:00 2001
From: Sam Rolfe <samuelrolfe@gmail.com>
Date: Sun, 6 Sep 2026 18:38:43 +1000
Subject: [PATCH] README: add Architecture Mermaid diagram + link to
 interactive maps.lab

---
 README.md | 21 +++++++++++++++++++++
 1 file changed, 21 insertions(+)

diff --git a/README.md b/README.md
index 079e52c..464fc31 100644
--- a/README.md
+++ b/README.md
@@ -4,6 +4,27 @@ A self-hosted "home dash" and family toolkit that runs on our own network — a
 single place to reach every app we run, plus a private AI chat, media tools,
 storage and an audio transcriber.
 
+## Architecture
+
+**Interactive map:** [maps.lab → Family Home Lab](https://maps.lab.audasmedia.com.au/family_home_lab/docs/)
+
+```mermaid
+flowchart LR
+    U[Family browsers / phones] -->|https *.lab| C[Caddy :35]
+    C -->|console.lab| P[Console portal FastAPI :13:8500]
+    C -->|dsh-*.lab| D[dsh chat x4 SSE]
+    C -->|media/apps.lab| A[Media + ~40 apps]
+    P -->|SQL| DB[(Postgres+Redis)]
+    P -->|transcribe| W[Celery workers + RabbitMQ]
+    D -->|LLM| OR[OmniRoute :20129]
+    OR -->|chat/reasoning/coding| OC[opencode-go / deepseek]
+    D -->|vision/video| OL[OpenRouter GPT-5 · GLM-5v]
+    P -->|Files/S3| G[(Garage S3 + shared-media)]
+    G -.->|Borg| BACK[(Amazon S3 offsite)]
+    U -->|Voice page| V[Jervis voice agent :8501]
+    V -->|HA REST/MQTT| HA[Home Assistant]
+```
+
 ## What it is
 
 - **Console portal** — the front door at `https://console.lab.audasmedia.com.au`.