БАТЫС AI

Объяснимый ИИ-агент для анализа организационной структуры и функционала. Кейс HackAlem AI «Анализ организационной структуры и функционала», команда БАТЫС.

Агент сравнивает комплекты документов «до» и «после» реорганизации: оргструктуры, положения, должностные инструкции, приказы (Word, PDF, Excel). На каждую сторону можно загрузить до 10 файлов. Он определяет созданные, сохранённые, преобразованные и упразднённые подразделения, строит таблицу сопоставления функций, находит потери, сужения, переносы, дублирование и конфликты полномочий. Каждый вывод подтверждается номером пункта и цитатой из исходного документа. Окончательное решение принимает эксперт.

Презентация на одном листе: docs/presentation.html. Там схема архитектуры, путь анализа, находки на контрольном комплекте и сверка с ТЗ. Готовый PDF для печати и показа: docs/batys-ai-presentation.pdf.

Быстрый старт: 1 команда, 1 клик

git clone https://github.com/BAITC-Hacks/hack-032ef148-team.git
cd hack-032ef148-team
docker compose up --build

Откройте http://localhost:4180 и нажмите «▶ Положение о внутреннем аудите: редакция 8 → 9». Агент проанализирует контрольный комплект организатора примерно за секунду.

npm install
npm start          # http://127.0.0.1:4180, хранение в памяти

Соответствие ТЗ

Проверка на контрольном комплекте

ТЗ, п. 11: «проверяется, обнаружил ли агент реорганизацию, потерю функции и дублирование и указал ли корректные источники». Результат на samples/ (редакции 8 → 9):

Эти ожидания зафиксированы в автотесте test/analyzer.test.mjs:

npm test     # 11 тестов: контрольный комплект организатора, AI-агент на подставной модели, загрузка комплекта файлов, авторизация и роли, помощь и заключение

Демонстрационный сценарий (5 минут)

1. Главный экран: кнопка «▶ Положение о внутреннем аудите: редакция 8 → 9».
2. Метрики: подразделения, потери, сужения, переносы, дубли, конфликты.
3. Фильтр «Потери»: ДККМ 5.5.4 и цитаты «ДО/ПОСЛЕ» рядом.
4. Вкладка «Подразделения»: созданы ДИТААД и ДОА, сохранены ДНМ и ДККМ.
5. Вкладка «Сопоставление функций», фильтр «Сужены»: пропавшая периодичность отчётов.
6. Нажать «Подтвердить»: откроется вход эксперта, зарегистрироваться. Подтвердить один вывод и отклонить другой с комментарием, показать подпись эксперта и прогресс проверки.
7. «Открыть отчёт»: печатное заключение.
8. Показать то же на телефоне в приложении Expo (или PWA).

В интерфейсе есть раздел «Помощь» с пошаговой инструкцией и скриншотами. Там же показан QR-код и адрес для открытия системы на телефоне. В мобильном приложении есть такая же вкладка «Помощь» и ссылка на веб-версию.

Второй набор, «Синтетический пример», показывает упразднение отдела с передачей 2 из 3 функций и потерю антикоррупционной функции.

Технологии

Подробности: архитектура и алгоритм · AI-контракт · безопасность · мобильные клиенты.

Мобильное приложение (Android и iOS)

cd mobile
npm install
EXPO_PUBLIC_API_URL=http://<IP-компьютера>:4180 npx expo start

Отсканируйте QR-код в Expo Go. Возможности: загрузка файлов с телефона, демо в одно нажатие, выводы с цитатами, экспертная проверка, история. Инструкция и сборка APK: docs/MOBILE.md.

API

Пользователи и роли

Анализ и просмотр доступны без входа, поэтому демо проверяется в один клик. Подтверждать и отклонять выводы может только эксперт. При нажатии «Подтвердить» открывается вход или регистрация, а решение подписывается именем эксперта и попадает в заключение.

Для постоянного входа задайте JWT_SECRET в .env. Подробнее: SECURITY.md.

AI-агент (опционально)

Включается переключателем «AI-агент проверки выводов». По каждому значимому выводу (до AI_MAX_FINDINGS, по умолчанию 12, сначала критичные) агент сам ведёт расследование через инструменты:

1. search_document — ищет функцию в редакции «до» или «после» (в том числе другими словами, чтобы отличить перенос от потери);
2. read_clause — читает найденный пункт целиком;
3. submit_verdict — выносит вердикт (подтверждён / сомнителен, уверенность, обоснование, рекомендация) со ссылками на пункты.

Каждая ссылка агента сверяется с документами: несуществующий пункт помечается красным, поэтому выдумать доказательство нельзя. Все шаги агента видны в карточке вывода, окончательное решение остаётся за экспертом.

Провайдер задаётся в .env: OPENAI_API_KEY (ключ sk-… с platform.openai.com, модель OPENAI_MODEL) или NVIDIA_API_KEY (ключ nvapi-… с build.nvidia.com, модель NVIDIA_MODEL, по умолчанию deepseek-ai/deepseek-v4.1-flash). Ключ другого вида сервер игнорирует. Если ключа нет или произошла ошибка, сохраняется локальный результат. Основной сценарий работает полностью без ключа.

Данные

• samples/polozhenie-vnutrenniy-audit-red-8.docx, …-red-9.docx: обезличенный контрольный комплект организатора.
• samples/synthetic/: синтетический пример, придуман командой, совпадения случайны.

Ограничения

• Стеммер упрощённый. Для других типов документов (должностные инструкции, приказы) могут понадобиться новые шаблоны заголовков.
• Проверка соответствия внешним нормативам и бенчмаркинг с другими операторами (опциональные пункты ТЗ) не реализованы.
• Авторизация по email и паролю. Для промышленного контура нужны корпоративный SSO, TLS и антивирусная проверка, см. SECURITY.md.
• Мобильное приложение проверено сборкой бандлов Android/iOS и expo-doctor. На физических устройствах в рамках хакатона оно не тестировалось.

Команда и вклад

• Команда: БАТЫС
• Бисенбаев Султан Бекрикулы: постановка задачи, продуктовая логика, проверка требований ТЗ, демо-сценарий, разработка с использованием AI-агентов (Codex, Claude Code).