diff --git a/docs/README.md b/docs/README.md index 302d49b..6af5c58 100644 --- a/docs/README.md +++ b/docs/README.md @@ -11,7 +11,7 @@ - [Бланк юридической проверки relevance set v1](product/relevance-set-v1-legal-review.md) — независимая верификация запросов и кодов актов; включает отдельные Excel-файлы для русского и кыргызского языков. -- [Инструкция для юриста](product/legal-review-instructions.pdf) — пошаговая +- [Инструкция для юриста](product/Инструкция.pdf) — пошаговая проверка запросов и кодов в ЦБД Минюста КР. - [Задание по нормализации документов](product/minjust-document-normalization-agent-task.md) — требования и критерии приёмки нормализатора ЦБД Минюста КР. diff --git a/docs/operations/project-status.md b/docs/operations/project-status.md index 6aa411d..d4571e4 100644 --- a/docs/operations/project-status.md +++ b/docs/operations/project-status.md @@ -1,6 +1,6 @@ # Статус проекта -Последняя проверка: 2026-08-14 +Последняя проверка: 2026-09-06 Назначение документа: быстро восстановить контекст проекта для участников команды и будущих агентов. - Telegram-бот: `0.2.2` @@ -12,8 +12,9 @@ Репозиторий переориентирован с отдельного бота на весь проект юридической информационно-аналитической платформы. Telegram-бот выделен в инструмент рабочего окружения. Реализованы возобновляемая выгрузка документов из официального Open Data API ЦБД Минюста КР и их локальная воспроизводимая нормализация. -Ближайшая цель — оценить полный локальный индекс на 50–100 запросах RU/KY и -настроить ранжирование до начала разработки поискового API. +Ближайшая цель — провести независимую юридическую верификацию relevance set +v1, зафиксировать воспроизводимый baseline и только затем переходить к +readiness gate frontend. ## Уже сделано @@ -77,6 +78,8 @@ - Полный проход завершён: 209 958 документов нормализованы без ошибок. - Контрольная выборка RU/KY прошла проверки текста, фрагментов, ID и SHA-256. - Добавлены строгий mapping и атомарный Bulk NDJSON-экспорт для OpenSearch. +- Подготовлены русскоязычный и кыргызскоязычный бланки юридической проверки + relevance set v1 и пошаговая инструкция для юриста. ### Развёртывание @@ -112,6 +115,15 @@ - Не настроены уведомления Gitea. - Не проведён полный пользовательский тест: сообщение → сохранение → экспорт → анализ в ChatGPT → возврат отчёта. +### Готовность поиска к frontend + +- Не завершена независимая юридическая проверка всех 50 запросов relevance set + v1; спорные строки нельзя включать в baseline. +- Не зафиксированы неизменяемая копия подтверждённого relevance set и baseline + `Recall@10`/`MRR@10`. +- Не пройден финальный readiness gate: обновление корпуса, переиндексация, + проверка выдачи и API-сценарии для RU, KY и одноязычных актов. + ## Важные неизвестные По мере реального использования нужно принять решения по следующим вопросам: @@ -122,19 +134,29 @@ ## Следующий этап -### Фиксация MVP и проверка полного цикла +### Юридическая верификация relevance set и readiness gate frontend Рекомендуемый порядок: -1. Настроить резервное копирование `/volume1/docker/akyldash/data`. -2. Зафиксировать состав MVP с командой и закрыть тему `MVP`. -3. Провести одно реальное обсуждение с ответами, правками и вложением. -4. Экспортировать обсуждение и вручную проанализировать Markdown в ChatGPT. -5. Вернуть подтверждённый итог в тему `Решения` и зафиксировать его в Git/Gitea. -6. Записать обнаруженные неудобства и только после этого выбирать следующую доработку. +1. Передать `Выборка-ru.xlsx` и кыргызский бланк двум независимым + проверяющим и согласовать спорные строки по официальной ЦБД Минюста КР. +2. Перенести только подтверждённые `document_code` в + `data/search/relevance-set-v1.json` и сохранить неизменяемую копию набора. +3. Рассчитать и зафиксировать baseline `Recall@10`/`MRR@10`. +4. Выполнить воспроизводимое обновление корпуса, проверку versioned-индекса и + переключение alias. +5. Прогнать API-сценарии поиска, фильтрации и просмотра документа для RU, KY + и одноязычных актов; после успешного gate открыть задачу на frontend. ## История изменений статуса +### 2026-09-06 + +- Подготовлены бланки независимой юридической проверки relevance set v1 для + русского и кыргызского языков и инструкция для юриста. +- Ближайшим этапом зафиксированы юридическая верификация, baseline качества + поиска и финальный readiness gate перед frontend. + ### 2026-08-18 - Оценщик поиска использует `cross_fields` для совместного сопоставления diff --git a/docs/product/legal-review-instructions.md b/docs/product/legal-review-instructions.md index 49060f0..5e8a15a 100644 --- a/docs/product/legal-review-instructions.md +++ b/docs/product/legal-review-instructions.md @@ -7,7 +7,7 @@ ## Что нужно открыть Для русскоязычных запросов используйте файл -`relevance-set-v1-legal-review-ru.xlsx` и официальный поиск ЦБД Минюста КР: +`Выборка-ru.xlsx` и официальный поиск ЦБД Минюста КР: @@ -92,7 +92,7 @@ ## Передача результата Сохраните Excel под новым именем, например -`relevance-set-v1-legal-review-ru-ivanova.xlsx`, и не меняйте ID запросов, +`Выборка-ru-иванова.xlsx`, и не меняйте ID запросов, сам текст запросов и предварительные коды. Передайте файл вместе с вопросами, помеченными как `спорно`. diff --git a/docs/product/relevance-set-v1-legal-review-ru.xlsx b/docs/product/relevance-set-v1-legal-review-ru.xlsx deleted file mode 100644 index 57e4f2e..0000000 Binary files a/docs/product/relevance-set-v1-legal-review-ru.xlsx and /dev/null differ diff --git a/docs/product/relevance-set-v1-legal-review.md b/docs/product/relevance-set-v1-legal-review.md index 28978b6..c23d1f5 100644 --- a/docs/product/relevance-set-v1-legal-review.md +++ b/docs/product/relevance-set-v1-legal-review.md @@ -4,7 +4,7 @@ baseline поиска. Это рабочий бланк: он не является юридическим заключением и не должен использоваться для настройки ранжирования до завершения проверки. -Для заполнения используйте Excel-файлы: [русский бланк](relevance-set-v1-legal-review-ru.xlsx) +Для заполнения используйте Excel-файлы: [русский бланк](Выборка-ru.xlsx) с отдельным примером и [кыргызский бланк](relevance-set-v1-legal-review-ky.xlsx) для проверки носителем кыргызского языка. diff --git a/docs/product/Выборка-ru.xlsx b/docs/product/Выборка-ru.xlsx new file mode 100644 index 0000000..163add4 Binary files /dev/null and b/docs/product/Выборка-ru.xlsx differ diff --git a/docs/product/legal-review-instructions.pdf b/docs/product/Инструкция.pdf similarity index 100% rename from docs/product/legal-review-instructions.pdf rename to docs/product/Инструкция.pdf