CLARYEL PerimetroProgetto da discutere
Documento tecnico · 3 di 3

Soluzione software

Home Assistant sul server locale: un'app per qualsiasi telefono, tablet o browser, accessi con diritti limitati e avvisi che arrivano anche a telefono silenzioso.

Home AssistantAndroid · iPhone · browserDiritti per ruoloAvvisi criticiTutto in locale, cifrato, nessun cloud
1

Che cosa abbiamo scelto dal nostro stack, e perché

Dello stack che già gira sul nostro server locale servono pochi elementi. Il resto — analisi IA, archivio cifrato, filmati — resta fuori da Home Assistant.

  1. 1

    Home Assistant

    Il centro unico del sistema: riceve gli eventi del perimetro, gestisce gli utenti e i loro diritti, invia gli avvisi ai telefoni. Software libero, funziona in locale sul nostro server.

  2. 2

    MQTT (Mosquitto)

    Il canale locale di messaggi tra i nodi da campo (ESP32), l'analisi IA e Home Assistant. Gli eventi viaggiano come brevi messaggi di testo, senza immagini.

  3. 3

    NUT (stato dell'UPS)

    Porta in Home Assistant lo stato del gruppo di continuità: un blackout o una batteria che si scarica diventano subito un avviso tecnico.

  4. 4

    App Home Assistant Companion

    Il cliente ufficiale per Android e per iPhone/iPad: con essa arrivano gli avvisi e si apre la dashboard approvata.

  5. 5

    WireGuard

    Il canale protetto già previsto dal progetto per il collegamento: dove serve, permette di usare l'app anche fuori dall'edificio, senza abbonamenti cloud.

Resta fuori da Home Assistant: analisi IA, archivio cifrato e filmati restano sul server e l'app non può mostrarli.
2

Schema: dal server ai clienti, ai ruoli e ai diritti

Punto da campo

Telecamera o moduli Wi-Fi CSI, con segnalazione

Server locale

Analisi IA, cifratura, archivio, UPS e backup dei dati

Home Assistant

Eventi, utenti, diritti, avvisi

Clienti

Un'app oppure il browser

  • Android
  • iPhone / iPad
  • Browser (computer)
  • Tablet

Ruoli e diritti

Ognuno vede solo ciò che è approvato

  • Amministratore tecnico
  • Persona incaricata
  • Residente

Home Assistant riceve solo l'evento (testo, ora, tratto di recinzione): nessuna foto né video. Ciò che non è in Home Assistant, nell'app non si vede.

3

Un cliente per qualsiasi dispositivo

Il cliente è l'app ufficiale Home Assistant Companion oppure semplicemente il browser: scegli ciò che hai.

  • Android

    App Home Assistant Companion dal negozio di app: avvisi, dashboard approvata, azioni rapide.

  • iPhone e iPad

    App Home Assistant Companion per iOS e iPadOS: avvisi, anche critici, e dashboard approvata.

  • Browser su computer

    Basta aprire l'indirizzo di Home Assistant: nessuna installazione.

  • Tablet

    App o browser; con un utente dedicato si può lasciare a muro come pannello fisso, ad esempio nell'androne.

L'accesso avviene nella rete locale dell'edificio oppure, fuori dall'edificio, tramite il canale protetto WireGuard. Non serve alcun abbonamento a Home Assistant Cloud.
4

Accesso con diritti limitati

Ognuno entra con il proprio nome utente e la propria password (con verifica a due fattori, se attivata) e vede solo ciò che è stato approvato per il suo ruolo. I ruoli qui sotto sono una proposta da discutere.

  • Amministratore di Home Assistant

    Amministratore tecnico

    Configura il sistema, gli utenti e le automazioni. Pochi account, con verifica a due fattori; si può consentire l'accesso solo dalla rete locale.

  • Utente senza diritti di amministratore

    Persona incaricata

    Riceve gli allarmi con i pulsanti d'azione per confermare l'evento. Per le immagini dell'archivio vale la procedura riservata alle persone designate, con registro degli accessi.

  • Utente senza diritti di amministratore

    Residente

    Riceve gli avvisi (solo testo) e vede una dashboard approvata con lo stato del sistema. Nessun accesso alla telecamera, all'archivio né alle impostazioni.

Chi può fare che cosaAmministratore tecnicoPersona incaricataResidente
Ricevere gli avvisi di allarme
Vedere lo stato del sistema (dashboard approvata)
Confermare l'evento con i pulsanti d'azione
Vedere le immagini dell'archivio (solo persone designate, con registro)
Gestire l'elenco dei destinatari e le impostazioni degli avvisi
Modificare impostazioni, utenti e automazioni

Come si ottiene la limitazione

  • Gli utenti senza diritti di amministratore non accedono alle Impostazioni e non possono gestire utenti, dispositivi, automazioni e dashboard.
  • Ogni dashboard può essere riservata agli amministratori; ai residenti si assegna una dashboard separata e approvata.
  • Per ogni utente si può consentire l'accesso solo dalla rete locale e attivare la verifica a due fattori.
  • Ogni dispositivo si può scollegare eliminando il suo token di accesso dal profilo; l'account di un utente può essere disattivato.
  • Il confine più forte è progettuale: Home Assistant non offre autorizzazioni per singola entità nell'interfaccia, quindi vi entrano solo le informazioni approvate (evento di allarme, stato del sistema, stato dell'UPS). Immagini e archivio restano fuori.
5

Avvisi che arrivano anche a telefono silenzioso

In caso di violazione pericolosa del perimetro l'avviso viene inviato come critico: con la configurazione descritta qui sotto suona anche a telefono silenzioso e con «Non disturbare» attivo, quindi anche quando tutte le chiamate in arrivo sono bloccate (per esempio di notte).

Schermata di blocco
03:12
Telefono silenziosoNon disturbare attivo
ALLARMEAvviso critico

Attenzione! Rilevata una persona nel tratto di recinzione controllato.

iPhone
Schermata di blocco
03:12
Telefono silenziosoNon disturbare attivo
ALLARMEalarm_stream

Attenzione! Rilevata una persona nel tratto di recinzione controllato.

Android

Esempio di impostazione (dalla documentazione ufficiale di Home Assistant Companion)

iPhone e iPad: avviso critico

  • Gli avvisi critici (Critical Alerts) di iOS compaiono in cima alla schermata di blocco sopra tutte le altre notifiche e suonano anche con «Non disturbare» attivo o con l'iPhone silenzioso.
  • Possono inoltre superare i limiti di frequenza delle notifiche dell'app.

1× Una tantum: nelle impostazioni iOS dell'app Home Assistant consentire le notifiche, compresi gli avvisi critici.

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

Android: priorità alta e canale di allarme

  • Con priorità alta e durata 0 la notifica arriva subito, anche se il telefono è fermo o ha lo schermo spento da tempo.
  • Usando il flusso audio «sveglia» (alarm stream) il telefono suona anche in modalità silenziosa o vibrazione.

1× Una tantum: nelle impostazioni di sistema dell'app aprire il canale di allarme e consentire di scavalcare «Non disturbare» (di default non lo scavalca).

data:
  ttl: 0
  priority: high
  channel: alarm_stream

Cosa va tenuto presente

  • L'avviso è progettato per arrivare anche a telefono silenzioso, ma non si può promettere una consegna assoluta: il telefono deve essere acceso e raggiungibile (rete dati o Wi-Fi) e la configurazione una tantum va fatta su ogni telefono.
  • Il messaggio è solo testo, senza foto né video né dati personali.
  • Di norma l'invio al telefono passa dall'infrastruttura delle notifiche push di Apple o Google, come per qualsiasi app. Nella rete locale dell'edificio è disponibile anche la consegna locale (Local Push) tramite WebSocket, senza passare da Apple o Google.
  • Consigliamo un avviso periodico di verifica, per accorgersi in tempo se un telefono non riceve più gli avvisi.
6

Non solo il perimetro: altri avvisi importanti

Lo stesso canale può portare anche altri messaggi importanti, con livelli di urgenza diversi. La scelta di suoneria e priorità si fa per ogni livello.

  • Critico

    Violazione pericolosa del perimetro: suona sempre, anche a telefono silenzioso.

  • Urgente (tecnico)

    Blackout o batteria dell'UPS che si scarica, perdita del collegamento con il punto da campo, server non raggiungibile.

  • Informativo

    Temperatura o umidità anomale o perdita d'acqua nel box, altri messaggi concordati con il condominio. Possono restare silenziosi.

Su iOS il livello «critico» supera anche il silenzioso, quello «time-sensitive» (urgente) supera le modalità di concentrazione, quello «passivo» non sveglia nemmeno lo schermo.

Tutto in locale, cifrato, senza cloud

Analisi, archivio e accessi restano sul server locale, in forma cifrata e senza servizi cloud. In caso di allarme l'accesso all'archivio si chiude subito e i filmati dell'evento sono protetti da modifica e cancellazione, come descritto nel progetto.

✉

Domande o osservazioni?

Scrivici: rispondiamo volentieri. Puoi anche usare il modulo del progetto.

Vai al modulo del progetto

Documento di progetto da discutere con i residenti e con l'amministrazione del condominio: la realizzazione è possibile solo dopo le necessarie approvazioni.