docs: record project status and next steps

This commit is contained in:
2026-09-06 23:37:40 +03:00
parent cb58e91d6b
commit 470745fce3
7 changed files with 36 additions and 14 deletions

View File

@@ -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) —
требования и критерии приёмки нормализатора ЦБД Минюста КР.

View File

@@ -1,6 +1,6 @@
# Статус проекта
Последняя проверка: 2026-08-14
Последняя проверка: 2026-09-06
Назначение документа: быстро восстановить контекст проекта для участников команды и будущих агентов.
- Telegram-бот: `0.2.2`
@@ -12,8 +12,9 @@
Репозиторий переориентирован с отдельного бота на весь проект юридической информационно-аналитической платформы. Telegram-бот выделен в инструмент рабочего окружения. Реализованы возобновляемая выгрузка документов из официального Open Data API ЦБД Минюста КР и их локальная воспроизводимая нормализация.
Ближайшая цель — оценить полный локальный индекс на 50100 запросах 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` для совместного сопоставления

View File

@@ -7,7 +7,7 @@
## Что нужно открыть
Для русскоязычных запросов используйте файл
`relevance-set-v1-legal-review-ru.xlsx` и официальный поиск ЦБД Минюста КР:
`Выборка-ru.xlsx` и официальный поиск ЦБД Минюста КР:
<https://cbd.minjust.gov.kg/search-docs/ru>
@@ -92,7 +92,7 @@
## Передача результата
Сохраните Excel под новым именем, например
`relevance-set-v1-legal-review-ru-ivanova.xlsx`, и не меняйте ID запросов,
`Выборка-ru-иванова.xlsx`, и не меняйте ID запросов,
сам текст запросов и предварительные коды. Передайте файл вместе с вопросами,
помеченными как `спорно`.

View File

@@ -4,7 +4,7 @@
baseline поиска. Это рабочий бланк: он не является юридическим заключением и
не должен использоваться для настройки ранжирования до завершения проверки.
Для заполнения используйте Excel-файлы: [русский бланк](relevance-set-v1-legal-review-ru.xlsx)
Для заполнения используйте Excel-файлы: [русский бланк](Выборка-ru.xlsx)
с отдельным примером и [кыргызский бланк](relevance-set-v1-legal-review-ky.xlsx)
для проверки носителем кыргызского языка.

Binary file not shown.