CLARYEL PerimetroProjekt do dyskusji
Dokument techniczny · 3 z 3

Rozwiązanie programowe

Home Assistant na serwerze lokalnym: jedna aplikacja na każdy telefon, tablet lub przeglądarkę, dostęp z ograniczonymi uprawnieniami i powiadomienia, które docierają nawet przy telefonie w trybie cichym.

Home AssistantAndroid · iPhone · przeglądarkaUprawnienia według roliAlerty krytyczneWszystko lokalnie, szyfrowane, bez chmury
1

Co wybraliśmy z naszego stosu i dlaczego

Ze stosu, który już działa na naszym serwerze lokalnym, potrzeba niewielu elementów. Reszta — analiza AI, szyfrowane archiwum, nagrania — pozostaje poza Home Assistant.

  1. 1

    Home Assistant

    Jedyne centrum systemu: odbiera zdarzenia z obwodu, zarządza użytkownikami i ich uprawnieniami, wysyła powiadomienia na telefony. Wolne oprogramowanie, działa lokalnie na naszym serwerze.

  2. 2

    MQTT (Mosquitto)

    Lokalny kanał wiadomości między węzłami terenowymi (ESP32), analizą AI i Home Assistant. Zdarzenia podróżują jako krótkie wiadomości tekstowe, bez obrazów.

  3. 3

    NUT (stan UPS)

    Przekazuje do Home Assistant stan zasilacza awaryjnego: przerwa w dostawie prądu lub rozładowujący się akumulator od razu staje się alertem technicznym.

  4. 4

    Aplikacja Home Assistant Companion

    Oficjalny klient dla Androida i iPhone'a/iPada: dzięki niej docierają powiadomienia i otwiera się zatwierdzony pulpit.

  5. 5

    WireGuard

    Chroniony kanał przewidziany już w projekcie do łączności: tam, gdzie trzeba, pozwala korzystać z aplikacji także poza budynkiem, bez subskrypcji w chmurze.

Pozostaje poza Home Assistant: analiza AI, szyfrowane archiwum i nagrania zostają na serwerze, a aplikacja nie może ich pokazać.
2

Schemat: od serwera do klientów, ról i uprawnień

Punkt terenowy

Kamera lub moduły Wi-Fi CSI, z sygnalizacją

Serwer lokalny

Analiza AI, szyfrowanie, archiwum, UPS i backup danych

Home Assistant

Zdarzenia, użytkownicy, uprawnienia, powiadomienia

Klienci

Aplikacja lub przeglądarka

  • Android
  • iPhone / iPad
  • Przeglądarka (komputer)
  • Tablet

Role i uprawnienia

Każdy widzi tylko to, co zatwierdzone

  • Administrator techniczny
  • Osoba wyznaczona
  • Mieszkaniec

Home Assistant otrzymuje tylko zdarzenie (tekst, godzinę, odcinek ogrodzenia): żadnych zdjęć ani wideo. To, czego nie ma w Home Assistant, nie jest widoczne w aplikacji.

3

Jeden klient na każde urządzenie

Klientem jest oficjalna aplikacja Home Assistant Companion albo po prostu przeglądarka: wybierz to, co masz.

  • Android

    Aplikacja Home Assistant Companion ze sklepu z aplikacjami: powiadomienia, zatwierdzony pulpit, szybkie akcje.

  • iPhone i iPad

    Aplikacja Home Assistant Companion na iOS i iPadOS: powiadomienia, także krytyczne, i zatwierdzony pulpit.

  • Przeglądarka na komputerze

    Wystarczy otworzyć adres Home Assistant: bez instalacji.

  • Tablet

    Aplikacja lub przeglądarka; z dedykowanym użytkownikiem można go zostawić na ścianie jako stały panel, np. w holu.

Dostęp odbywa się w sieci lokalnej budynku lub, poza budynkiem, przez chroniony kanał WireGuard. Subskrypcja Home Assistant Cloud nie jest potrzebna.
4

Dostęp z ograniczonymi uprawnieniami

Każdy loguje się własną nazwą użytkownika i hasłem (z weryfikacją dwuetapową, jeśli jest włączona) i widzi tylko to, co zatwierdzono dla jego roli. Poniższe role to propozycja do omówienia.

  • Administrator Home Assistant

    Administrator techniczny

    Konfiguruje system, użytkowników i automatyzacje. Niewiele kont, z weryfikacją dwuetapową; dostęp można ograniczyć do sieci lokalnej.

  • Użytkownik bez uprawnień administratora

    Osoba wyznaczona

    Otrzymuje alarmy z przyciskami akcji do potwierdzenia zdarzenia. Dla obrazów z archiwum obowiązuje procedura zastrzeżona dla osób wyznaczonych, z rejestrem dostępów.

  • Użytkownik bez uprawnień administratora

    Mieszkaniec

    Otrzymuje powiadomienia (tylko tekst) i widzi zatwierdzony pulpit ze stanem systemu. Brak dostępu do kamery, archiwum i ustawień.

Kto co możeAdministrator technicznyOsoba wyznaczonaMieszkaniec
Otrzymywać powiadomienia alarmowe
Widzieć stan systemu (zatwierdzony pulpit)
Potwierdzać zdarzenie przyciskami akcji
Widzieć obrazy z archiwum (tylko osoby wyznaczone, z rejestrem)
Zarządzać listą odbiorców i ustawieniami powiadomień
Zmieniać ustawienia, użytkowników i automatyzacje

Jak uzyskuje się ograniczenie

  • Użytkownicy bez uprawnień administratora nie mają dostępu do Ustawień i nie mogą zarządzać użytkownikami, urządzeniami, automatyzacjami ani pulpitami.
  • Każdy pulpit można zarezerwować dla administratorów; mieszkańcom przypisuje się osobny, zatwierdzony pulpit.
  • Dla każdego użytkownika można zezwolić na dostęp tylko z sieci lokalnej i włączyć weryfikację dwuetapową.
  • Każde urządzenie można odłączyć, usuwając jego token dostępu z profilu; konto użytkownika można dezaktywować.
  • Najsilniejsza granica jest projektowa: Home Assistant nie oferuje w interfejsie uprawnień dla pojedynczych encji, dlatego trafiają do niego tylko zatwierdzone informacje (zdarzenie alarmowe, stan systemu, stan UPS). Obrazy i archiwum pozostają na zewnątrz.
5

Powiadomienia, które docierają nawet przy telefonie w trybie cichym

W razie niebezpiecznego naruszenia obwodu powiadomienie jest wysyłane jako krytyczne: przy konfiguracji opisanej poniżej dzwoni nawet przy telefonie w trybie cichym i z włączonym „Nie przeszkadzać”, a więc także wtedy, gdy wszystkie połączenia przychodzące są zablokowane (na przykład w nocy).

Ekran blokady
03:12
Telefon w trybie cichymNie przeszkadzać włączone
ALARMAlert krytyczny

Uwaga! Wykryto osobę w kontrolowanym odcinku ogrodzenia.

iPhone
Ekran blokady
03:12
Telefon w trybie cichymNie przeszkadzać włączone
ALARMalarm_stream

Uwaga! Wykryto osobę w kontrolowanym odcinku ogrodzenia.

Android

Przykład ustawienia (z oficjalnej dokumentacji Home Assistant Companion)

iPhone i iPad: alert krytyczny

  • Alerty krytyczne (Critical Alerts) w iOS pojawiają się na górze ekranu blokady nad wszystkimi innymi powiadomieniami i dzwonią nawet przy włączonym „Nie przeszkadzać” lub przy wyciszonym iPhonie.
  • Mogą ponadto przekraczać limity częstotliwości powiadomień aplikacji.

1× Jednorazowo: w ustawieniach iOS aplikacji Home Assistant zezwolić na powiadomienia, w tym alerty krytyczne.

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

Android: wysoki priorytet i kanał alarmowy

  • Przy wysokim priorytecie i czasie życia 0 powiadomienie dociera natychmiast, nawet jeśli telefon leży nieruchomo lub ma od dawna wyłączony ekran.
  • Używając strumienia audio „budzik” (alarm stream) telefon dzwoni także w trybie cichym lub wibracji.

1× Jednorazowo: w ustawieniach systemowych aplikacji otworzyć kanał alarmowy i zezwolić na pomijanie „Nie przeszkadzać” (domyślnie go nie pomija).

data:
  ttl: 0
  priority: high
  channel: alarm_stream

O czym należy pamiętać

  • Powiadomienie zaprojektowano tak, by docierało nawet przy telefonie w trybie cichym, ale nie można obiecać absolutnego doręczenia: telefon musi być włączony i osiągalny (sieć danych lub Wi-Fi), a jednorazowa konfiguracja musi być wykonana na każdym telefonie.
  • Wiadomość to sam tekst, bez zdjęć, wideo ani danych osobowych.
  • Zazwyczaj wysyłka na telefon przechodzi przez infrastrukturę powiadomień push Apple lub Google, jak w każdej aplikacji. W sieci lokalnej budynku dostępne jest także doręczanie lokalne (Local Push) przez WebSocket, bez przechodzenia przez Apple lub Google.
  • Zalecamy okresowe powiadomienie kontrolne, aby w porę zauważyć, że telefon przestał odbierać powiadomienia.
6

Nie tylko obwód: inne ważne powiadomienia

Tym samym kanałem mogą też płynąć inne ważne wiadomości, o różnych poziomach pilności. Wybór dzwonka i priorytetu robi się dla każdego poziomu.

  • Krytyczny

    Niebezpieczne naruszenie obwodu: dzwoni zawsze, także przy telefonie w trybie cichym.

  • Pilny (techniczny)

    Przerwa w dostawie prądu lub rozładowujący się akumulator UPS, utrata łączności z punktem terenowym, serwer nieosiągalny.

  • Informacyjny

    Nietypowa temperatura lub wilgotność albo wyciek wody w obudowie, inne wiadomości uzgodnione ze wspólnotą. Mogą pozostać ciche.

W iOS poziom „krytyczny” przebija nawet tryb cichy, „time-sensitive” (pilny) przebija tryby skupienia, „pasywny” nie budzi nawet ekranu.

Wszystko lokalnie, szyfrowane, bez chmury

Analiza, archiwum i dostępy pozostają na serwerze lokalnym, w formie zaszyfrowanej i bez usług w chmurze. W razie alarmu dostęp do archiwum zamyka się natychmiast, a nagrania zdarzenia są chronione przed modyfikacją i usunięciem, jak opisano w projekcie.

✉

Pytania lub uwagi?

Napisz do nas: chętnie odpowiemy. Możesz też skorzystać z formularza projektu.

Przejdź do formularza projektu

Dokument projektowy do omówienia z mieszkańcami i zarządem wspólnoty: realizacja jest możliwa dopiero po niezbędnych zatwierdzeniach.