Files
buryan-infra/docs/FINAL-REPORT.md
buryan-agent 1692516e1d Итоговый отчёт спринта
Сводка: что появилось (ядро, интеграции, боты, наблюдаемость), что
нашлось и исправлено (шесть разорванных связей), числа спринта, что осталось
и почему, с чего начать утром, где какая документация.

Проверка перед отчётом: все службы активны, 73 карточки, 87 событий,
10 источников, 22 задачи ядра, четыре набора тестов зелёные (19/19, 13/13,
0 медленных, 0 проблемных), шесть бэкапов с проверкой.
2026-10-19 21:30:12 +03:00

131 lines
6.9 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.
# 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: развёртывание, камеры, поиск в сети |