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

63 lines
3.3 KiB
Markdown

# Каталог книг: сервис и статистика (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).