СЕРВИС КАТАЛОГА: 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). МОИ ОШИБКИ: путь к каталогу не совпал (нули на странице); обновлённый файл не попал в контейнер, а я собрал образ из старого; проверка входа заголовком не проходит — нужна настоящая сессия.
63 lines
3.3 KiB
Markdown
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).
|