Skip to content

feature(lookup): добавить роутинг провайдеров по префиксу издательства - #10

Open
gman-dev-nov wants to merge 9 commits into
developfrom
feature/lookup-publisher-prefix
Open

feature(lookup): добавить роутинг провайдеров по префиксу издательства#10
gman-dev-nov wants to merge 9 commits into
developfrom
feature/lookup-publisher-prefix

Conversation

@gman-dev-nov

Copy link
Copy Markdown
Owner

Summary

  • Реестр home_library/providers/publisher_prefix.PUBLISHERS сопоставляет ISBN-префиксы с издательствами (Эксмо, АСТ, МИФ, Альпина, Азбука-Аттикус, Росмэн, Питер).
  • provider_chain_for_isbn(default_chain, isbn) ставит provider издательства первым, если он зарегистрирован.
  • Сейчас все записи provider=None — реестр как точка расширения для будущих partner-провайдеров. У большинства русских издательств нет публичного ISBN API, но реестр готов принимать новые адаптеры одной строкой без правок lookup.py.

Test plan

  • 8 тестов: match_publisher (known/dashed/unknown/empty), реестр содержит ключевые издательства, provider_chain_for_isbn (prepends/keeps default/skips when no provider), интеграция в fetch_book_by_isbn
  • Полный прогон: 187 passed

🤖 Generated with Claude Code

Уточнил обработку и выбор результатов DDG для книг Alpina, чтобы бот стабильнее восстанавливал корректные название, автора и другие метаданные в сценариях, где прежний fallback часто возвращал неполные или неточные данные.

Коммит собирает исходное улучшение и последующий lint-fix в один логический bugfix, чтобы история ветки отражала единственную пользовательскую проблему: слабое извлечение метаданных Alpina через DDG.
Добавил дополнительный путь поиска книги через Yandex и Playwright для ISBN, которые не находятся в основных источниках. Это закрывает сценарии, где обычный lookup возвращает пустой результат, хотя книга существует в открытых каталогах или поисковой выдаче.

Если автоматический поиск не находит книгу, бот теперь просит у пользователя короткую текстовую подсказку и повторяет поиск с контекстом. Такой flow снижает число тупиковых добавлений, делает поведение бота понятнее и помогает восстановить метаданные без ручного заполнения всей карточки.
Добавил полноценный экран проверки OCR-черновика после сканирования обложки и титульного листа. Пользователь может уточнить ISBN, автора и название до сохранения, а бот показывает промежуточную карточку книги вместо немедленного перехода к сохранению или поиску.

Это уменьшает число ошибок после OCR, делает сценарий добавления книги управляемым и готовит данные к дальнейшему обогащению метаданными только после того, как пользователь подтвердил базовые поля.
…авок

Разделил подтверждение OCR-черновика на два осознанных действия: мгновенное добавление книги по подтвержденным данным и отдельный поиск внешних метаданных. Это ускоряет быстрый сценарий добавления и убирает лишние внешние запросы, когда OCR уже дал достаточно точный результат.

Также добавил повторный lookup из preview перед сохранением книги. Данные провайдера теперь только дополняют карточку и не перетирают вручную подтвержденные ISBN, автора и название, поэтому пользователь не теряет свои исправления после OCR.
Добавил в MEMORY.md рабочие договоренности по разнесению больших наборов изменений на тематические ветки, атомарности коммитов и формату commit message. Это нужно, чтобы новые правила не остались только в обсуждении и использовались как постоянная часть проектной памяти.

Отдельно зафиксировал ожидание к body коммита и PR: человеческое объяснение того, что изменилось, какую проблему это решает и зачем выбран именно такой способ реализации.
Усилил общий парсер поисковой выдачи и Yandex fallback для кейсов, где книга видна человеку в поиске, но бот теряет автора или возвращает усеченное название. Добавлен разбор формата 'Автор: Название', более аккуратный выбор полного title вместо обрезанных вариантов и добор метаданных с верхних внешних страниц выдачи.

Это нужно для проблемных ISBN вроде 9785002143382, где поисковик уже показывает релевантную книгу, но прежние эвристики отдавали неполные или шумные данные. В коммит также входят регрессионные тесты и отладочный Playwright-скрипт для живой проверки Yandex path.
Добавил новый Playwright fallback по книжным сайтам для ISBN, которые не удается стабильно добрать через каталоги и поисковики. Новый слой идет напрямую в LiveLib, MyBook и Labirint, пытается вытащить структурированные title, author и ссылку на карточку книги, а затем подключается в lookup-цепочку до DuckDuckGo.

Это нужно как последний шанс для кейсов, где книга существует на книжных сайтах и находится человеком вручную, но обычные провайдеры не возвращают понятный результат. Для текущих проблемных ISBN живой прогон уже дает корректную карточку через MyBook или Labirint, а в тестах зафиксирован порядок fallback и разбор HTML этих сайтов.
Файл .bot.pid — это рантайм-артефакт скрипта запуска бота
(хранит PID процесса для останова). Он постоянно мелькает в
git status и не должен попадать в индекс.
Реестр home_library/providers/publisher_prefix.PUBLISHERS теперь
сопоставляет ISBN-префикс с издательством (Эксмо, АСТ, МИФ,
Альпина, Азбука-Аттикус, Росмэн, Питер). Функция
provider_chain_for_isbn(default_chain, isbn) ставит provider
издательства первым, если он зарегистрирован.

Сейчас все записи реестра содержат provider=None, потому что у
большинства русских издательств нет открытого ISBN-API. Реестр
нужен как точка расширения: добавить partner-провайдер можно
одной строкой без правок lookup.py. Заодно — это документация
по тому, какие префиксы принадлежат каким издательствам.

Реализация по TDD: 8 тестов на match_publisher,
provider_chain_for_isbn и интеграцию в fetch_book_by_isbn
(включая happy path с подменой PUBLISHERS через monkeypatch и
проверкой, что отсутствие provider не меняет порядок).
@chatgpt-codex-connector

Copy link
Copy Markdown

You have reached your Codex usage limits for code reviews. You can see your limits in the Codex usage dashboard.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant