Files
buryan-infra/ops/audit/STRATEGY.md
buryan-agent 9d0f51f9b2 Portainer, Linkding, аудит спринта и стратегия автоматизации
Portainer запущен (порт 9443 был занят SSH-туннелем GitHub — оставлен только
9000), API-ключ создан через /api/users/1/tokens, интеграция подключена.
Linkding: DRF-токен не работает при auth-proxy, но API отвечает на заголовок
X-Forwarded-User — добавлен сенсор закладок.

Итог дня: 37 интеграций, 255 сущностей, 104 трекера устройств.

Добавлены два документа: полный аудит спринта (что сделано, что нет и почему,
8 технических открытий) и стратегия автоматизации — 5 принципов, три слоя
архитектуры, 8 фаз, метрики и риски.
2026-10-20 20:18:27 +03:00

14 KiB
Raw Permalink Blame History

Стратегия: от «набора сервисов» к «дому, который сам себя ведёт»

Где мы сейчас

Фундамент собран: единый вход (Authentik), единая шина (MQTT), единый инвентарь (104 устройства), единый граф контента, единый канал (Matrix), единый мозг (hub-core). Но это пока инструменты, а не поведение. Дом знает, что у него есть, но не знает, что с этим делать.

Главная задача следующего спринта — превратить «35 интеграций» в десяток сценариев, которые чувствуются каждый день.


Пять принципов

  1. Один вход, один профиль. Пользователь не должен думать, в каком сервисе он авторизуется. Authentik уже даёт это — довести до конца: один клик → всё.
  2. Дом реагирует, а не спрашивает. Каждое действие должно быть автоматическим по умолчанию; ручное — исключение.
  3. Один канал общения. Matrix — единственное место, где приходят вопросы, отчёты и предложения. Не 10 приложений, а одно.
  4. Человек решает, машина делает. Автоматизация предлагает и исполняет рутину; на человеке — только выбор из 2-3 вариантов.
  5. Всё измеряется. Если сценарий не экономит время или не радует — он не нужен.

Архитектура: три слоя

┌──────────────────────────────────────────────────────────────┐
│  СЛОЙ РЕШЕНИЙ — hub-core (мозг)                              │
│  граф контента · профили · правила · рекомендации · история   │
└───────────────▲──────────────────────────────┬───────────────┘
                │ события                       │ команды
┌───────────────┴──────────────┐  ┌────────────▼───────────────┐
│  СЛОЙ СОБЫТИЙ — MQTT + hub    │  │  СЛОЙ ИСПОЛНЕНИЯ — HA      │
│  кто пришёл · что включили ·  │  │  свет · ТВ · колонки ·      │
│  что скачалось · что вышло    │  │  роутер · сервисы           │
└───────────────────────────────┘  └────────────────────────────┘

Сегодня средний слой почти пуст: HA знает про устройства, но hub-core не знает, что происходит в доме. Первый шаг — наполнить событиями.


Фаза 1. Событийная шина (1–2 недели)

Цель: каждое значимое изменение в доме становится событием в hub-core.

Что публикуем в MQTT/hub:

Событие Источник Что даёт
presence.arrived / left ping + роутер «кто дома»
media.played / paused Cast, Hisense, колонки понимание, что смотрят
download.completed qBittorrent, Radarr «фильм готов»
release.new Radarr/Sonarr календарь «вышел эпизод»
service.down / up Kuma, ping здоровье
tv.on / tv.off Hisense, Cast контекст
music.liked Navidrome, Яндекс вкусы
photo.uploaded Immich память

Результат: в hub-core появляется журнал жизни дома. Это топливо для всех следующих фаз.


Фаза 2. Сценарии «дом сам» (2–3 недели)

Конкретные, ощутимые вещи. Не «умный дом», а бытовые мелочи.

Утро

  • 07:00 — колонка на кухне: погода, пробки, «сегодня выходит новый эпизод сериала X», напоминание про доставку.
  • Свет в коридоре 30% на 5 минут (если кто-то встал ночью).
  • Кофеварка/чайник — если есть умная розетка.

Вечер

  • Закат − 30 мин: тёплый свет в гостиной, шторы (если есть).
  • 22:30 — «пора спать»: приглушить свет, выключить ТВ, проверить, закрыты ли окна (датчики), поставить будильник.
  • Ночью: свет в туалет 10% по датчику движения.

Кино

  • «Смотрим кино» → ТВ включается, свет 20%, звук на ресивере, шторы.
  • Пауза фильма → свет 60%.
  • Конец → свет 100%, ТВ выкл через 5 мин.

Уборка и порядок

  • Робот-пылесос (Dreame) — по расписанию, когда никого нет дома.
  • Увлажнитель — по влажности, не по таймеру.
  • «Гости» → свет ярче, музыка тише, гостевой Wi-Fi.

Уезжаем / возвращаемся

  • Все ушли → свет выкл, климат эконом, робот стартует, уведомление.
  • Кто-то вернулся → свет 40% в прихожей, музыка приветствия.

Результат: 10–12 сценариев, которые не надо трогать руками.


Фаза 3. Контент, который сам себя предлагает (2 недели)

У нас 1791 карточка и 1414 связей — это готовая рекомендательная система, но она живёт в боте, а не в жизни.

  • «Что посмотреть сегодня» — каждый вечер в 19:00 бот присылает 3 варианта с учётом вкусов всех домашних и того, что уже скачано.
  • «Вышел новый эпизод» — уведомление в Matrix + автоматическое скачивание (уже есть).
  • Совместный плейлист — вкусы из Navidrome и Яндекса объединяются; колонка играет «наше».
  • Книга + фильм — «дочитываешь X — посмотри экранизацию Y».
  • Календарь выхода — премьеры по любимым актёрам/режиссёрам.

Ключевая идея: контент должен приходить, а не искаться.


Фаза 4. Голос как основной интерфейс (2–3 недели)

  • Озвучка событий: «фильм скачался», «гости пришли», «стиралка закончила».
  • Голосовые команды через Алису → hub-core: «что посмотреть», «включи кино», «сколько места на диске».
  • Сценарии голосом: «я ухожу», «доброе утро», «кино».
  • Утренний брифинг на колонке вместо телефона.

Фаза 5. Дом, который экономит (1–2 недели)

  • Электричество — если есть smart-розетки: сколько тратит каждый прибор, «стиралка выгоднее ночью».
  • Диски — предиктивный алерт: «через 12 дней закончится место» с готовым списком, что удалить (старые фильмы, дубли).
  • Сеть — аномалии, кто ест трафик.
  • Бэкапы — ежедневная проверка, что бэкап не пустой; отчёт раз в неделю.

Фаза 6. Безопасность и присутствие (2 недели)

  • Кто дома — трекеры уже есть; добавить «у каждого свои правила».
  • Гости — гостевой Wi-Fi, ограничение времени.
  • Уведомления — «дверь открылась, когда все ушли».
  • Камеры — Frigate отложен, но архитектуру заложить: события → MQTT → Matrix с превью.

Фаза 7. Личное пространство каждого (2 недели)

Сейчас всё общее. У каждого должно быть своё:

  • своя музыка (уже: 7 библиотек Navidrome),
  • свои рекомендации (граф учитывает оценки),
  • свои напоминания,
  • своя лента «что нового» — только то, что интересно именно ему.

Через Matrix-бота: у каждого свой личный чат с домом.


Фаза 8. Обслуживание без человека (постоянно)

  • Автообновления контейнеров с откатом.
  • Проверка сертификатов Let's Encrypt.
  • Ротация логов и бэкапов.
  • «Здоровье»: если сервис упал — попытка поднять, потом уведомление.
  • Ежемесячный отчёт: что упало, что починилось, что занимает место.

Что нужно добавить технически

Компонент Зачем Приоритет
Событийная шина в hub-core журнал жизни дома 🔴 высокий
Движок правил (если X → Y) сценарии в конфиге, а не в коде 🔴 высокий
Scheduler «в 7:00», «за 30 мин до заката» 🔴 высокий
Шаблоны уведомлений единый формат сообщений 🟡 средний
Профили пользователей личные ленты и правила 🟡 средний
Zigbee2MQTT датчики движения/температуры/двери 🟡 средний
Умные розетки энергия, кофеварка, свет 🟡 средний
Голосовой шлюз Алиса → hub-core 🟡 средний
Камеры (Frigate) безопасность 🟢 позже

Метрики: как понять, что стало лучше

  1. Сколько действий осталось вручную — цель: −80% за 3 месяца.
  2. Сколько сообщений в день — цель: ≤3 полезных, без шума.
  3. Время на рутину (кино, музыка, поиск фильма) — цель: −50%.
  4. Сбои без внимания — цель: 0.
  5. «Вау»-моменты — сценарии, которые замечаешь и радуешься.

Риски и как снимаем

Риск Решение
Слишком много уведомлений → раздражение лимит 3/день, приоритизация, «тихие часы»
Сценарий срабатывает не вовремя «сухой прогон» 3 дня, лог в Matrix
Поломка ломает весь дом каждый сценарий изолирован, откат в один клик
Слежка за домочадцами присутствие — только грубое (дома/нет), без геолокации
Зависимость от одного сервера бэкапы + ежедневная проверка

С чего начать в понедельник

  1. Событийная шина — 2 дня. Без неё остальное вслепую.
  2. Три первых сценария: «утро», «кино», «все ушли» — 3 дня.
  3. Движок правил — 3 дня, чтобы дальше добавлять сценарии без кода.
  4. Пилот на одного человека (владелец) — неделя обратной связи.
  5. Расширение на семью — после того, как пилот не бесит.

Главная мысль

У нас уже есть все детали. Не хватает поведения. Дом сейчас — это швейцарский нож, разложенный на столе. Задача спринта — собрать его, положить в карман и научиться им пользоваться не думая.