Document full architecture, design, API, features, deployment, and security.

Adds diagrams and expands the ATC demo path so the cockpit is fully described in-repo.

DEMO.md

@@ -1,11 +1,27 @@
-# OME Cockpit — demo path
+# OME Cockpit — ATC demo path
 
-URL: http://atc-portal01.dell-atc.lan:3090
+**URL:** http://atc-portal01.dell-atc.lan:3090  
+**AI companion:** http://atc-portal01.dell-atc.lan:3080 (OpenManage AI)
 
-1. Watch live pulse lines from OME hub to connected iDRACs/servers
-2. Filter a subnet (10.0.40 / 10.0.41) in the left rail
-3. Click a glowing node → inspector (IP, model, service tag, power)
-4. Click **OpenManage AI** → chat drawer with OME Copilot
-5. Use **Connected only** to focus the live fabric
+## 5-minute walkthrough
 
-OpenManage AI standalone remains at :3080
+1. **Topology** — Watch pulse lines from OME hub to connected nodes; try Orbit → Galaxy → Clusters.
+2. **KPI popup** — Click **Offline** or **Live power**; search a host; use **Focus on map** / **SSH terminal**.
+3. **Filters** — Enable **Connected only**; confirm empty-map behavior if Servers+iDRACs both off; **Reset filters**.
+4. **Inspector** — Select a connected node → **Load full inventory + app landscape** (firmware/software).
+5. **SSH** — Quick Connect → SSH terminal → log in with **your** username (not root).
+6. **Chat** — Cockpit chat → pick `llama3-70b-gptq` or `OME Copilot` → “List critical alerts with IP”.
+7. **Ops desk** — Create a ticket as Jody, accept as Laurens.
+8. **New node story** — When OME gains a device after cockpit baseline, a toast/card appears.
+
+## Talking points
+
+- Single pane for OME fleet + GPU + LLM + remote shell
+- Context stays live via WebSocket snapshots (~12–15s OME poll, ~2s GPU)
+- Design is Dell-branded mission control, not a spreadsheet
+
+## Related docs
+
+- [ARCHITECTURE.md](docs/ARCHITECTURE.md)
+- [DESIGN.md](docs/DESIGN.md)
+- [FEATURES.md](docs/FEATURES.md)