Update Navi

Author: webosa

docs/index.md

@@ -14,3 +14,23 @@ Welcome to the EvisHomeLab documentation.
     * **Tools:** Home Assistant OS, Antigravity IDE, Git, MkDocs Material
 
     [📖 **Read the full System Setup & Maintenance Manual**](system_manual/setup_guide.md)
+
+## High Level Architecture
+
+The system integrates various smart home technologies into a cohesive platform.
+
+### Core System
+- **Hub:** Home Assistant OS
+- **Zigbee:** 2x Zigbee2MQTT networks (Main & Secondary)
+- **Voice:** Home Assistant Assist (Wake Words & Pipelines)
+- **Logic:** HACS Pyscript + Node-RED
+
+### Key Integrations
+| Domain | Technologies / Brands |
+| :--- | :--- |
+| **Climate & Air** | Philips Air Purifier, Airthings Wave (BLE), Aqara W500 |
+| **Appliances** | LG Dishwasher (ThinQ), Shelly 3EM (Energy) |
+| **Automotive** | Mercedes GLC (Mercedes Me), Garmin, Car Sensors |
+| **Multimedia** | DNA TV Hub, Office PC (IoT Link) |
+| **Logic & Data** | Nordpool Energy Prices, Home Time Modes, Scenes |
+| **System** | Smart Notifications (Router), Room Automation (MQTT Dynamic), Fingerprint Mgmt |

docs/smart-home/structure.md

@@ -15,13 +15,15 @@ An overview of the key directories and files in the Home Assistant root folder.
 | **`docs_site/`** | This documentation repository and MkDocs site structure. |
 | **`esphome/`** | ESPHome configuration YAML files and compilation artifacts (binaries). |
 | **`include/`** | Split configuration files referenced from `configuration.yaml` to keep it clean. |
+| **`model_cache/`** | Cache for local AI models (Wake words, assist pipelines). |
 | **`node-red/`** | Storage for Node-RED flows and settings (if the add-on is used). |
 | **`packages/`** | Configuration split into logical "packages" (bundling automations, scripts, configuration by feature). |
 | **`pyscript/`** | Python scripts and apps for the `pyscript` integration. |
 | **`themes/`** | Frontend themes definition files. |
 | **`tts/`** | Text-to-speech cache or configuration. |
 | **`www/`** | Publicly accessible folder mapped to `/local/` for hosting custom cards, images, and resources. |
 | **`zigbee2mqtt/`** | Zigbee2MQTT data directory containing configuration and database. |
+| **`zigbee2mqtt-2/`** | Secondary Zigbee2MQTT instance data directory. |
 | **`automations.yaml`** | The main file for storing automations, commonly managed via the UI. |
 | **`configuration.yaml`** | The main configuration file for Home Assistant. |
 | **`scenes.yaml`** | Configuration file for defining scenes. |

docs/system_manual/setup_guide.md

@@ -88,21 +88,23 @@ Run these commands in order to keep everything synced.
 
 **Task: Standardize Package Headers**
 > "Scan `packages/`. Check headers. If missing/legacy, prepend:
->    ```yaml
->    # ------------------------------------------------------------------------------
->    # Package: [Filename]
->    # Version: 1.0.0
->    # Description: [Summary]
->    # Dependencies: [Entities used]
->    # ------------------------------------------------------------------------------
->    ```"
+>
+> ```yaml
+> # ------------------------------------------------------------------------------
+> # Package: [Filename]
+> # Version: 1.0.0
+> # Description: [Summary]
+> # Dependencies: [Entities used]
+> # ------------------------------------------------------------------------------
+> ```"
 
 **Task: Update Single Package (Focus Mode)**
 > "Run `python ag_update_package.py [package_name]`."
 > *(Fallback: "Update `[package].md` reading from `[package].yaml`. Check `auto_update` lock.")*
 
 **Task: Update Architecture (Structure & Overview)**
 > "Update `docs_site/docs/smart-home/structure.md` AND `docs_site/docs/index.md`.
+>
 > 1. **Structure:** Re-scan root. Update file tree.
 > 2. **Overview:** Update 'High Level Architecture' with new integrations."