Files
akyldash/README.md
agent 6e9c163047
CI / tests-and-images (pull_request) Successful in 2m19s
Runner smoke test / runner-smoke (pull_request) Successful in 3s
docs: consolidate platform functionality
2026-11-15 15:08:16 +03:00

5.4 KiB

Акылдаш

Акылдаш — проект юридической информационно-аналитической платформы Кыргызской Республики. Целевые возможности и требования к выпуску ведутся в функциональности платформы.

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-сервиса. Остальные материалы собраны в оглавлении документации.

Конфиденциальные материалы

Секреты, персональные данные, договоры и материалы по правовой защите проекта не должны храниться в этом репозитории. Для них нужен отдельный закрытый репозиторий или защищённое хранилище с минимально необходимыми правами доступа, журналированием и резервным копированием. Здесь допустимы только несекретные правила и ссылки на такие материалы без раскрытия их содержания.

Проверка Telegram-бота

python3 -m unittest discover -s tools/telegram-bot -v

Акылдаш · Telegram-бот v0.2.2 · Backend v0.13.4 · Frontend v0.3.4