Files
buryan-infra/docs/SPRINT-STATUS.md
buryan-agent 5442b6beb3 Гигиена: ротация логов, бэкап данных ботов, автообновление панели
logrotate для hub-*.log (8 недель), бэкап /var/lib/hub-bots в
/mnt/backups/hub-bots (02:45, ротация 14), панель обновляется раз в минуту.

Статус спринта переписан: что работает, что нашлось по пути (ghcr, устаревшие
комнаты, ложные падения Kuma, сериализация дат, DSN в systemd, SQL_ASCII),
что ждёт владельца и как проверить.
2026-10-19 20:19:22 +03:00

105 lines
4.7 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.
# Статус спринта (19–20.10.2026)
Спринт по карт-бланшу: интеграции, автоматика, наблюдаемость.
Всё, что ниже — проверено на живой системе.
---
## Работает
### Ядро (hub-core, порт 9120)
| Что | Состояние |
|---|---|
| База `hub_core` в PostgreSQL (CT 151) | 66 карточек, 68 событий |
| Шина событий `POST /event` | 12 источников |
| Сквозной поиск `GET /search?q=` | проверен |
| Карточка `GET /entity/{id}` | карточка + связи + история |
| API данных `POST /data/<коллекция>` | пожелания, инвентаризация, события |
| Экспорт `POST /export` | пишет в `data/` репозитория |
| Панель `GET /` | 6 блоков, автообновление раз в минуту |
| Маршрутизация уведомлений | по направлениям, 12 маршрутов |
| Автодействия | импорт → сканирование Jellyfin |
**Снаружи:** `https://status.buryans.ru/hub/` (за входом Authentik).
### Наблюдаемость
* сверка 18 служб в 03:30, автоподъём контейнеров, журнал отката;
* сверка **сообщает о проблемах** боту Инфраструктура и о восстановлении;
* бэкапы: база ядра (02:30, с проверкой восстановления) и данные ботов (02:45);
* ротация логов `hub-*.log` — 8 недель.
### Отчёты
| Отчёт | Когда |
|---|---|
| Инвентаризация «что есть» | 07:30 |
| Дайджест событий + «что есть» | 08:30 |
| Продолжить просмотр | 19:00 |
| Недельный отчёт по системе | воскресенье 20:00 |
| Экспорт данных в проект | 23:00 |
### Frigate
CT 126, 0.18.2, `healthy`, MQTT настроен, камер пока нет.
Образ получен через зеркало `ghcr.nju.edu.cn` (ghcr.io из этой сети почти
недоступен).
### Боты
8 ботов, личные переписки. Доступ у шести человек. У каждого — своя
инструкция по направлению, приходит при первом обращении.
Поиск идёт через ядро (`!s`, `!card`, `!feed`, `!export`).
### LLM
Адаптер готов к любому OpenAI-совместимому API. Проверен на заглушке:
модель выбирает инструмент, бот выполняет. Ждёт ключ.
### Telegram
Telethon 1.45, скрипт, конфиг и cron готовы. Ждёт `api_id`/`api_hash`.
---
## Что нашлось по пути (и было исправлено)
1. `ghcr.io` недоступен из сети — образ через зеркало.
2. Комнаты в `bots.env` устарели — актуальные в `dm.env` (иначе 403).
3. Kuma показывала 10 «лежащих» — семь были ложными: старые адреса
(`.111` вместо `.240`) и непринятие ответов 302.
4. `datetimes` ломали JSON в API — сериализация с `default=str`.
5. systemd разбивал DSN по пробелам — нужны кавычки.
6. База создалась в `SQL_ASCII` — пересоздана в UTF8.
---
## Ждёт владельца
| Что | Нужно |
|---|---|
| LLM | ключ DeepSeek → `/etc/hub-core/llm.env` |
| Telegram | `api_id`, `api_hash`, номер, каналы |
| Домены для камер | DNS `cam.buryans.ru` (для панели уже не нужно) |
| MQTT в Home Assistant | добавить интеграцию — Frigate появится в HA |
| Камеры | RTSP-адреса |
| Индексаторы | доступ к `indexers.prowlarr.com` |
---
## Как проверить
```
curl -s http://192.168.1.10:9120/ | head -40 # панель
curl -s http://192.168.1.10:9120/health # состояние
curl -s http://192.168.1.10:9120/search?q=дюна # поиск
curl -s http://192.168.1.10:9120/data/inventory # «что есть»
set -a; . /etc/hub-core/connectors.env; set +a
python3 /opt/hub-core/reconcile.py # сверка
python3 /opt/hub-core/connectors.py # события
python3 /opt/hub-core/inventory.py # инвентаризация
python3 /opt/hub-core/weekly.py # недельный отчёт
```