Files
buryan-infra/ops/hub-core/CATALOG.md
T
buryan-agent df0bd06485 Единый каталог: содержимое библиотек становится карточками ядра
library_sync.py собирает фильмы и сериалы (Jellyfin), документы (Paperless),
книги (Calibre), альбомы (Navidrome), фотоальбомы (Immich) и заводит на них
карточки в ядре. Запуск 04:15.

Проверено самопроверкой без сервисов: создаются 2 карточки, поиск их
находит, после проверки удалены. Реальный прогон: пять источников без
ошибок, карточек 0 (библиотеки пусты).

Ловушки: albumName в Immich требует кавычек (SQL через файл), русский
поисковый запрос требует urlencode.
2026-10-19 20:20:41 +03:00

2.1 KiB

Единый каталог

Содержимое всех библиотек становится карточками ядра — после этого поиск и история работают одинаково для любого сервиса.

Что синхронизируется

Сервис Вид карточки Ключ
Jellyfin фильм, сериал jellyfin:<id>
Paperless документ paperless:<id>
Calibre книга calibre:<id>
Navidrome музыка (альбом) navidrome:<id>
Immich фотоальбом immich:<id>

Запуск: 04:15 ежедневно (/etc/cron.d/hub-catalog), лог /var/log/hub-catalog.log.

Почему это важно

Раньше в ядре были только события: «что-то скачалось». Теперь в ядре лежит сам контент: можно найти книгу, фильм или документ, увидеть его историю и связать с другими карточками.

Проверено

Самопроверка (--selftest) без обращения к сервисам:

jellyfin: 1 карточек, calibre: 1 карточек
создано: 2, ошибок: 0
поиск видит: 2

То есть карточки создаются и находятся поиском. После проверки тестовые карточки удалены.

Реальный прогон: все пять источников отвечают без ошибок, карточек 0 — библиотеки пусты. Это ожидаемо и отличается от «сломалось».

Ловушки

  • В Immich колонка называется albumName — требует кавычек, поэтому SQL передаётся файлом, а не строкой в аргументах (иначе кавычки съедаются).
  • Поиск по-русски в URL нужно кодировать (urllib.parse.urlencode), иначе ядро не находит.