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