Docs: Add Integrations section (AI Reporter)

Author: webosa

docs/smart-home/index.md

@@ -21,7 +21,11 @@ This section contains all architectural documentation for the Home Assistant set
 - **[Package Catalog](packages/index.md)**:
   Index of all feature-based configuration packages (Automations, Scripts, etc.).
 
+- **[Integrations Catalog](integrations/index.md)**:
+  Index of external systems running outside Home Assistant.
+
 ## Contents
 - **[Automations](automations.md)**: Detailed breakdown of UI-managed automations (`automations.yaml`).
 - **[Dashboards](dashboards/index.md)**: Overview of Lovelace dashboards.
+- **[Integrations](integrations/index.md)**: External systems (Docker, Scripts).
 - **[Packages](packages/index.md)**: Modular configuration bundles.

docs/smart-home/integrations/ai_reporter.md

@@ -0,0 +1,83 @@
+---
+tags:
+  - integration
+  - manual
+  - ai
+  - docker
+---
+
+# Integration: AI Log Reporter
+
+**Type:** Remote Docker Container  
+**Host:** `10.0.0.23`  
+**Language:** Python 3.11  
+
+## Overview
+The **AI Log Reporter** is an external system designed to offload heavy log analysis from the Home Assistant host. It runs in a Docker container on a separate server, allowing it to process large datasets without impacting HA performance.
+
+## Architecture
+
+The system works via a "Pull & Push" mechanism:
+1.  **Trigger:** Home Assistant opens a secure SSH tunnel to the host.
+2.  **Execution:** HA executes the python script inside the running container.
+3.  **Callback:** The script analyzes the data and pushes the result back to Home Assistant via the API.
+
+```mermaid
+sequenceDiagram
+    participant HA as 🏠 Home Assistant
+    participant SSH as 🔐 SSH Tunnel
+    participant Docker as 🐳 Docker (ai-log-reporter)
+    participant API as 📡 HA API
+
+    HA->>SSH: Connect (Identity File)
+    SSH->>Docker: exec python /app/reporter.py
+    activate Docker
+    Docker->>Docker: Analyze Logs & Generate Summary
+    Docker->>API: POST /api/events/update_ai_summary
+    deactivate Docker
+```
+
+## Deployment
+
+### Docker Compose
+The system is deployed using a standard `docker-compose.yml` file on the remote host.
+
+```yaml
+version: '3.8'
+services:
+  reporter:
+    container_name: ai-log-reporter
+    image: python:3.11-slim
+    restart: unless-stopped
+    volumes:
+      - ./app:/app
+      - ./logs:/logs:ro
+    environment:
+      - HA_URL=http://10.0.0.5:8123
+      - HA_TOKEN=klsjdflkjsdf...
+    command: tail -f /dev/null  # Keep alive for exec
+```
+
+### The Reporter Script
+The core logic resides in `reporter.py`. It uses the Gemini API to summarize text.
+
+```python
+# /app/reporter.py (Simplified)
+import requests
+import os
+
+def analyze_logs():
+    # ... logic to read files ...
+    summary = "System is stable. No critical errors found."
+    
+    # Send Event to HA
+    url = f"{os.getenv('HA_URL')}/api/events/update_ai_summary"
+    headers = {"Authorization": f"Bearer {os.getenv('HA_TOKEN')}"}
+    requests.post(url, json={"summary": summary}, headers=headers)
+
+if __name__ == "__main__":
+    analyze_logs()
+```
+
+## Related Components
+*   **[Ai Summary Package](../packages/ai_summary.md)**: The Home Assistant configuration that triggers this integration.

docs/smart-home/integrations/index.md

@@ -0,0 +1,14 @@
+---
+tags:
+  - index
+  - integrations
+---
+
+# External Integrations
+
+This section documents external systems and custom integrations that run outside of Home Assistant but are critical to the smart home ecosystem.
+
+## 🔗 Integrations Catalog
+
+- **[AI Log Reporter](ai_reporter.md)**
+  <br> :material-arrow-right-bottom: *Remote Python system running on Docker to analyze logs and report back to Home Assistant.*

docs/smart-home/packages/ai_summary.md

@@ -16,7 +16,9 @@ version: Unknown
 
 ## Executive Summary
 <!-- START_SUMMARY -->
-*No executive summary generated yet.*
+This package acts as the **Frontend** and **Controller** for the external **[AI Log Reporter Integration](../integrations/ai_reporter.md)**.
+1.  It provides the **Template Sensor** to display the summary.
+2.  It handles the **Scheduling** (7:00 AM) and **SSH Connection** logic to trigger the remote analysis.
 <!-- END_SUMMARY -->
 
 ## Process Description (Non-Technical)
@@ -31,11 +33,23 @@ version: Unknown
 
 ## Architecture Diagram
 <!-- START_MERMAID_DESC -->
-*No architecture explanation generated yet.*
+The diagram below illustrates the hand-off between this Home Assistant package and the external Docker container. For full implementation details of the remote system, see the **[AI Reporter Integration](../integrations/ai_reporter.md)** documentation.
 <!-- END_MERMAID_DESC -->
 
 <!-- START_MERMAID -->
-*No architecture diagram generated yet.*
+```mermaid
+sequenceDiagram
+    participant Sched as ⏰ Schedule
+    participant Script as 📜 Script
+    participant SSH as 🔐 SSH Tunnel
+    participant Remote as 📦 Remote Integration
+
+    Sched->>Script: Trigger 7:00 AM
+    Script->>SSH: Connect root@10.0.0.23
+    SSH->>Remote: Trigger Docker Analysis
+    Note over Remote: Processing...
+    Remote-->>Script: (Async Event Return)
+```
 <!-- END_MERMAID -->
 
 ## Configuration (Source Code)