Files
buryan-infra/docs/LIBRARY-CATALOG-SERVICE.md
root 60866cd2b6 Каталог книг: сервис со статистикой; поиск расширен (7 источников); инструкции в Matrix
СЕРВИС КАТАЛОГА: https://books.buryans.ru/catalog/ за единым входом.
  * 181 книга, 45 серий, 25 книг к поиску;
  * страницы «Обзор», «Серии», «Книги», «Что искать»;
  * API /api/summary и /health;
  * профили читателей (сейчас Полина);
  * написан на стандартной библиотеке Python — нечему ломаться.

СХЕМА: nginx /catalog/ -> oauth2-proxy-catalog :9990 -> catalog :9200.

ПОИСК РАСШИРЕН ДО 7 ИСТОЧНИКОВ: ЛитРес (цены), Open Library (ISBN),
ФантЛаб, Google Books — напрямую; archive.org, libgen, Флибуста — через
VPN-шлюз, потому что в России заблокированы. ЛитРес через VPN НЕ ходит
(блокирует зарубежные адреса). Результат: находки у 15 из 25 книг,
libgen добавил ещё совпадения.

ИНСТРУКЦИИ ОТПРАВЛЕНЫ В MATRIX в личные чаты: Akadmin — как устроено,
как проверить, где что лежит, как обновить; Полина — как войти, искать,
загружать книги. Matrix требует метод PUT (на POST вернул 405).

МОИ ОШИБКИ: путь к каталогу не совпал (нули на странице); обновлённый
файл не попал в контейнер, а я собрал образ из старого; проверка входа
заголовком не проходит — нужна настоящая сессия.
2026-10-18 20:54:17 +03:00

3.3 KiB

Каталог книг: сервис и статистика (18.10.2026)

Что сделано

Сервис каталога: https://books.buryans.ru/catalog/

Возможность Как
Каталог читателя 181 книга, 45 серий (каталог Полины)
Статистика прочитано 181, серий 45, книг к поиску 25
Состояние серий прочитано, ждём перевод, следующая доступна
Что искать 25 книг со ссылками на 11 источников
Профили разделение по читателям (Полина; можно добавить других)

Страницы: «Обзор», «Серии», «Книги», «Что искать». API: /api/summary (машиночитаемая сводка), /health.

Как устроено

nginx (books.buryans.ru/catalog/)     ← единый вход
   └── oauth2-proxy-catalog :9990      ← проверка входа
        └── catalog :9200              ← приложение каталога
             └── catalog.db            ← SQLite

Приложение написано на стандартной библиотеке Python — без внешних зависимостей, поэтому нечему ломаться при обновлениях.

Что пришлось исправить по ходу

  1. Путь к каталогу не совпал — контейнер ждал файл в одном месте, а он лежал в другом. Каталог показывал нули. Исправил путь.
  2. Обновлённый файл не попал в контейнер — я собрал образ из старого файла и удивился, что префикс не работает. Урок: сначала проверить, что код внутри контейнера, потом собирать.
  3. Заголовок X-Auth-Request-Email не подменяет вход — прокси требует настоящую сессию. Проверка «с заголовком» даёт 302, и это правильно: так и должно быть.

Расширение поиска

Источник Маршрут Почему
ЛитРес напрямую блокирует зарубежные адреса
Open Library, ФантЛаб, Google Books напрямую доступны
archive.org, libgen, Флибуста через VPN 192.168.1.161:7890 заблокированы в России

Добавление libgen дало ещё находки: «Егерь Ладов» — 4 источника, «Пепел короля» — 3.

Инструкции в Matrix

Отправлены в личные чаты:

Кому Что
Akadmin как устроено, как проверить, где что лежит, как обновить
Полина как войти, как искать, как загружать книги

Скрипт: ops/matrix/send_instructions.py (Matrix требует метод PUT, не POST — на этом я сначала ошибся и получил 405).