diff --git a/CHANGELOG.md b/CHANGELOG.md index ae18282..4369ad2 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -2,6 +2,9 @@ ## Не выпущено +- Добавлены отдельные Excel-бланки независимой юридической верификации + relevance set v1 для русского и кыргызского языков и PDF-инструкция для + юриста. - Завершён Search API v1: стабильные справочники, валидный OpenAPI, безопасная пагинация и проверка актуальных редакций в локальном OpenSearch. - Добавлено безопасное переключение alias на новую версию поискового индекса diff --git a/docs/README.md b/docs/README.md index 1fa1b81..302d49b 100644 --- a/docs/README.md +++ b/docs/README.md @@ -8,6 +8,11 @@ MVP, зависимости и спринты. - [Готовность к проектированию frontend](product/frontend-design-readiness-plan.md) — обязательные работы и критерии перехода к frontend. +- [Бланк юридической проверки relevance set v1](product/relevance-set-v1-legal-review.md) — + независимая верификация запросов и кодов актов; включает отдельные Excel-файлы + для русского и кыргызского языков. +- [Инструкция для юриста](product/legal-review-instructions.pdf) — пошаговая + проверка запросов и кодов в ЦБД Минюста КР. - [Задание по нормализации документов](product/minjust-document-normalization-agent-task.md) — требования и критерии приёмки нормализатора ЦБД Минюста КР. diff --git a/docs/product/legal-review-instructions.md b/docs/product/legal-review-instructions.md new file mode 100644 index 0000000..49060f0 --- /dev/null +++ b/docs/product/legal-review-instructions.md @@ -0,0 +1,115 @@ +# Инструкция для юридической проверки relevance set v1 + +Эта инструкция нужна для проверки того, какие нормативные акты действительно +отвечают на реальные вопросы пользователей. Она не требует программирования, +доступа к локальной базе или знания внутреннего устройства проекта. + +## Что нужно открыть + +Для русскоязычных запросов используйте файл +`relevance-set-v1-legal-review-ru.xlsx` и официальный поиск ЦБД Минюста КР: + + + +Кыргызский файл предназначен для отдельного проверяющего, владеющего кыргызским +языком. Не нужно заполнять его, если вы не можете уверенно оценить смысл +кыргызских запросов и актов. + +## Что означают столбцы Excel + +- **Запрос** — вопрос, который мог задать пользователь. +- **Предварительные коды** — первичная техническая выборка. Она не является + юридическим выводом и может содержать ошибки или неполный список. +- **Подтверждённые коды** — итог вашей проверки. Здесь указываются все акты, + прямо отвечающие на вопрос. +- **Результат и комментарий** — напишите `подтверждено`, `исправлено` или + `спорно`, а при исправлении или споре кратко объясните причину. + +## Как проверить одну строку + +1. Прочитайте запрос и предварительные коды, но не считайте их правильными + заранее. +2. Откройте официальный поиск и введите запрос или его ключевые слова. Начните + с короткой естественной формулировки; при необходимости используйте поиск + по наименованию, тексту, номеру документа, виду документа или органу. +3. Для вопроса о действующем правиле включите в поиске опцию исключения + недействующих документов. Если вопрос касается исторической редакции, + наоборот проверьте нужную дату и редакцию. +4. Откройте карточку каждого подходящего документа. Проверьте название, + реквизиты, статус, дату и текст нормы. Совпадения отдельных слов или + близкой темы недостаточно. +5. Внесите в «Подтверждённые коды» все акты, которые прямо отвечают на вопрос. + Несколько кодов записывайте через запятую. +6. Запишите результат. Если предварительный список не менялся, укажите + `подтверждено`. Если что-то добавили или исключили — `исправлено` и причину. + +## Где взять код документа + +После открытия карточки посмотрите на адресную строку браузера. В её пути код +документа расположен перед словом `edition`, а номер редакции — сразу после +этого слова. В Excel нужно перенести **код документа**, но не номер редакции. +Копируйте код точно, включая дефисы, если они есть. + +Если адресная строка не видна или формат отличается, откройте в карточке +раздел «Реквизиты», скопируйте ссылку на документ в комментарий и укажите его +название, дату и номер. Техническая команда затем сопоставит карточку с кодом. + +## Если код или документ не удалось найти + +Не подбирайте код наугад и не оставляйте предварительный код как подтверждённый. +В «Результат и комментарий» напишите `спорно — код не найден`, затем добавьте: + +- точный текст запроса, который вводили; +- ссылку на страницу поиска или карточку, если она открылась; +- название, дату и номер акта, если они известны; +- почему акт кажется релевантным или почему результаты не позволяют решить. + +Такую строку передают на повторный поиск технической команде и второму юристу. +Она не попадёт в итоговый набор, пока вопрос не будет решён. + +## Когда акт считать релевантным + +Включайте акт, если его текст или реквизиты прямо отвечают на информационную +потребность запроса. Например, для вопроса о порядке регистрации нужны акты, +которые устанавливают этот порядок или обязательные условия регистрации. + +Не включайте акт только потому, что он: + +- содержит отдельные слова из запроса; +- упоминает нужную тему без ответа на вопрос; +- относится к смежной, но другой процедуре; +- утратил силу, если пользователь ищет действующее правило. + +Если у вопроса несколько самостоятельных правильных источников, внесите все +релевантные коды, а не только первый найденный документ. + +## Пример заполнения + +Лист «Пример заполнения» в русскоязычном Excel показывает только формат записи. +В нём использованы тестовый запрос и условный код; это не юридический вывод и +не образец правильного ответа для реального вопроса. + +## Передача результата + +Сохраните Excel под новым именем, например +`relevance-set-v1-legal-review-ru-ivanova.xlsx`, и не меняйте ID запросов, +сам текст запросов и предварительные коды. Передайте файл вместе с вопросами, +помеченными как `спорно`. + +Для независимой проверки другой юрист должен заново просмотреть все строки или +как минимум все исправленные и спорные строки. Только согласованный результат +переносится в итоговый набор для оценки поиска. + +## Полезные ссылки + +- Официальный поиск ЦБД Минюста КР: +- Руководство пользователя и описание поиска ЦБД: + +- Государственный реестр НПА: + +Не добавляйте в Excel персональные данные, закрытые документы или логины и +пароли. Для проверки достаточно публичной правовой информации ЦБД. + +--- + +Акылдаш · Telegram-бот v0.2.2 · Backend v0.7.1 · Frontend — не создан diff --git a/docs/product/legal-review-instructions.pdf b/docs/product/legal-review-instructions.pdf new file mode 100644 index 0000000..fb0195c Binary files /dev/null and b/docs/product/legal-review-instructions.pdf differ diff --git a/docs/product/relevance-set-v1-legal-review-ky.xlsx b/docs/product/relevance-set-v1-legal-review-ky.xlsx new file mode 100644 index 0000000..0ca76bd Binary files /dev/null and b/docs/product/relevance-set-v1-legal-review-ky.xlsx differ diff --git a/docs/product/relevance-set-v1-legal-review-ru.xlsx b/docs/product/relevance-set-v1-legal-review-ru.xlsx new file mode 100644 index 0000000..57e4f2e Binary files /dev/null and b/docs/product/relevance-set-v1-legal-review-ru.xlsx differ diff --git a/docs/product/relevance-set-v1-legal-review.md b/docs/product/relevance-set-v1-legal-review.md new file mode 100644 index 0000000..28978b6 --- /dev/null +++ b/docs/product/relevance-set-v1-legal-review.md @@ -0,0 +1,93 @@ +# Юридическая верификация relevance set v1 + +**Назначение:** проверить предварительные запросы и коды актов перед фиксацией +baseline поиска. Это рабочий бланк: он не является юридическим заключением и +не должен использоваться для настройки ранжирования до завершения проверки. + +Для заполнения используйте Excel-файлы: [русский бланк](relevance-set-v1-legal-review-ru.xlsx) +с отдельным примером и [кыргызский бланк](relevance-set-v1-legal-review-ky.xlsx) +для проверки носителем кыргызского языка. + +## Как заполнить + +Для каждой строки: + +1. Проверьте запрос и каждый предварительный код по официальной ЦБД Минюста КР. +2. Внесите в «Подтверждённые коды» все действующие акты, которые напрямую + отвечают на запрос. Удалите нерелевантные предварительные коды, добавьте + пропущенные. +3. Отметьте результат: `подтверждено`, `исправлено` или `спорно`. +4. Для `исправлено` и `спорно` кратко укажите причину. + +Акт релевантен, если его текст или реквизиты прямо отвечают на потребность +запроса. Простого совпадения слов, близкой темы или упоминания другого акта +недостаточно. Для запроса о действующей норме не включайте утратившие силу +редакции. Коды указывайте как `document_code`, не ID фрагмента или редакции. + +После заполнения нужен второй независимый проверяющий. Затем согласованный +результат переносится в локальный `data/search/relevance-set-v1.json` и +используется для расчёта baseline. + +## Русский язык + +| ID | Запрос | Предварительные коды | Подтверждённые коды | Результат и комментарий | +| --- | --- | --- | --- | --- | +| ru-01 | как зарегистрировать общественное объединение | 274, 230044970 | | | +| ru-02 | как открыть ОсОО в Кыргызстане | 230044970, 667 | | | +| ru-03 | какие документы нужны для регистрации ИП | 112340, 159109 | | | +| ru-04 | как получить статус безработного | 111258, 158006, 230011260, 200832 | | | +| ru-05 | пособие по безработице | 111258, 14206 | | | +| ru-06 | алименты на ребенка | 1327, 98934 | | | +| ru-07 | отпуск по уходу за ребенком | 230021083 | | | +| ru-08 | увольнение по собственному желанию | 230021083 | | | +| ru-09 | минимальная заработная плата | 230021083, 230042095 | | | +| ru-10 | штраф за превышение скорости | 112306 | | | +| ru-11 | срок действия водительских прав | 230035520, 230021301 | | | +| ru-12 | как оформить наследство | 5 | | | +| ru-13 | регистрация права собственности на квартиру | 160, 230032352 | | | +| ru-14 | можно ли обрабатывать персональные данные без согласия | 230029914, 230030911 | | | +| ru-15 | срок ответа на обращение гражданина | 202100 | | | +| ru-16 | доступ к публичной информации | 230009705 | | | +| ru-17 | порядок проведения мирного собрания | 203664 | | | +| ru-18 | как зарегистрировать брак | 1327, 112094 | | | +| ru-19 | расторжение брака через суд | 1327 | | | +| ru-20 | как усыновить ребенка | 1327, 203700, 98146, 200573 | | | +| ru-21 | как получить гражданство Кыргызстана | 202103, 4798 | | | +| ru-22 | как получить разрешение на строительство | 230029221 | | | +| ru-23 | как рассчитывается земельный налог | 112340 | | | +| ru-24 | как обжаловать государственную закупку | 112361, 160429 | | | +| ru-25 | лицензия на образовательную деятельность | 205058, 112665, 230000631 | | | + +## Кыргыз тили + +| ID | Суроо | Алдын ала коддор | Тастыкталган коддор | Натыйжа жана комментарий | +| --- | --- | --- | --- | --- | +| ky-01 | коомдук бирикмени кантип каттоого болот | 274, 230044970 | | | +| ky-02 | Кыргызстанда ЖЧК кантип ачылат | 230044970, 667 | | | +| ky-03 | жеке ишкерди каттоо үчүн кандай документтер керек | 112340, 159109 | | | +| ky-04 | жумушсуз статусун кантип алса болот | 111258, 158006, 230011260, 200832 | | | +| ky-05 | жумушсуздук боюнча жөлөкпул | 111258, 14206 | | | +| ky-06 | балага алимент өндүрүү | 1327, 98934 | | | +| ky-07 | бала багуу боюнча өргүү | 230021083 | | | +| ky-08 | өз каалоосу менен жумуштан чыгуу | 230021083 | | | +| ky-09 | эң төмөнкү эмгек акы | 230021083, 230042095 | | | +| ky-10 | ылдамдыкты ашыргандыгы үчүн айып пул | 112306 | | | +| ky-11 | айдоочулук күбөлүктүн колдонуу мөөнөтү | 230035520, 230021301 | | | +| ky-12 | мурасты кантип тариздөө керек | 5 | | | +| ky-13 | батирге менчик укугун каттоо | 160, 230032352 | | | +| ky-14 | жеке маалыматтарды макулдуксуз иштетүүгө болобу | 230029914, 230030911 | | | +| ky-15 | жарандардын кайрылуусуна жооп берүү мөөнөтү | 202100 | | | +| ky-16 | коомдук маалыматка жетүү | 230009705 | | | +| ky-17 | тынч чогулуш өткөрүүнүн тартиби | 203664 | | | +| ky-18 | никени кантип каттоого болот | 1327, 112094 | | | +| ky-19 | сот аркылуу никени бузуу | 1327 | | | +| ky-20 | баланы кантип асырап алууга болот | 1327, 203700, 98146, 200573 | | | +| ky-21 | Кыргызстандын жарандыгын кантип алса болот | 202103, 4798 | | | +| ky-22 | курулушка уруксатты кантип алса болот | 230029221 | | | +| ky-23 | жер салыгы кантип эсептелет | 112340 | | | +| ky-24 | мамлекеттик сатып алууга кантип даттанса болот | 112361, 160429 | | | +| ky-25 | билим берүү ишмердигине лицензия | 205058, 112665, 230000631 | | | + +--- + +Акылдаш · Telegram-бот v0.2.2 · Backend v0.7.1 · Frontend — не создан