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

234 lines
14 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Стратегия: от «набора сервисов» к «дому, который сам себя ведёт»
## Где мы сейчас
Фундамент собран: единый вход (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. **Расширение на семью** — после того, как пилот не бесит.
---
## Главная мысль
У нас уже есть **все детали**. Не хватает **поведения**.
Дом сейчас — это швейцарский нож, разложенный на столе.
Задача спринта — собрать его, положить в карман и научиться им
пользоваться не думая.