Add-on de Home Assistant

Configurador visual que genera y edita quirúrgicamente el YAML de ESPHome para cada dispositivo Xima Domo, junto con un espejo en vivo del estado de cada entidad en Home Assistant.

Funcionalidades

• Editor centrado en componentes: light, switch, cover, dallas, PZEM, cisterna, entrada digital.
• Edición quirúrgica del YAML — preserva tus secciones escritas a mano y la identidad (unique_id) en cada save.
• Estado en vivo de cada entidad, refrescado desde HA cada 3 s, con toggle de un click.
• Diff y undo por save; historial git por dispositivo.
• Detección de renombrado con búsqueda de referencias en automations de todo tu HA.
• Discovery de direcciones DS18B20 desde adentro del add-on.
• Soporte multi-medidor PZEM por RS485.
• Orquestación de cisterna con protección por caudal opcional.
• Interfaz EN / ES (cambio instantáneo).

Instalación

1. En Home Assistant: Ajustes → Add-ons → ⋮ → Repositorios.
2. Pegá la URL del repositorio: https://github.com/arivelli/xima-domo.
3. Instalá Xima Domo de los add-ons listados y arrancalo.
4. Abrí el panel en la sidebar y sumá tu primer dispositivo.

Pasos manuales para HAOS (local add-on) en /docs/addon/install.md.

Cómo está hecho

Frontend en React + TypeScript + Tailwind. Backend en FastAPI hablándole al Supervisor para leer estado de HA y escribir archivos en /config/esphome/. Las ediciones de YAML son quirúrgicas — el parser sigue la identidad de cada entidad por unique_id, así un rename en la UI no recrea silenciosamente tu entidad de HA.

Ver el índice de docs para la arquitectura y el deep-dive de yaml-surgery.md.