Акылдаш
Акылдаш — проект юридической информационно-аналитической платформы. Цель — собирать правовые источники на законных основаниях, сохранять их происхождение и версии, готовить данные для поиска и RAG, а затем предоставлять результаты через API и пользовательский интерфейс со ссылками на первоисточники.
Telegram-бот — только часть рабочего окружения команды, а не основной продукт.
Текущее состояние
В исходном коде находятся Telegram-бот-секретарь версии 0.2.2, Search API
версии 0.13.4 (алгоритм поиска search-8) и frontend 0.3.4 с поисковым
экраном, внутренней лабораторией и согласованным отображением доступных
действий учетной записи.
Авторизация хранится в
SQLite; первый пользователь admin создаётся интерактивной CLI-командой.
Поиск расширяет аббревиатуры организационно-правовых форм, применяет узкий
юридический вариант для общего словосочетания «договор аренды» и поднимает
действующий Налоговый кодекс для запросов о налоге на прибыль. Ограничения
текущего индекса и подтверждённые тестовые ошибки описаны в
отчёте о релевантности.
Версии описывают код, а не установленный production-релиз; актуальное
подтверждённое состояние среды см. в
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 и база знаний | — | ещё не созданы |
Структура репозитория
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.
Начать знакомство с проектом: документация и обзор продукта.
Конфиденциальные материалы
Секреты, персональные данные, договоры и материалы по правовой защите проекта не должны храниться в этом репозитории. Для них нужен отдельный закрытый репозиторий или защищённое хранилище с минимально необходимыми правами доступа, журналированием и резервным копированием. Здесь допустимы только несекретные правила и ссылки на такие материалы без раскрытия их содержания.
Проверка Telegram-бота
python3 -m unittest discover -s tools/telegram-bot -v
Акылдаш · Telegram-бот v0.2.2 · Backend v0.13.4 · Frontend v0.3.4