CLARYEL PerimetroПроєкт для обговорення
Технічний документ · 3 з 3

Програмне рішення

Home Assistant на локальному сервері: один застосунок для будь-якого телефону, планшета чи браузера, обмежені права та сповіщення, які доходять, навіть коли телефон у беззвучному режимі.

Home AssistantAndroid · iPhone · браузерПрава за ролямиКритичні сповіщенняУсе локально, зашифровано, без хмари
1

Що ми обрали з нашого стеку і чому

З уже працюючого на нашому локальному сервері стеку потрібно лише кілька елементів. Решта — ШІ-аналіз, зашифрований архів, записи — залишаються поза Home Assistant.

  1. 1

    Home Assistant

    Єдиний центр системи: отримує події периметра, керує користувачами та їхніми правами, надсилає сповіщення на телефони. Вільне програмне забезпечення, працює локально на нашому сервері.

  2. 2

    MQTT (Mosquitto)

    Локальний канал повідомлень між польовими вузлами (ESP32), ШІ-аналізом і Home Assistant. Події подорожують короткими текстовими повідомленнями, без зображень.

  3. 3

    NUT (стан UPS)

    Передає стан джерела безперебійного живлення в Home Assistant: відключення електрики або розряд акумулятора одразу стає технічним сповіщенням.

  4. 4

    Застосунок Home Assistant Companion

    Офіційний клієнт для Android та iPhone/iPad: через нього надходять сповіщення і відкривається схвалена панель.

  5. 5

    WireGuard

    Захищений канал, уже передбачений проєктом для зв'язку: за потреби дає змогу користуватися застосунком і поза будівлею, без хмарних підписок.

Залишається поза Home Assistant: ШІ-аналіз, зашифрований архів і записи залишаються на сервері, і застосунок не може їх показати.
2

Схема: від сервера до клієнтів, ролі та права

Польова точка

Камера або модулі Wi-Fi CSI, із сигналізацією

Локальний сервер

ШІ-аналіз, шифрування, архів, UPS і резервне копіювання даних

Home Assistant

Події, користувачі, права, сповіщення

Клієнти

Один застосунок або браузер

  • Android
  • iPhone / iPad
  • Браузер (комп'ютер)
  • Планшет

Ролі та права

Кожен бачить лише схвалене

  • Технічний адміністратор
  • Призначена особа
  • Мешканець

Home Assistant отримує лише подію (текст, час, ділянка огородження): жодних фото чи відео. Чого немає в Home Assistant, того не видно в застосунку.

3

Один клієнт для будь-якого пристрою

Клієнт — це офіційний застосунок Home Assistant Companion або просто браузер: обирайте те, що маєте.

  • Android

    Застосунок Home Assistant Companion із магазину застосунків: сповіщення, схвалена панель, швидкі дії.

  • iPhone та iPad

    Застосунок Home Assistant Companion для iOS та iPadOS: сповіщення, зокрема критичні, і схвалена панель.

  • Браузер на комп'ютері

    Достатньо відкрити адресу Home Assistant: без встановлення.

  • Планшет

    Застосунок або браузер; із виділеним користувачем може лишатися на стіні як постійна панель, наприклад, у вході.

Доступ відбувається в локальній мережі будівлі або, поза будівлею, через захищений канал WireGuard. Підписка на Home Assistant Cloud не потрібна.
4

Доступ з обмеженими правами

Усі входять зі своїм іменем користувача й паролем (з двофакторною автентифікацією, якщо її ввімкнено) і бачать лише те, що схвалено для їхньої ролі. Наведені нижче ролі — пропозиція для обговорення.

  • Адміністратор Home Assistant

    Технічний адміністратор

    Налаштовує систему, користувачів і автоматизації. Мало облікових записів, із двофакторною автентифікацією; доступ можна дозволити лише з локальної мережі.

  • Користувач без прав адміністратора

    Призначена особа

    Отримує тривоги з кнопками дій для підтвердження події. Для зображень в архіві діє процедура, зарезервована для призначених осіб, із журналом доступу.

  • Користувач без прав адміністратора

    Мешканець

    Отримує сповіщення (лише текст) і бачить схвалену панель зі станом системи. Без доступу до камери, архіву чи налаштувань.

Хто що можеТехнічний адміністраторПризначена особаМешканець
Отримувати тривожні сповіщення
Бачити стан системи (схвалена панель)
Підтверджувати подію кнопками дій
Бачити зображення в архіві (лише призначені особи, з журналом)
Керувати списком отримувачів і налаштуваннями сповіщень
Змінювати налаштування, користувачів і автоматизації

Як досягається обмеження

  • Користувачі без прав адміністратора не мають доступу до Налаштувань і не можуть керувати користувачами, пристроями, автоматизаціями та панелями.
  • Кожну панель можна зарезервувати за адміністраторами; мешканцям призначається окрема схвалена панель.
  • Для кожного користувача доступ можна дозволити лише з локальної мережі, а двофакторну автентифікацію — увімкнути.
  • Кожен пристрій можна відключити, видаливши його токен доступу з профілю; обліковий запис користувача можна вимкнути.
  • Найсильніша межа — конструктивна: Home Assistant не пропонує в інтерфейсі дозволів на рівні пристроїв, тому туди потрапляє лише схвалена інформація (подія тривоги, стан системи, стан UPS). Зображення й архів залишаються поза ним.
5

Сповіщення, які доходять, навіть коли телефон у беззвучному режимі

У разі небезпечного порушення периметра сповіщення надсилається як критичне: за описаного нижче налаштування воно дзвонить і тоді, коли телефон у беззвучному режимі та з увімкненим «Не турбувати», тобто коли всі вхідні виклики заблоковано (наприклад, уночі).

Екран блокування
03:12
Телефон у беззвучному режимі«Не турбувати» активне
ТРИВОГАКритичне сповіщення

Увага! На контрольованій ділянці огородження виявлено людину.

iPhone
Екран блокування
03:12
Телефон у беззвучному режимі«Не турбувати» активне
ТРИВОГАalarm_stream

Увага! На контрольованій ділянці огородження виявлено людину.

Android

Приклад налаштування (з офіційної документації Home Assistant Companion)

iPhone та iPad: критичне сповіщення

  • Критичні сповіщення (Critical Alerts) в iOS відображаються вгорі екрана блокування над усіма іншими сповіщеннями та звучать навіть з увімкненим «Не турбувати» або з iPhone у беззвучному режимі.
  • Крім того, вони можуть перевищувати ліміти частоти сповіщень застосунку.

1× Один раз: у налаштуваннях iOS для застосунку Home Assistant дозвольте сповіщення, зокрема критичні.

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

Android: високий пріоритет і канал тривоги

  • З високим пріоритетом і часом життя 0 сповіщення надходить одразу, навіть якщо телефон нерухомий або його екран давно вимкнений.
  • Використовуючи аудіопотік «будильник» (alarm stream), телефон дзвонить і в беззвучному режимі чи режимі вібрації.

1× Один раз: у системних налаштуваннях застосунку відкрийте канал тривоги й дозвольте йому обходити «Не турбувати» (за замовчуванням він його не обходить).

data:
  ttl: 0
  priority: high
  channel: alarm_stream

На що слід звернути увагу

  • Сповіщення розроблено так, щоб воно доходило й у беззвучному режимі, але абсолютну доставку гарантувати неможливо: телефон має бути ввімкнений і досяжний (мобільні дані або Wi-Fi), а одноразове налаштування потрібно виконати на кожному телефоні.
  • Повідомлення містить лише текст, без фото, відео чи персональних даних.
  • Зазвичай надсилання на телефон проходить через інфраструктуру push-сповіщень Apple або Google, як і для будь-якого застосунку. У локальній мережі будівлі доступна також локальна доставка (Local Push) через WebSocket, повз Apple чи Google.
  • Радимо періодичне контрольне сповіщення, щоб вчасно помітити, якщо якийсь телефон перестав отримувати сповіщення.
6

Не лише периметр: інші важливі сповіщення

Цим самим каналом можуть надходити й інші важливі повідомлення з різними рівнями терміновості. Вибір мелодії та пріоритету робиться для кожного рівня.

  • Критичне

    Небезпечне порушення периметра: дзвонить завжди, навіть коли телефон у беззвучному режимі.

  • Термінове (технічне)

    Відключення електрики або розряд акумулятора UPS, втрачено зв'язок із польовою точкою, сервер недоступний.

  • Інформаційне

    Аномальна температура чи вологість або протікання води в боксі, інші повідомлення, узгоджені з ОСББ. Може лишатися беззвучним.

В iOS рівень «критичний» проходить навіть повз беззвучний режим, «time-sensitive» (термінове) обходить режими фокусування, «пасивне» не вмикає навіть екран.

Усе локально, зашифровано, без хмари

Аналіз, архів і доступ залишаються на локальному сервері, у зашифрованому вигляді та без хмарних сервісів. У разі тривоги доступ до архіву негайно закривається, а записи події захищено від змін і видалення, як описано в проєкті.

✉

Є запитання чи зауваження?

Напишіть нам: ми охоче відповімо. Також можна скористатися формою проєкту.

Перейти до форми проєкту

Проєктний документ для обговорення з мешканцями та правлінням ОСББ: реалізація можлива лише після необхідних погоджень.