docs: add legal review guide

docs/README.md

@@ -11,6 +11,8 @@
 - [Бланк юридической проверки relevance set v1](product/relevance-set-v1-legal-review.md) —
   независимая верификация запросов и кодов актов; включает отдельные Excel-файлы
   для русского и кыргызского языков.
+- [Инструкция для юриста](product/legal-review-instructions.pdf) — пошаговая
+  проверка запросов и кодов в ЦБД Минюста КР.
 - [Задание по нормализации документов](product/minjust-document-normalization-agent-task.md) —
   требования и критерии приёмки нормализатора ЦБД Минюста КР.
 

docs/product/legal-review-instructions.md

@@ -0,0 +1,119 @@
+# Инструкция для юридической проверки relevance set v1
+
+Эта инструкция нужна для проверки того, какие нормативные акты действительно
+отвечают на реальные вопросы пользователей. Она не требует программирования,
+доступа к локальной базе или знания внутреннего устройства проекта.
+
+## Что нужно открыть
+
+Для русскоязычных запросов используйте файл
+`relevance-set-v1-legal-review-ru.xlsx` и официальный поиск ЦБД Минюста КР:
+
+<https://cbd.minjust.gov.kg/search-docs/ru>
+
+Кыргызский файл предназначен для отдельного проверяющего, владеющего кыргызским
+языком. Не нужно заполнять его, если вы не можете уверенно оценить смысл
+кыргызских запросов и актов.
+
+## Что означают столбцы Excel
+
+- **Запрос** — вопрос, который мог задать пользователь.
+- **Предварительные коды** — первичная техническая выборка. Она не является
+  юридическим выводом и может содержать ошибки или неполный список.
+- **Подтверждённые коды** — итог вашей проверки. Здесь указываются все акты,
+  прямо отвечающие на вопрос.
+- **Результат и комментарий** — напишите `подтверждено`, `исправлено` или
+  `спорно`, а при исправлении или споре кратко объясните причину.
+
+## Как проверить одну строку
+
+1. Прочитайте запрос и предварительные коды, но не считайте их правильными
+   заранее.
+2. Откройте официальный поиск и введите запрос или его ключевые слова. Начните
+   с короткой естественной формулировки; при необходимости используйте поиск
+   по наименованию, тексту, номеру документа, виду документа или органу.
+3. Для вопроса о действующем правиле включите в поиске опцию исключения
+   недействующих документов. Если вопрос касается исторической редакции,
+   наоборот проверьте нужную дату и редакцию.
+4. Откройте карточку каждого подходящего документа. Проверьте название,
+   реквизиты, статус, дату и текст нормы. Совпадения отдельных слов или
+   близкой темы недостаточно.
+5. Внесите в «Подтверждённые коды» все акты, которые прямо отвечают на вопрос.
+   Несколько кодов записывайте через запятую.
+6. Запишите результат. Если предварительный список не менялся, укажите
+   `подтверждено`. Если что-то добавили или исключили — `исправлено` и причину.
+
+## Где взять код документа
+
+После открытия карточки посмотрите на адресную строку браузера. Адрес обычно
+имеет вид:
+
+`https://cbd.minjust.gov.kg/<код-документа>/edition/<номер-редакции>/ru`
+
+В Excel нужно перенести **код документа** — часть адреса между доменом сайта и
+`/edition/`. Номер после `/edition/` — это номер редакции, его в столбец кодов
+не записывают. Копируйте код точно, включая дефисы, если они есть.
+
+Если адресная строка не видна или формат отличается, откройте в карточке
+раздел «Реквизиты», скопируйте ссылку на документ в комментарий и укажите его
+название, дату и номер. Техническая команда затем сопоставит карточку с кодом.
+
+## Если код или документ не удалось найти
+
+Не подбирайте код наугад и не оставляйте предварительный код как подтверждённый.
+В «Результат и комментарий» напишите `спорно — код не найден`, затем добавьте:
+
+- точный текст запроса, который вводили;
+- ссылку на страницу поиска или карточку, если она открылась;
+- название, дату и номер акта, если они известны;
+- почему акт кажется релевантным или почему результаты не позволяют решить.
+
+Такую строку передают на повторный поиск технической команде и второму юристу.
+Она не попадёт в итоговый набор, пока вопрос не будет решён.
+
+## Когда акт считать релевантным
+
+Включайте акт, если его текст или реквизиты прямо отвечают на информационную
+потребность запроса. Например, для вопроса о порядке регистрации нужны акты,
+которые устанавливают этот порядок или обязательные условия регистрации.
+
+Не включайте акт только потому, что он:
+
+- содержит отдельные слова из запроса;
+- упоминает нужную тему без ответа на вопрос;
+- относится к смежной, но другой процедуре;
+- утратил силу, если пользователь ищет действующее правило.
+
+Если у вопроса несколько самостоятельных правильных источников, внесите все
+релевантные коды, а не только первый найденный документ.
+
+## Пример заполнения
+
+Лист «Пример заполнения» в русскоязычном Excel показывает только формат записи.
+В нём использованы тестовый запрос и условный код; это не юридический вывод и
+не образец правильного ответа для реального вопроса.
+
+## Передача результата
+
+Сохраните Excel под новым именем, например
+`relevance-set-v1-legal-review-ru-ivanova.xlsx`, и не меняйте ID запросов,
+сам текст запросов и предварительные коды. Передайте файл вместе с вопросами,
+помеченными как `спорно`.
+
+Для независимой проверки другой юрист должен заново просмотреть все строки или
+как минимум все исправленные и спорные строки. Только согласованный результат
+переносится в итоговый набор для оценки поиска.
+
+## Полезные ссылки
+
+- Официальный поиск ЦБД Минюста КР: <https://cbd.minjust.gov.kg/search-docs/ru>
+- Руководство пользователя и описание поиска ЦБД:
+  <https://cbd.minjust.gov.kg/synopsis/ru>
+- Государственный реестр НПА: <https://cbd.minjust.gov.kg/notional-register-npa/ru>
+
+Не добавляйте в Excel персональные данные, закрытые документы или логины и
+пароли. Для проверки достаточно публичной правовой информации ЦБД.
+
+---
+
+Акылдаш · Telegram-бот v0.2.2 · Backend v0.7.1 · Frontend — не создан