diff --git a/docs/BOOKS-LIBRARY.md b/docs/BOOKS-LIBRARY.md new file mode 100644 index 0000000..5194ea3 --- /dev/null +++ b/docs/BOOKS-LIBRARY.md @@ -0,0 +1,65 @@ +# Онлайн-библиотека книг (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, наблюдение, реестр обновлений. diff --git a/docs/TASKS.md b/docs/TASKS.md index fda2654..3574519 100644 --- a/docs/TASKS.md +++ b/docs/TASKS.md @@ -36,9 +36,10 @@ | ЗВОНКИ И МЕДИА | 8 | 4 | 1 | **3** | | СКВОЗНАЯ СВЯЗНОСТЬ | 14 | 6 | 2 | **6** | | УЛУЧШЕНИЕ СЛУЖБ | 13 | 9 | 0 | **4** | +| КНИЖНАЯ БИБЛИОТЕКА | 5 | 1 | 0 | **4** | | VPN (этапы 1–4) | 29 | 21 | 3 | **5** | | РЕЕСТР НАЙДЕННЫХ ПРОБЛЕМ | 17 | 12 | 1 | **4** | -| **ИТОГО** | **102** | **72** | **7** | **23** | +| **ИТОГО** | **107** | **73** | **7** | **27** | --- @@ -74,6 +75,7 @@ + ## 1. ЗАВЕРШИТЬ ОБНОВЛЕНИЯ @@ -159,6 +161,16 @@ | 5.9 | `openclaw` — обновить до свежей версии (нужна миграция конфигурации) | ⬜ | | 5.10 | Правила тревог на все службы | ✅ 4 группы, 7 правил, 38 служб в метриках | +## КНИЖНАЯ БИБЛИОТЕКА + +| № | Задача | Статус | +|---|---|---| +| К-1 | Calibre-Web Automated вместо старого | ✅ загрузка, выгрузка, автоприём из папки | +| К-2 | Сервис каталога и статистики чтения | ⬜ импорт JSON Полины (181 книга, 45 серий) | +| К-3 | Профили читателей | ⬜ у каждого свой каталог | +| К-4 | Загрузчик из Telegram-каналов | ⬜ юзербот, нужен вход по коду | +| К-5 | Интеграция: Dashy, наблюдение, реестр | ⬜ | + ## 6. VPN Раздел введён 17.10.2026 — по аудиту это задача первоочередная: diff --git a/ops/books/inspect.sh b/ops/books/inspect.sh new file mode 100755 index 0000000..b134484 --- /dev/null +++ b/ops/books/inspect.sh @@ -0,0 +1,34 @@ +#!/bin/bash +set -uo pipefail +CT=111 + +echo "=== 1. COMPOSE CALIBRE ===" +pct exec $CT -- bash -c 'ls /opt/ 2>/dev/null' | sed 's/^/ /' +pct exec $CT -- bash -c 'cat /opt/calibre/docker-compose.yml 2>/dev/null | head -50' | sed 's/^/ /' + +echo +echo "=== 2. ЧТО В КАТАЛОГАХ ===" +pct exec $CT -- bash -c 'ls -la /opt/calibre/ /opt/calibre-web/ 2>/dev/null | head -25' | sed 's/^/ /' + +echo +echo "=== 3. ОБРАЗ И ВЕРСИЯ ===" +pct exec $CT -- docker inspect calibre-web --format ' образ: {{.Config.Image}} + создан: {{.Created}}' 2>/dev/null +pct exec $CT -- docker exec calibre-web sh -c 'cat /app/calibre-web/__init__.py 2>/dev/null | grep -i version | head -3' 2>/dev/null | sed 's/^/ /' + +echo +echo "=== 4. МОНТИРОВАНИЯ ===" +pct exec $CT -- docker inspect calibre-web --format '{{range .Mounts}} {{.Source}} -> {{.Destination}}{{println}}{{end}}' 2>/dev/null + +echo +echo "=== 5. БАЗА КНИГ ===" +pct exec $CT -- bash -c 'find / -maxdepth 5 -name "metadata.db" 2>/dev/null | head -3' | sed 's/^/ /' +pct exec $CT -- bash -c 'find / -maxdepth 5 -name "app.db" 2>/dev/null | head -3' | sed 's/^/ /' + +echo +echo "=== 6. СКОЛЬКО КНИГ ===" +pct exec $CT -- bash -c 'docker exec calibre-web sh -c "ls /calibre-library 2>/dev/null | head -5; ls /calibre-library 2>/dev/null | wc -l" 2>/dev/null' | sed 's/^/ /' + +echo +echo "=== 7. МЕСТО ===" +pct exec $CT -- bash -c 'df -h / | tail -1' | sed 's/^/ /' diff --git a/ops/books/install-cwa.sh b/ops/books/install-cwa.sh new file mode 100755 index 0000000..8a2a98e --- /dev/null +++ b/ops/books/install-cwa.sh @@ -0,0 +1,38 @@ +#!/bin/bash +set -uo pipefail +CT=111 + +echo "=== 1. ПОЛНАЯ ОСТАНОВКА СТАРЫХ ===" +pct exec $CT -- docker stop calibre-web-legacy calibre-web-legacy2 2>&1 | sed 's/^/ /' +sleep 3 +pct exec $CT -- docker ps -a --format ' {{.Names}} | {{.Status}}' 2>/dev/null | grep -i calibre +echo " --- порт 8083 ---" +pct exec $CT -- bash -c 'ss -tlnp 2>/dev/null | grep 8083 || echo " свободен"' + +echo +echo "=== 2. УДАЛЯЮ НЕСОЗДАННЫЙ КОНТЕЙНЕР ===" +pct exec $CT -- docker rm -f calibre-web 2>&1 | sed 's/^/ /' + +echo +echo "=== 3. ЗАПУСК: ПОЛНЫЙ ВЫВОД ===" +pct exec $CT -- docker run -d --name calibre-web --restart unless-stopped \ + --security-opt apparmor=unconfined -p 8083:8083 \ + -e PUID=1000 -e PGID=1000 -e TZ=Europe/Moscow -e TRUSTED_PROXY_COUNT=1 \ + -v /opt/books/config:/config \ + -v /opt/books/library:/calibre-library \ + -v /opt/books/ingest:/cwa-book-ingest \ + crocodilestick/calibre-web-automated:latest 2>&1 | sed 's/^/ /' + +sleep 55 +echo +echo "=== 4. СОСТОЯНИЕ ===" +pct exec $CT -- docker inspect calibre-web --format ' статус: {{.State.Status}} + код: {{.State.ExitCode}} + образ: {{.Config.Image}}' 2>/dev/null +echo " --- журнал ---" +pct exec $CT -- docker logs calibre-web --tail 10 2>&1 | sed 's/^/ /' + +echo +echo "=== 5. ПРОВЕРКА ===" +echo " напрямую: $(pct exec $CT -- bash -c 'curl -s -o /dev/null -w "%{http_code}" --max-time 10 http://127.0.0.1:8083/ 2>/dev/null')" +echo " домен: $(curl -s -o /dev/null -w '%{http_code}' --max-time 12 -k https://books.buryans.ru/ 2>/dev/null)"