CLARYEL PerimetroProyecto para debatir
Documento técnico · 3 de 3

Solución de software

Home Assistant en el servidor local: una aplicación para cualquier teléfono, tableta o navegador, accesos con derechos limitados y avisos que llegan incluso con el teléfono en silencio.

Home AssistantAndroid · iPhone · navegadorDerechos por rolAvisos críticosTodo en local, cifrado, sin nube
1

Qué hemos elegido de nuestra pila, y por qué

De la pila que ya funciona en nuestro servidor local hacen falta pocos elementos. El resto — análisis de IA, archivo cifrado, grabaciones — queda fuera de Home Assistant.

  1. 1

    Home Assistant

    El centro único del sistema: recibe los eventos del perímetro, gestiona los usuarios y sus derechos, envía los avisos a los teléfonos. Software libre, funciona en local en nuestro servidor.

  2. 2

    MQTT (Mosquitto)

    El canal local de mensajes entre los nodos de campo (ESP32), el análisis de IA y Home Assistant. Los eventos viajan como breves mensajes de texto, sin imágenes.

  3. 3

    NUT (estado de la UPS)

    Lleva a Home Assistant el estado del sistema de alimentación ininterrumpida: un apagón o una batería que se descarga se convierte al instante en un aviso técnico.

  4. 4

    Aplicación Home Assistant Companion

    El cliente oficial para Android y para iPhone/iPad: con ella llegan los avisos y se abre el panel aprobado.

  5. 5

    WireGuard

    El canal protegido ya previsto por el proyecto para el enlace: donde hace falta, permite usar la aplicación también fuera del edificio, sin suscripciones en la nube.

Queda fuera de Home Assistant: el análisis de IA, el archivo cifrado y las grabaciones permanecen en el servidor y la aplicación no puede mostrarlos.
2

Esquema: del servidor a los clientes, los roles y los derechos

Punto de campo

Cámara o módulos Wi-Fi CSI, con señalización

Servidor local

Análisis de IA, cifrado, archivo, UPS y backup de datos

Home Assistant

Eventos, usuarios, derechos, avisos

Clientes

Una aplicación o el navegador

  • Android
  • iPhone / iPad
  • Navegador (ordenador)
  • Tableta

Roles y derechos

Cada uno ve solo lo que está aprobado

  • Administrador técnico
  • Persona designada
  • Residente

Home Assistant recibe solo el evento (texto, hora, tramo de valla): ni fotos ni vídeo. Lo que no está en Home Assistant no se ve en la aplicación.

3

Un cliente para cualquier dispositivo

El cliente es la aplicación oficial Home Assistant Companion o simplemente el navegador: elija lo que tenga.

  • Android

    Aplicación Home Assistant Companion desde la tienda de aplicaciones: avisos, panel aprobado, acciones rápidas.

  • iPhone e iPad

    Aplicación Home Assistant Companion para iOS e iPadOS: avisos, también críticos, y panel aprobado.

  • Navegador en el ordenador

    Basta con abrir la dirección de Home Assistant: sin instalación.

  • Tableta

    Aplicación o navegador; con un usuario dedicado puede dejarse en la pared como panel fijo, por ejemplo en el portal.

El acceso se realiza en la red local del edificio o, fuera del edificio, mediante el canal protegido WireGuard. No hace falta ninguna suscripción a Home Assistant Cloud.
4

Acceso con derechos limitados

Cada uno entra con su propio nombre de usuario y contraseña (con verificación en dos pasos, si está activada) y ve solo lo que se ha aprobado para su rol. Los roles siguientes son una propuesta para debatir.

  • Administrador de Home Assistant

    Administrador técnico

    Configura el sistema, los usuarios y las automatizaciones. Pocas cuentas, con verificación en dos pasos; se puede permitir el acceso solo desde la red local.

  • Usuario sin derechos de administrador

    Persona designada

    Recibe las alarmas con botones de acción para confirmar el evento. Para las imágenes del archivo rige el procedimiento reservado a las personas designadas, con registro de accesos.

  • Usuario sin derechos de administrador

    Residente

    Recibe los avisos (solo texto) y ve un panel aprobado con el estado del sistema. Sin acceso a la cámara, al archivo ni a los ajustes.

Quién puede hacer quéAdministrador técnicoPersona designadaResidente
Recibir los avisos de alarma
Ver el estado del sistema (panel aprobado)
Confirmar el evento con los botones de acción
Ver las imágenes del archivo (solo personas designadas, con registro)
Gestionar la lista de destinatarios y los ajustes de los avisos
Modificar ajustes, usuarios y automatizaciones

Cómo se logra la limitación

  • Los usuarios sin derechos de administrador no acceden a los Ajustes y no pueden gestionar usuarios, dispositivos, automatizaciones ni paneles.
  • Cada panel puede reservarse a los administradores; a los residentes se les asigna un panel aparte y aprobado.
  • Para cada usuario se puede permitir el acceso solo desde la red local y activar la verificación en dos pasos.
  • Cada dispositivo puede desconectarse eliminando su token de acceso del perfil; la cuenta de un usuario puede desactivarse.
  • El límite más fuerte es de diseño: Home Assistant no ofrece permisos por entidad en la interfaz, por lo que solo entra la información aprobada (evento de alarma, estado del sistema, estado de la UPS). Las imágenes y el archivo quedan fuera.
5

Avisos que llegan incluso con el teléfono en silencio

En caso de violación peligrosa del perímetro el aviso se envía como crítico: con la configuración descrita más abajo suena incluso con el teléfono en silencio y con «No molestar» activado, es decir, también cuando todas las llamadas entrantes están bloqueadas (por ejemplo, de noche).

Pantalla de bloqueo
03:12
Teléfono en silencioNo molestar activo
ALARMAAviso crítico

¡Atención! Se ha detectado una persona en el tramo de valla controlado.

iPhone
Pantalla de bloqueo
03:12
Teléfono en silencioNo molestar activo
ALARMAalarm_stream

¡Atención! Se ha detectado una persona en el tramo de valla controlado.

Android

Ejemplo de configuración (de la documentación oficial de Home Assistant Companion)

iPhone e iPad: aviso crítico

  • Los avisos críticos (Critical Alerts) de iOS aparecen en lo alto de la pantalla de bloqueo por encima de todas las demás notificaciones y suenan incluso con «No molestar» activado o con el iPhone en silencio.
  • Además, pueden superar los límites de frecuencia de las notificaciones de la aplicación.

1× Una sola vez: en los ajustes de iOS de la aplicación Home Assistant permitir las notificaciones, incluidos los avisos críticos.

data:
  push:
    sound:
      name: "default"
      critical: 1
      volume: 1.0

Android: prioridad alta y canal de alarma

  • Con prioridad alta y duración 0 la notificación llega de inmediato, aunque el teléfono esté quieto o tenga la pantalla apagada desde hace tiempo.
  • Usando el flujo de audio «alarma» (alarm stream) el teléfono suena incluso en modo silencio o vibración.

1× Una sola vez: en los ajustes del sistema de la aplicación abrir el canal de alarma y permitir que se salte «No molestar» (por defecto no se lo salta).

data:
  ttl: 0
  priority: high
  channel: alarm_stream

Qué hay que tener presente

  • El aviso está diseñado para llegar incluso con el teléfono en silencio, pero no se puede prometer una entrega absoluta: el teléfono debe estar encendido y accesible (red de datos o Wi-Fi) y la configuración única debe hacerse en cada teléfono.
  • El mensaje es solo texto, sin fotos ni vídeos ni datos personales.
  • Por norma, el envío al teléfono pasa por la infraestructura de notificaciones push de Apple o Google, como en cualquier aplicación. En la red local del edificio también está disponible la entrega local (Local Push) mediante WebSocket, sin pasar por Apple ni Google.
  • Recomendamos un aviso periódico de verificación, para darse cuenta a tiempo si un teléfono deja de recibir los avisos.
6

No solo el perímetro: otros avisos importantes

El mismo canal puede llevar también otros mensajes importantes, con distintos niveles de urgencia. La elección de tono y prioridad se hace para cada nivel.

  • Crítico

    Violación peligrosa del perímetro: suena siempre, incluso con el teléfono en silencio.

  • Urgente (técnico)

    Apagón o batería de la UPS que se descarga, pérdida del enlace con el punto de campo, servidor inaccesible.

  • Informativo

    Temperatura o humedad anómalas o fuga de agua en la caja, otros mensajes acordados con la comunidad. Pueden permanecer silenciosos.

En iOS el nivel «crítico» supera incluso el silencio, el «time-sensitive» (urgente) supera los modos de concentración, el «pasivo» ni siquiera enciende la pantalla.

Todo en local, cifrado, sin nube

El análisis, el archivo y los accesos permanecen en el servidor local, de forma cifrada y sin servicios en la nube. En caso de alarma el acceso al archivo se cierra de inmediato y las grabaciones del evento quedan protegidas contra modificación y borrado, como se describe en el proyecto.

✉

¿Preguntas u observaciones?

Escríbanos: responderemos con gusto. También puede usar el formulario del proyecto.

Ir al formulario del proyecto

Documento de proyecto para debatir con los residentes y con la administración de la comunidad: su realización solo es posible tras las aprobaciones necesarias.