Files
buryan-infra/docs/BOOKS-LIBRARY.md
T
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

66 lines
3.5 KiB
Markdown

# Онлайн-библиотека книг (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, наблюдение, реестр обновлений.