77 lines
5.8 KiB
Markdown
77 lines
5.8 KiB
Markdown
# Акылдаш
|
||
|
||
Акылдаш — проект юридической информационно-аналитической платформы. Цель —
|
||
собирать правовые источники на законных основаниях, сохранять их происхождение
|
||
и версии, готовить данные для поиска и RAG, а затем предоставлять результаты
|
||
через API и пользовательский интерфейс со ссылками на первоисточники.
|
||
|
||
Telegram-бот — только часть рабочего окружения команды, а не основной продукт.
|
||
|
||
## Текущее состояние
|
||
|
||
В исходном коде находятся Telegram-бот-секретарь версии `0.2.2`, Search API
|
||
версии `0.13.4` (алгоритм поиска `search-8`) и frontend `0.3.4` с поисковым
|
||
экраном, внутренней лабораторией и согласованным отображением доступных
|
||
действий учетной записи.
|
||
Авторизация хранится в
|
||
SQLite; первый пользователь `admin` создаётся интерактивной CLI-командой.
|
||
Поиск расширяет аббревиатуры организационно-правовых форм, применяет узкий
|
||
юридический вариант для общего словосочетания «договор аренды» и поднимает
|
||
действующий Налоговый кодекс для запросов о налоге на прибыль. Ограничения
|
||
текущего индекса и подтверждённые тестовые ошибки описаны в
|
||
[отчёте о релевантности](docs/product/search-relevance-findings-2026-11-03.md).
|
||
Версии описывают код, а не установленный production-релиз; актуальное
|
||
подтверждённое состояние среды см. в
|
||
[`docs/operations/CURRENT_STATE.md`](docs/operations/CURRENT_STATE.md).
|
||
|
||
| Компонент | Версия | Состояние |
|
||
|---|---:|---|
|
||
| Telegram-бот | `0.2.2` | исходный код; последняя заметка о Synology указывает `0.2.1`, актуальность не перепроверена |
|
||
| Search API | `0.13.4` | авторизация, серверная capability управления пользователями, поиск и статические ресурсы |
|
||
| Frontend | `0.3.4` | поиск по правовой базе, просмотр редакций, внутренняя лаборатория и контекстная навигация кабинета |
|
||
| Загрузчик архива Минюста (`backend/ingestion/minjust_cbd.py`) | `0.9.3` (`APP_VERSION`) | версия CLI и User-Agent в исходном коде |
|
||
| Нормализатор корпуса (`backend/normalization/minjust_cbd.py`) | CLI `0.10.0` (`APP_VERSION`); формат/алгоритм `1.1.0` (`NORMALIZER_VERSION`) | версия инструмента и версия нормализатора в manifest — разные значения |
|
||
| Оценка релевантности | формат набора `relevance-set-v1` | отдельная версия компонента не задана; CLI использует Search API `0.13.4` |
|
||
| RAG и база знаний | — | ещё не созданы |
|
||
|
||
## Структура репозитория
|
||
|
||
```text
|
||
docs/ структурированная документация проекта
|
||
decisions/ принятые архитектурные и продуктовые решения
|
||
operations/ состояние проекта и рабочие процессы
|
||
product/ назначение, границы и развитие продукта
|
||
team/ материалы для команды
|
||
tools/
|
||
telegram-bot/ бот рабочего Telegram-пространства
|
||
backend/
|
||
ingestion/ получение и обновление правовых источников
|
||
normalization/ воспроизводимая нормализация исходного архива
|
||
search/ Search API, авторизация и внутренний frontend
|
||
```
|
||
|
||
Внутренний frontend отдаётся существующим Search API без отдельного
|
||
Node-сервиса. Отдельный публичный frontend остаётся за readiness gate в
|
||
`docs/product/frontend-design-readiness-plan.md`.
|
||
|
||
Начать знакомство с проектом: [документация](docs/README.md) и
|
||
[обзор продукта](docs/product/project-overview.md).
|
||
|
||
## Конфиденциальные материалы
|
||
|
||
Секреты, персональные данные, договоры и материалы по правовой защите проекта
|
||
не должны храниться в этом репозитории. Для них нужен отдельный закрытый
|
||
репозиторий или защищённое хранилище с минимально необходимыми правами доступа,
|
||
журналированием и резервным копированием. Здесь допустимы только несекретные
|
||
правила и ссылки на такие материалы без раскрытия их содержания.
|
||
|
||
## Проверка Telegram-бота
|
||
|
||
```bash
|
||
python3 -m unittest discover -s tools/telegram-bot -v
|
||
```
|
||
|
||
---
|
||
|
||
Акылдаш · Telegram-бот v0.2.2 · Backend v0.13.4 · Frontend v0.3.4
|