docs: align relevance review with internal search

This commit is contained in:
2026-09-12 08:49:38 +03:00
25 changed files with 720 additions and 257 deletions

View File

@@ -1,20 +1,21 @@
# Статус проекта
Последняя проверка: 2026-09-06
Последняя проверка: 2026-09-12
Назначение документа: быстро восстановить контекст проекта для участников команды и будущих агентов.
- Telegram-бот: `0.2.2`
- Telegram-бот на Synology: `0.2.1`
- Backend: `0.7.1`
- Backend: `0.8.3`
- Frontend: не создан
## Краткий итог
Репозиторий переориентирован с отдельного бота на весь проект юридической информационно-аналитической платформы. Telegram-бот выделен в инструмент рабочего окружения. Реализованы возобновляемая выгрузка документов из официального Open Data API ЦБД Минюста КР и их локальная воспроизводимая нормализация.
Ближайшая цель — провести независимую юридическую верификацию relevance set
v1, зафиксировать воспроизводимый baseline и только затем переходить к
readiness gate frontend.
Поисковая система и внутренняя лаборатория оценки выдачи реализованы. Ближайшая
цель — проверить собственную выдачу на практических RU/KY-запросах, разобрать
оценки юристов и зафиксировать baseline. ЦБД Минюста служит источником для
проверки документов и редакций, а не системой для сравнения поисковой выдачи.
## Уже сделано
@@ -117,6 +118,8 @@ readiness gate frontend.
### Готовность поиска к frontend
- Реализована внутренняя лаборатория для просмотра и оценки фактической
выдачи OpenSearch; пилот с юристами ещё не проведён.
- Не завершена независимая юридическая проверка всех 50 запросов relevance set
v1; спорные строки нельзя включать в baseline.
- Не зафиксированы неизменяемая копия подтверждённого relevance set и baseline
@@ -134,22 +137,25 @@ readiness gate frontend.
## Следующий этап
### Юридическая верификация relevance set и readiness gate frontend
### Проверка собственной поисковой выдачи
Рекомендуемый порядок:
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.
1. Подготовить согласованный RU/KY relevance set: фиксировать потребность
запроса и подтверждённые `document_code`, не ориентируясь на порядок выдачи.
2. Проверить практические запросы во внутренней лаборатории `/review`, сохранить
снимки и оценки фактических результатов OpenSearch.
3. Разобрать ошибки ранжирования, сохранить baseline и повторить ту же проверку
после изменений.
4. Затем пройти readiness gate issue #21 для корпуса, индекса и Search API перед
проектированием публичного frontend.
## История изменений статуса
### 2026-09-12
- Внутренняя лаборатория оценивает фактическую выдачу собственного OpenSearch;
ЦБД Минюста используется только для проверки источников и редакций актов.
- Backend `0.8.3`; закрытая внутренняя лаборатория готова к пилоту.
### 2026-09-06
- Подготовлены бланки независимой юридической проверки relevance set v1 для
@@ -256,4 +262,4 @@ readiness gate frontend.
---
Акылдаш · Telegram-бот v0.2.2 · Backend v0.7.1 · Frontend — не создан
Акылдаш · Telegram-бот v0.2.2 · Backend v0.8.3 · Frontend — не создан