Итоговый отчёт спринта
Сводка: что появилось (ядро, интеграции, боты, наблюдаемость), что нашлось и исправлено (шесть разорванных связей), числа спринта, что осталось и почему, с чего начать утром, где какая документация. Проверка перед отчётом: все службы активны, 73 карточки, 87 событий, 10 источников, 22 задачи ядра, четыре набора тестов зелёные (19/19, 13/13, 0 медленных, 0 проблемных), шесть бэкапов с проверкой.
This commit is contained in:
1 parent
fe4bd22075
commit
1692516e1d
1 file changed
+130
@@ -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: развёртывание, камеры, поиск в сети |
|
||||
Reference in new issue
Block a user