CLARYEL PerimetroProjeto para discussão
Documento técnico · 3 de 3

Solução de software

Home Assistant no servidor local: uma aplicação para qualquer telemóvel, tablet ou navegador, acessos com direitos limitados e avisos que chegam mesmo com o telemóvel em silêncio.

Home AssistantAndroid · iPhone · navegadorDireitos por funçãoAvisos críticosTudo local, cifrado, sem nuvem
1

O que escolhemos da nossa stack, e porquê

Da stack que já funciona no nosso servidor local são necessários poucos elementos. O resto — análise de IA, arquivo cifrado, gravações — fica fora do Home Assistant.

  1. 1

    Home Assistant

    O centro único do sistema: recebe os eventos do perímetro, gere os utilizadores e os seus direitos, envia os avisos para os telemóveis. Software livre, funciona em local no nosso servidor.

  2. 2

    MQTT (Mosquitto)

    O canal local de mensagens entre os nós de campo (ESP32), a análise de IA e o Home Assistant. Os eventos viajam como breves mensagens de texto, sem imagens.

  3. 3

    NUT (estado da UPS)

    Leva para o Home Assistant o estado da fonte de alimentação ininterrupta: um corte de energia ou uma bateria que se descarrega torna-se de imediato um aviso técnico.

  4. 4

    Aplicação Home Assistant Companion

    O cliente oficial para Android e para iPhone/iPad: com ela chegam os avisos e abre-se o painel aprovado.

  5. 5

    WireGuard

    O canal protegido já previsto pelo projeto para a ligação: onde é necessário, permite usar a aplicação também fora do edifício, sem subscrições na nuvem.

Fica fora do Home Assistant: a análise de IA, o arquivo cifrado e as gravações permanecem no servidor e a aplicação não os pode mostrar.
2

Esquema: do servidor aos clientes, às funções e aos direitos

Ponto de campo

Câmara ou módulos Wi-Fi CSI, com sinalização

Servidor local

Análise de IA, cifragem, arquivo, UPS e backup dos dados

Home Assistant

Eventos, utilizadores, direitos, avisos

Clientes

Uma aplicação ou o navegador

  • Android
  • iPhone / iPad
  • Navegador (computador)
  • Tablet

Funções e direitos

Cada um vê apenas o que está aprovado

  • Administrador técnico
  • Pessoa designada
  • Residente

O Home Assistant recebe apenas o evento (texto, hora, troço da vedação): nenhuma foto nem vídeo. O que não está no Home Assistant não se vê na aplicação.

3

Um cliente para qualquer dispositivo

O cliente é a aplicação oficial Home Assistant Companion ou simplesmente o navegador: escolha o que tem.

  • Android

    Aplicação Home Assistant Companion da loja de aplicações: avisos, painel aprovado, ações rápidas.

  • iPhone e iPad

    Aplicação Home Assistant Companion para iOS e iPadOS: avisos, também críticos, e painel aprovado.

  • Navegador no computador

    Basta abrir o endereço do Home Assistant: sem instalação.

  • Tablet

    Aplicação ou navegador; com um utilizador dedicado pode ficar na parede como painel fixo, por exemplo na entrada.

O acesso faz-se na rede local do edifício ou, fora do edifício, através do canal protegido WireGuard. Não é necessária nenhuma subscrição do Home Assistant Cloud.
4

Acesso com direitos limitados

Cada um entra com o seu próprio nome de utilizador e palavra-passe (com verificação em dois passos, se ativada) e vê apenas o que foi aprovado para a sua função. As funções abaixo são uma proposta a discutir.

  • Administrador do Home Assistant

    Administrador técnico

    Configura o sistema, os utilizadores e as automações. Poucas contas, com verificação em dois passos; pode permitir-se o acesso apenas a partir da rede local.

  • Utilizador sem direitos de administrador

    Pessoa designada

    Recebe os alarmes com botões de ação para confirmar o evento. Para as imagens do arquivo aplica-se o procedimento reservado às pessoas designadas, com registo de acessos.

  • Utilizador sem direitos de administrador

    Residente

    Recebe os avisos (apenas texto) e vê um painel aprovado com o estado do sistema. Sem acesso à câmara, ao arquivo nem às definições.

Quem pode fazer o quêAdministrador técnicoPessoa designadaResidente
Receber os avisos de alarme
Ver o estado do sistema (painel aprovado)
Confirmar o evento com os botões de ação
Ver as imagens do arquivo (apenas pessoas designadas, com registo)
Gerir a lista de destinatários e as definições dos avisos
Alterar definições, utilizadores e automações

Como se obtém a limitação

  • Os utilizadores sem direitos de administrador não acedem às Definições e não podem gerir utilizadores, dispositivos, automações nem painéis.
  • Cada painel pode ser reservado aos administradores; aos residentes atribui-se um painel separado e aprovado.
  • Para cada utilizador pode permitir-se o acesso apenas a partir da rede local e ativar a verificação em dois passos.
  • Cada dispositivo pode ser desligado eliminando o seu token de acesso do perfil; a conta de um utilizador pode ser desativada.
  • O limite mais forte é de conceção: o Home Assistant não oferece permissões por entidade na interface, pelo que só entra a informação aprovada (evento de alarme, estado do sistema, estado da UPS). Imagens e arquivo ficam de fora.
5

Avisos que chegam mesmo com o telemóvel em silêncio

Em caso de violação perigosa do perímetro o aviso é enviado como crítico: com a configuração descrita abaixo toca mesmo com o telemóvel em silêncio e com «Não incomodar» ativo, ou seja, também quando todas as chamadas recebidas estão bloqueadas (por exemplo, de noite).

Ecrã de bloqueio
03:12
Telemóvel em silêncioNão incomodar ativo
ALARMEAviso crítico

Atenção! Foi detetada uma pessoa no troço de vedação controlado.

iPhone
Ecrã de bloqueio
03:12
Telemóvel em silêncioNão incomodar ativo
ALARMEalarm_stream

Atenção! Foi detetada uma pessoa no troço de vedação controlado.

Android

Exemplo de configuração (da documentação oficial do Home Assistant Companion)

iPhone e iPad: aviso crítico

  • Os avisos críticos (Critical Alerts) do iOS aparecem no topo do ecrã de bloqueio acima de todas as outras notificações e tocam mesmo com «Não incomodar» ativo ou com o iPhone em silêncio.
  • Além disso, podem ultrapassar os limites de frequência das notificações da aplicação.

1× Uma só vez: nas definições do iOS da aplicação Home Assistant permitir as notificações, incluindo os avisos críticos.

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

Android: prioridade alta e canal de alarme

  • Com prioridade alta e duração 0 a notificação chega de imediato, mesmo que o telemóvel esteja parado ou tenha o ecrã apagado há muito tempo.
  • Usando o fluxo de áudio «despertador» (alarm stream) o telemóvel toca mesmo em modo silencioso ou vibração.

1× Uma só vez: nas definições do sistema da aplicação abrir o canal de alarme e permitir que ignore «Não incomodar» (por predefinição não o ignora).

data:
  ttl: 0
  priority: high
  channel: alarm_stream

O que é preciso ter presente

  • O aviso foi concebido para chegar mesmo com o telemóvel em silêncio, mas não se pode prometer uma entrega absoluta: o telemóvel tem de estar ligado e contactável (rede de dados ou Wi-Fi) e a configuração única tem de ser feita em cada telemóvel.
  • A mensagem é apenas texto, sem fotografias nem vídeos nem dados pessoais.
  • Por norma, o envio para o telemóvel passa pela infraestrutura de notificações push da Apple ou da Google, como em qualquer aplicação. Na rede local do edifício está também disponível a entrega local (Local Push) através de WebSocket, sem passar pela Apple nem pela Google.
  • Recomendamos um aviso periódico de verificação, para perceber a tempo se um telemóvel deixou de receber os avisos.
6

Não só o perímetro: outros avisos importantes

O mesmo canal pode transportar também outras mensagens importantes, com diferentes níveis de urgência. A escolha de toque e prioridade faz-se para cada nível.

  • Crítico

    Violação perigosa do perímetro: toca sempre, mesmo com o telemóvel em silêncio.

  • Urgente (técnico)

    Corte de energia ou bateria da UPS a descarregar, perda da ligação ao ponto de campo, servidor inacessível.

  • Informativo

    Temperatura ou humidade anómalas ou fuga de água na caixa, outras mensagens acordadas com o condomínio. Podem permanecer silenciosos.

No iOS o nível «crítico» ultrapassa até o silêncio, o «time-sensitive» (urgente) ultrapassa os modos de concentração, o «passivo» nem sequer acende o ecrã.

Tudo local, cifrado, sem nuvem

A análise, o arquivo e os acessos permanecem no servidor local, de forma cifrada e sem serviços na nuvem. Em caso de alarme o acesso ao arquivo fecha-se de imediato e as gravações do evento ficam protegidas contra alteração e eliminação, como descrito no projeto.

✉

Perguntas ou observações?

Escreva-nos: responderemos com gosto. Pode também usar o formulário do projeto.

Ir para o formulário do projeto

Documento de projeto a discutir com os residentes e com a administração do condomínio: a realização só é possível após as aprovações necessárias.