CLARYEL PerimetroProject ter bespreking
Technisch document · 3 van 3

Softwareoplossing

Home Assistant op de lokale server: één app voor elke telefoon, tablet of browser, toegang met beperkte rechten en meldingen die ook aankomen als de telefoon op stil staat.

Home AssistantAndroid · iPhone · browserRechten per rolKritieke meldingenAlles lokaal, versleuteld, geen cloud
1

Wat we uit onze stack hebben gekozen, en waarom

Van de stack die al op onze lokale server draait zijn maar weinig onderdelen nodig. De rest — AI-analyse, versleuteld archief, video-opnames — blijft buiten Home Assistant.

  1. 1

    Home Assistant

    Het enige centrum van het systeem: het ontvangt de perimetergebeurtenissen, beheert de gebruikers en hun rechten en stuurt de meldingen naar de telefoons. Vrije software, draait lokaal op onze server.

  2. 2

    MQTT (Mosquitto)

    Het lokale berichtenkanaal tussen de veldknooppunten (ESP32), de AI-analyse en Home Assistant. De gebeurtenissen reizen als korte tekstberichten, zonder beelden.

  3. 3

    NUT (UPS-status)

    Brengt de status van de noodstroomvoorziening naar Home Assistant: een stroomuitval of een leeglopende accu wordt meteen een technische melding.

  4. 4

    Home Assistant Companion-app

    De officiële client voor Android en voor iPhone/iPad: hiermee komen de meldingen binnen en wordt het goedgekeurde dashboard geopend.

  5. 5

    WireGuard

    Het beveiligde kanaal dat het project al voor de verbinding voorziet: waar nodig laat het toe de app ook buiten het gebouw te gebruiken, zonder cloudabonnementen.

Blijft buiten Home Assistant: AI-analyse, versleuteld archief en video-opnames blijven op de server en de app kan ze niet tonen.
2

Schema: van de server naar de clients, de rollen en de rechten

Veldpunt

Camera of Wi-Fi-CSI-modules, met signalering

Lokale server

AI-analyse, versleuteling, archief, UPS en gegevensback-up

Home Assistant

Gebeurtenissen, gebruikers, rechten, meldingen

Clients

Eén app of de browser

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

Rollen en rechten

Ieder ziet alleen wat is goedgekeurd

  • Technisch beheerder
  • Aangewezen persoon
  • Bewoner

Home Assistant ontvangt alleen de gebeurtenis (tekst, tijd, hekwerkgedeelte): geen foto's of video. Wat niet in Home Assistant zit, is niet te zien in de app.

3

Eén client voor elk apparaat

De client is de officiële app Home Assistant Companion of gewoon de browser: kies wat u hebt.

  • Android

    App Home Assistant Companion uit de appstore: meldingen, goedgekeurd dashboard, snelle acties.

  • iPhone en iPad

    App Home Assistant Companion voor iOS en iPadOS: meldingen, ook kritieke, en goedgekeurd dashboard.

  • Browser op de computer

    Het volstaat het adres van Home Assistant te openen: geen installatie.

  • Tablet

    App of browser; met een eigen gebruiker kan hij als vast paneel aan de muur blijven hangen, bijvoorbeeld in de hal.

Toegang verloopt in het lokale netwerk van het gebouw of, buiten het gebouw, via het beveiligde WireGuard-kanaal. Een abonnement op Home Assistant Cloud is niet nodig.
4

Toegang met beperkte rechten

Ieder logt in met een eigen gebruikersnaam en wachtwoord (met tweestapsverificatie, indien ingeschakeld) en ziet alleen wat voor zijn rol is goedgekeurd. De onderstaande rollen zijn een voorstel om te bespreken.

  • Beheerder van Home Assistant

    Technisch beheerder

    Configureert het systeem, de gebruikers en de automatiseringen. Weinig accounts, met tweestapsverificatie; toegang kan worden beperkt tot het lokale netwerk.

  • Gebruiker zonder beheerdersrechten

    Aangewezen persoon

    Ontvangt de alarmen met actieknoppen om de gebeurtenis te bevestigen. Voor de beelden van het archief geldt de procedure die is voorbehouden aan aangewezen personen, met toegangsregister.

  • Gebruiker zonder beheerdersrechten

    Bewoner

    Ontvangt de meldingen (alleen tekst) en ziet een goedgekeurd dashboard met de systeemstatus. Geen toegang tot camera, archief of instellingen.

Wie wat magTechnisch beheerderAangewezen persoonBewoner
Alarmmeldingen ontvangen
De systeemstatus zien (goedgekeurd dashboard)
De gebeurtenis bevestigen met de actieknoppen
De beelden van het archief zien (alleen aangewezen personen, met register)
De lijst met ontvangers en de meldingsinstellingen beheren
Instellingen, gebruikers en automatiseringen wijzigen

Hoe de beperking wordt bereikt

  • Gebruikers zonder beheerdersrechten hebben geen toegang tot de Instellingen en kunnen geen gebruikers, apparaten, automatiseringen en dashboards beheren.
  • Elk dashboard kan worden voorbehouden aan de beheerders; aan bewoners wordt een apart, goedgekeurd dashboard toegewezen.
  • Voor elke gebruiker kan toegang alleen vanaf het lokale netwerk worden toegestaan en tweestapsverificatie worden ingeschakeld.
  • Elk apparaat kan worden losgekoppeld door zijn toegangstoken uit het profiel te verwijderen; het account van een gebruiker kan worden gedeactiveerd.
  • De sterkste grens zit in het ontwerp: Home Assistant biedt in de interface geen rechten per entiteit, dus alleen goedgekeurde informatie komt erin (alarmgebeurtenis, systeemstatus, UPS-status). Beelden en archief blijven buiten.
5

Meldingen die ook aankomen als de telefoon op stil staat

Bij een gevaarlijke schending van de perimeter wordt de melding als kritiek verstuurd: met de hieronder beschreven configuratie gaat hij ook over bij een telefoon op stil en met «Niet storen» actief, dus ook wanneer alle inkomende gesprekken geblokkeerd zijn (bijvoorbeeld 's nachts).

Vergrendelscherm
03:12
Telefoon op stilNiet storen actief
ALARMKritieke melding

Let op! Er is een persoon gedetecteerd in het bewaakte hekwerkgedeelte.

iPhone
Vergrendelscherm
03:12
Telefoon op stilNiet storen actief
ALARMalarm_stream

Let op! Er is een persoon gedetecteerd in het bewaakte hekwerkgedeelte.

Android

Voorbeeld van instelling (uit de officiële documentatie van Home Assistant Companion)

iPhone en iPad: kritieke melding

  • De kritieke meldingen (Critical Alerts) van iOS verschijnen bovenaan het vergrendelscherm boven alle andere meldingen en gaan ook over bij actief «Niet storen» of bij een iPhone op stil.
  • Ze kunnen bovendien de frequentielimieten van de meldingen van de app overschrijden.

1× Eenmalig: in de iOS-instellingen van de app Home Assistant meldingen toestaan, inclusief kritieke meldingen.

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

Android: hoge prioriteit en alarmkanaal

  • Met hoge prioriteit en levensduur 0 komt de melding meteen aan, ook als de telefoon stilligt of het scherm al lang uit is.
  • Met de audiostroom «wekker» (alarm stream) gaat de telefoon ook over in stille of trilmodus.

1× Eenmalig: in de systeeminstellingen van de app het alarmkanaal openen en toestaan «Niet storen» te omzeilen (standaard omzeilt het dat niet).

data:
  ttl: 0
  priority: high
  channel: alarm_stream

Waar u rekening mee moet houden

  • De melding is ontworpen om ook aan te komen bij een telefoon op stil, maar absolute aflevering kan niet worden beloofd: de telefoon moet aan staan en bereikbaar zijn (datanetwerk of Wi-Fi) en de eenmalige configuratie moet op elke telefoon worden gedaan.
  • Het bericht is alleen tekst, zonder foto's, video's of persoonsgegevens.
  • Gewoonlijk loopt het verzenden naar de telefoon via de pushmeldingeninfrastructuur van Apple of Google, zoals bij elke app. In het lokale netwerk van het gebouw is ook lokale aflevering (Local Push) via WebSocket beschikbaar, zonder via Apple of Google te gaan.
  • We raden een periodieke controlemelding aan, om op tijd te merken als een telefoon de meldingen niet meer ontvangt.
6

Niet alleen de perimeter: andere belangrijke meldingen

Hetzelfde kanaal kan ook andere belangrijke berichten met verschillende urgentieniveaus brengen. De keuze van beltoon en prioriteit gebeurt per niveau.

  • Kritiek

    Gevaarlijke schending van de perimeter: gaat altijd over, ook bij een telefoon op stil.

  • Dringend (technisch)

    Stroomuitval of leeglopende UPS-accu, verlies van de verbinding met het veldpunt, server onbereikbaar.

  • Informatief

    Afwijkende temperatuur of vochtigheid of waterlek in de behuizing, andere met het condominium afgesproken berichten. Mogen stil blijven.

Op iOS gaat het niveau «kritiek» zelfs door de stille modus heen, «time-sensitive» (dringend) door de focusmodi, «passief» maakt het scherm niet eens wakker.

Alles lokaal, versleuteld, zonder cloud

Analyse, archief en toegang blijven op de lokale server, versleuteld en zonder clouddiensten. Bij alarm wordt de toegang tot het archief meteen gesloten en zijn de opnames van de gebeurtenis beschermd tegen wijziging en verwijdering, zoals beschreven in het project.

✉

Vragen of opmerkingen?

Schrijf ons: we antwoorden graag. U kunt ook het projectformulier gebruiken.

Naar het projectformulier

Projectdocument om te bespreken met de bewoners en het beheer van het condominium: uitvoering is pas mogelijk na de nodige goedkeuringen.