# Акылдаш

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

Telegram-бот — только часть рабочего окружения команды, а не основной продукт.

## Текущее состояние

Сейчас реализованы Telegram-бот-секретарь версии `0.2.2` и backend версии
`0.9.1`: добавлены фильтры по юридической силе и статусу, каталог сохраняет
документы с неучтёнными исходными типами.

| Компонент | Версия | Состояние |
|---|---:|---|
| Telegram-бот | `0.2.2` | на Synology работает `0.2.1`; обновление после слияния |
| Backend | `0.9.1` | фильтры поиска по юридической силе и статусу документа; неизвестные типы сохранены в индексе |
| Frontend | — | ещё не создан |
| Сбор и обработка правовых данных | `0.8.0` | добавлены relevance set и оценка выдачи |
| RAG и база знаний | — | ещё не созданы |

## Структура репозитория

```text
docs/                  структурированная документация проекта
  decisions/           принятые архитектурные и продуктовые решения
  operations/          состояние проекта и рабочие процессы
  product/             назначение, границы и развитие продукта
  team/                материалы для команды
tools/
  telegram-bot/        бот рабочего Telegram-пространства
backend/
  ingestion/           получение и обновление правовых источников
  normalization/       воспроизводимая нормализация исходного архива
```

Каталоги для загрузки и обработки источников, RAG, backend и frontend будут
создаваться с первой реальной задачей в соответствующей области. Это позволит
выбрать структуру по фактическим требованиям, а не поддерживать пустой каркас.

Начать знакомство с проектом: [документация](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.9.1 · Frontend — не создан