diff --git a/docs/FINAL-REPORT.md b/docs/FINAL-REPORT.md new file mode 100644 index 0000000..32b7266 --- /dev/null +++ b/docs/FINAL-REPORT.md @@ -0,0 +1,130 @@ +# Buryan Hub: итог спринта + +Спринт по карт-бланшу: интеграции, автоматика, наблюдаемость. +Ниже — что сделано, что проверено и что осталось. + +--- + +## 1. Что появилось + +### Ядро платформы (`hub-core`, порт 9120) + +Единая точка, где сходятся события всех сервисов. + +| Возможность | Проверка | +|---|---| +| Шина событий `POST /event` | 10 источников, 87 событий | +| Карточки и связи `POST /entity`, `/link` | 73 карточки | +| Сквозной поиск `GET /search?q=` | «дюна» → карточка | +| Карточка с историей `GET /entity/{id}` | работает | +| API данных `POST /data/<коллекция>` | 11 документов, 4 коллекции | +| Экспорт `POST /export` | файлы в `data/` репозитория | +| Панель `GET /` | 8 разделов, 9 мс | +| Метрики `GET /metrics` | 27 метрик Prometheus | +| Автодействия | импорт → сканирование Jellyfin | + +### Интеграции + +| Что | Состояние | +|---|---| +| Sonarr, Radarr, Seerr, Jellyfin | события в шине | +| Navidrome, Calibre, Immich, Paperless | события + единый каталог | +| Uptime Kuma | изменения состояния мониторов | +| Home Assistant | сущности дома + REST-сенсоры Frigate | +| Frigate | развёрнут (0.18.2), MQTT настроен, в шине | +| Matrix | уведомления по маршрутам (12 маршрутов) | +| Prometheus → Grafana | цель `up`, дашборд из 9 панелей | +| Alertmanager → Matrix | тревога и закрытие доходят | + +### Боты (8 личных) + +| Качество | Результат | +|---|---| +| Понимание без LLM | **19 из 19** фраз | +| Понимание с моделью | 13 из 13 | +| Скорость | ни одной команды дольше 2.5 с | +| При падении сервиса | 0 проблемных из 9 | +| Инструкции | у каждого своя, при первом обращении | +| Доступ | шесть человек | + +### Наблюдаемость и надёжность + +| Что | Состояние | +|---|---| +| Сверка служб (03:15) | 19 служб, автоподъём, журнал | +| Сторож расписаний | 13 в порядке, 0 просрочено | +| Бэкапы с проверкой | 6 из 6 | +| Контроль хранилищ | предупреждение от 80% | +| Ротация логов | 8 недель | + +--- + +## 2. Что нашлось и было исправлено + +Самые ценные находки спринта — не новые функции, а **разорванные связи**. + +| Проблема | Последствие | Исправлено | +|---|---|---| +| **Prometheus не отправлял тревоги** (нет секции `alerting`) | все 10 правил молчали | добавлен Alertmanager, проверено end-to-end | +| **У Matrix не было heartbeat** | мониторы «down» при живых бэкапах | добавлены проверка, офсайт, тест восстановления | +| **Kuma врала о падениях** | 10 «лежащих» из 10 ложных | старые адреса, коды 3xx, мёртвые мониторы | +| **Комнаты в `bots.env` устарели** | 403 при отправке уведомлений | маршруты собираются из `dm.env` | +| **Thin pool 82%** | восстановление в lvmthin не проходит | тест переведён на `local`, добавлен контроль | +| **Разбор фраз по первому слову** | «сколько места» → статистика | подбор по фразам: 19/19 | + +--- + +## 3. Числа спринта + +``` +карточек: 73 событий: 87 +источников: 10 коллекций: 4 +задач ядра: 22 всего cron: 35 +бэкапов: 6 (все с проверкой восстановления) +маршрутов: 12 правил тревог: 16 +тестов: 4 набора (правила, LLM, скорость, падения) +``` + +Все четыре набора зелёные: 19/19, 13/13, 0 медленных, 0 проблемных. + +--- + +## 4. Что осталось и почему + +| Что | Чего не хватает | Кто может сделать | +|---|---|---| +| LLM-разбор | ключ DeepSeek/Qwen → `/etc/hub-core/llm.env` | владелец | +| Telegram userbot | `api_id`, `api_hash`, каналы | владелец | +| Камеры | RTSP-адреса (в сети камер нет) | владелец | +| MQTT в Home Assistant | включить интеграцию в UI | владелец | +| Thin pool 82% | решить судьбу снапшота `vm-115` (25 ГБ) | владелец | +| Immich/Paperless для семьи | создать учётные записи | владелец | +| Индексаторы Prowlarr | доступ к `indexers.prowlarr.com` | сеть | + +Всё остальное готово: как только появятся ключи и адреса, включается +одной командой — инструкции лежат в соответствующих документах. + +--- + +## 5. С чего начать утром + +1. Открыть панель: `https://status.buryans.ru/hub/`. +2. Блок **Задачи** — убедиться, что ночные проверки отработали. +3. Блок **Проблемы** — что нашла сверка. +4. Написать боту Инфраструктура `!gaps` — список того, что мешает. +5. Посмотреть дашборд: `http://192.168.1.113:3000/d/buryan-hub`. + +--- + +## 6. Документы + +| Документ | О чём | +|---|---| +| `docs/RUNBOOK.md` | дежурная книга: что делать при поломках | +| `docs/BACKUPS-STATUS.md` | какие бэкапы есть и что проверено | +| `docs/BOTS-ROLES.md` | зоны ответственности ботов | +| `docs/DATA-API.md` | как боты пишут данные в проект | +| `ops/hub-core/*.md` | ядро: шина, поиск, каталог, аудит, сверка | +| `ops/prometheus/*.md` | метрики, правила, тревоги | +| `ops/bots/*.md` | боты: команды, правила, скорость, устойчивость | +| `ops/frigate/*.md` | Frigate: развёртывание, камеры, поиск в сети |