Files
buryan-infra/docs/BOOKS-LIBRARY.md
root a28ea95c46 Книжная библиотека: Calibre-Web Automated с автоприёмом
ТРЕБОВАНИЕ: онлайн-библиотека с загрузкой/выгрузкой, добавлением и
статистикой, плюс доставать книги из закрытых Telegram-каналов.

СДЕЛАНО (шаг 1): вместо старого calibre-web поставлен
Calibre-Web Automated.
  * загрузка через веб и через папку приёма /opt/books/ingest;
  * автоприём проверен: положил EPUB -> через минуту книга в библиотеке,
    метаданные прочитаны, папка очистилась;
  * выгрузка и чтение онлайн — в интерфейсе;
  * домен books.buryans.ru остаётся за единым входом;
  * старые контейнеры остановлены и переименованы, откат возможен.

ПРО КАТАЛОГ ИЗ JSON: приложенный файл — каталог Полины, 181 книга и 45
серий со статусами чтения. Это не файлы, а учёт чтения; его место —
отдельный слой «каталог и статистика» с профилями читателей. Заведено
задачами К-2 и К-3.

МОИ ОШИБКИ: запустил контейнер с занятым именем и погасил stderr — новый
контейнер не создался, а я не увидел; и не остановил старый контейнер,
державший порт 8083.

ДАЛЬШЕ: сервис каталога и статистики, загрузчик из Telegram (юзербот,
нужен вход по коду), интеграция с Dashy и наблюдением.
2026-10-18 19:21:15 +03:00

3.5 KiB

Онлайн-библиотека книг (18.10.2026)

Что требовалось

  1. Онлайн-библиотека: загружать и выгружать книги, добавлять.
  2. Вести статистику.
  3. Доставать книги из закрытых Telegram-каналов.

Что сделано: библиотека

Вместо старого calibre-web поставлен Calibre-Web Automated (CWA).

Возможность Как работает
Загрузка через веб кнопка загрузки в интерфейсе
Загрузка папкой папка /opt/books/ingest — книга появляется сама
Выгрузка скачивание из карточки книги
Добавление метаданные подтягиваются автоматически
Конвертация встроенная (EPUB и др.)
Чтение онлайн встроенная читалка

Как устроено

/opt/books/
├── config    — настройки и пользователи
├── library   — сама библиотека (metadata.db + файлы книг)
├── ingest    — папка приёма: положил файл — книга добавилась
└── metadata  — служебное

Проверено

  • положил EPUB в папку приёма → через минуту книга в библиотеке;
  • метаданные прочитаны (название, автор);
  • папка приёма очистилась сама;
  • домен books.buryans.ru за единым входом;
  • старые контейнеры остановлены и переименованы (calibre-web-legacy), откат возможен.

Мои ошибки в этом шаге

  1. Запустил контейнер с занятым именем и погасил вывод ошибки — новый контейнер не создался, а я этого не увидел. Урок: не скрывать stderr при создании.
  2. Не остановил старый контейнер, державший порт 8083 — новый не мог занять порт. Решилось полной остановкой старых.

Про каталог читателя (JSON Полины)

Приложенный файл — каталог прочитанного: 181 книга, 45 серий со статусами (прочитано, ждём перевод, следующая доступна и т.п.).

Это не файлы книг, а учёт чтения. Его место — отдельный слой «каталог и статистика» поверх библиотеки файлов. Запланировано отдельным сервисом, чтобы:

  • у каждого читателя был свой профиль (Полина, вы, другие);
  • видеть прогресс по сериям и что искать;
  • связывать «хочу прочитать» с поиском в Telegram.

Дальше

  1. Сервис каталога и статистики (импорт JSON, профили читателей).
  2. Загрузчик из Telegram (юзербот, безопасная схема).
  3. Интеграция: Dashy, наблюдение, реестр обновлений.