# Home Assistant OS & Proxmox Homelab Hub

## 🛡️ Sentinel Status
- **Status:** 🟢 Operacional / Masterpiece v2.6
- **Tier:** S
- **Health:** 99% / **ROI Potencial:** Central de esteira de implantação para Home Assistant OS em Mini PC x86 (Intel N100), Proxmox VE 8, malha Zigbee 3.0 (SLZB-06), integração nativa ESPHome Maker e sobrevivência energética 24/7.
- **Stack:** HTML5, CSS3 (Cyber-Growth Design System), Vanilla JS, JSON, PWA (Service Worker + Web Manifest), Home Assistant OS (HAOS 13+), Proxmox VE 8.x (KVM/VirtIO), Zigbee2MQTT, ESPHome (Noise Protocol), Mosquitto MQTT, NUT (Network UPS Tools), Tailscale WireGuard.

---

Bancada e portal canônico de **implantação, arquitetura e automações para Home Assistant OS (HAOS)** no ecossistema **Artes do Sul**. A aplicação lê dinamicamente `data/haos_guides.json` e fornece guias passo a passo, comandos CLI executáveis, snippets YAML de automação, topologias de rede interativas, calculadora de consumo energético 24/7 e persistência de checklist em LocalStorage.

Integrado ao ecossistema de 6 PWAs:
- 🏠 **HAOS Lab:** [`https://haos.artesdosul.com/`](https://haos.artesdosul.com/)
- 🛠️ **Oficina Maker:** [`https://oficina.artesdosul.com/`](https://oficina.artesdosul.com/)
- 📟 **M5Stack Lab:** [`https://m5stack.artesdosul.com/`](https://m5stack.artesdosul.com/)
- 📡 **Rede ESP-NOW Cisterna:** [`https://espnow.artesdosul.com/`](https://espnow.artesdosul.com/)
- ⚡ **Homelab AI 2026:** [`https://homelab.artesdosul.com/`](https://homelab.artesdosul.com/)
- 🔬 **Guia Embarcados 2026:** [`https://embedded.artesdosul.com/`](https://embedded.artesdosul.com/)

## Como Abrir Localmente

```bash
# Via npx serve:
npx --yes serve haos

# Ou via Python HTTP Server:
python -m http.server 8768 --directory haos
```

Abra a URL indicada no terminal (requisições `fetch` para `data/haos_guides.json` exigem servidor HTTP local ou execução local).

## Estrutura de Arquivos

| Arquivo / Diretório | Função |
|---|---|
| `data/haos_guides.json` | Fonte de dados canônica — 12+ módulos detalhados, BOM, comandos CLI, snippets YAML e links de compra |
| `index.html` | Masterpiece Dashboard: busca instantânea, filtros por categoria/hardware, topologias de rede, calculadora 24/7 e modal drawer |
| `guia-proxmox-haos.html` | Guia completo: Instalação do Proxmox VE 8 no Mini PC N100, KVM, OVMF UEFI, VirtIO SCSI, backups e snapshots |
| `guia-zigbee2mqtt.html` | Guia completo: Coordenador SLZB-06 Ethernet PoE vs Sonoff Dongle-E, canal 25 sem interferência e Zigbee2MQTT |
| `guia-esphome-integracao.html` | Guia completo: Integração Maker de cisterna (JSN-SR04T), display touch CYD 2.8" e M5Stack via Native API |
| `benchmark-hardware-haos.html` | Matriz de decisão: Benchmark comparativo N100 vs Raspberry Pi 5 vs Thin Client x86 com consumo em Watts e preços no Brasil |
| `guia-automacoes-nobreak.html` | Guia completo: Integração de Nobreak USB (NUT), alívio de cargas elétricas e proteção de bomba da cisterna |
| `css/haos.css` | Cyber-Growth Design System para Home Assistant (paleta dark #080d1a, acentos neon blue/cyan/orange/green) |
| `js/haos-app.js` | Lógica interativa do dashboard: filtros multi-eixo, busca em tempo real, abas de arquitetura, calculadora e modal |
| `js/ecosystem-switcher.js` | Seletor global unificado dos 6 PWAs do ecossistema Maker Artes do Sul |
| `manifest.json` + `sw.js` | PWA instalável com suporte offline e atalhos rápidos de navegação |
| `assets/` | Imagens cinemáticas em 16:9 geradas para os heros, ícones PWA e sharecards OG |

## Módulos Cobertos no Catálogo

1. **🖥️ Proxmox VE 8 no Mini PC Intel N100:** BIOS UEFI, Passthrough USB, tuning de 6W e scripts de automação.
2. **🏠 VM Home Assistant OS (HAOS):** Criação com VirtIO SCSI, descarte TRIM e agente QEMU.
3. **📡 Coordenador Zigbee 3.0 Ethernet (SLZB-06):** Socket TCP `tcp://192.168.1.210:8888`, canal 25 e Mosquitto Broker.
4. **⚡ Nós ESPHome Maker:** Cisterna com ultrassônico JSN-SR04T, boia magnética e display touch CYD 2.8" LVGL.
5. **🔋 Medição de Energia & Relés:** Shelly 1PM Gen4, Sonoff POWR316D e medidores de trilho DIN.
6. **🔌 Nobreak USB & Sobrevivência 24/7:** Telemetria NUT, corte de cargas em apagões e shutdown gracioso de VMs.
7. **🌐 Acesso Remoto Seguro:** Tailscale WireGuard Mesh & Cloudflare Tunnels sem abertura de portas.
8. **📊 Dashboard Lovelace Masterpiece:** Tema Cyber Dark, Mushroom Cards, Card-mod e modo Kiosk para tablets.
9. **🎙️ Assistente de Voz Local:** Whisper STT + Piper TTS + Open Wake Word + microfone M5Stack Atom Echo.
10. **💾 Backups Automatizados 3-2-1:** Snapshots ZFS, Proxmox VZDump e backup criptografado no Google Drive.