Files
buryan-infra/ops/hub-core/CONNECTORS.md
T
buryan-agent 67bc0a00a7 Коннекторы: 10 источников, включая Kuma, Calibre, Navidrome, Immich, Paperless
Добавлены источники из баз сервисов: Paperless (API), Calibre (metadata.db
через python3), Navidrome (sqlite), Immich (immich_db), Uptime Kuma (kuma.db).

Первый прогон дал 57 событий от Kuma, второй — 0: идемпотентность работает.
В ядре 60 карточек и 60 событий.

По пути: база Kuma лежит не в docker volume, а в /opt/network-lxc/uptime/data;
функции источников должны возвращать (список, ошибка) — две штуки отдавали
просто список, из-за чего падали с unpacking error.
2026-10-19 18:41:47 +03:00

39 lines
1.7 KiB
Markdown

# Подключение сервисов к шине событий
Опрос раз в 10 минут (cron), состояние в `/var/lib/hub-core/state.json`,
поэтому каждое изменение даёт ровно одно событие и повторный запуск
ничего не дублирует.
## Источники (10)
| Сервис | Что забираем | Событие |
|---|---|---|
| Sonarr | история: grabbed, imported | `media.grabbed`, `media.imported` |
| Radarr | история | то же |
| Seerr | заявки | `media.requested` |
| Jellyfin | недавно добавленное | `media.added` |
| Alertmanager | активные тревоги | `service.alert` |
| Paperless | документы | `document.added` |
| Calibre | книги (metadata.db) | `book.added` |
| Navidrome | альбомы (sqlite) | `music.added` |
| Immich | альбомы (Postgres) | `photo.album` |
| Uptime Kuma | активные мониторы (kuma.db) | `monitor.active` |
## Особенности
* Uptime Kuma: база в контейнере — `/opt/network-lxc/uptime/data/kuma.db`
(не в docker volume, как можно ожидать).
* Calibre: читаем `metadata.db` через python3 внутри CT 111.
* Immich: запрос к `immich_db` на общем PostgreSQL.
* Frigate и Home Assistant пока не подключены (нет Frigate, HA требует API).
## Проверка
```
set -a; . /etc/hub-core/connectors.env; set +a
python3 /opt/hub-core/connectors.py
```
Первый прогон дал 57 событий (мониторы Kuma), второй — 0: идемпотентно.
В ядре 60 карточек и 60 событий.