Поставлена задача — разработать интеллектуальную платформу для юристов и малого бизнеса, которая автоматизирует анализ юридических документов и снижает риски человеческой ошибки. Клиенту требовалось решение, способное оценивать риски договоров, извлекать ключевые клаузулы, проверять соответствие 17 регуляторным фреймворкам (GDPR, HIPAA, SOX, CCPA, AML и др.) и генерировать структурированные due diligence-отчёты.
Ключевые вызовы: обеспечить надёжность юридических выводов (нельзя полагаться исключительно на LLM «на глаз»), создать интуитивный интерфейс для не-юристов и внедрить уникальную фичу — мухурта-планировщик для выбора благоприятного времени подписания документов. Дополнительно требовался Telegram-бот для круглосуточного доступа.
Спроектировал и реализовал полноценную платформу с гибридной архитектурой «LLM + детерминированные вычисления»:
Бэкенд: Python 3.14 + FastAPI (порт 54325) с 7 роутерами (документы, анализ, ClauseDNA™, compliance, due diligence, сравнение, матрица рисков, агент-чат). SQLAlchemy 2.0 + Pydantic v2 для строгой валидации данных.
Ядро системы — детерминированная агрегация рисков: разработал формулу max_score * 0.6 + mean_score * 0.4 для вычисления итогового риска документа. Это позволяет гарантировать консистентность выводов: CRITICAL-клаузула доминирует над остальными, а множество MEDIUM-рисков накапливаются. Реализовано 5 золотых тестов, подтверждающих корректность формулы.
ClauseDNA™: создал систему промптов для извлечения 50+ типов клаузул (force majeure, indemnification, termination, confidentiality и др.) с verbatim-цитатами и risk_score для каждой.
Compliance Scanner: реализовал словарь из 17 фреймворков с привязкой к конкретным статьям и severity-уровнями. Результат — COMPLIANT / REVIEW_NEEDED / NON_COMPLIANT.
Due Diligence: автогенерация отчётов из 12 секций с выделением deal-breakers и итоговой оценкой риска.
Frontend: React 19 + TypeScript с тёмной темой, анимациями и 8 вкладками: Documents, Analyze, ClauseDNA, Compliance, Due Diligence, Compare, Risk Matrix, AI Agent. Реализовал «живое демо» на лендинге — текстовое поле, отправляющее документ на анализ в реальном времени.
Telegram-бот: aiogram 3.x с 14 командами и поддержкой для доступа к сервису 24/7.
Мухурта-планировщик: математический расчёт 30 окон по 48 минут с выделением 10 благоприятных интервалов для юридических действий (источник — Bṛhat Saṃhitā).
Ключевая архитектурная особенность: двухслойный подход к оценке рисков — (1) LLM присваивает риск каждой клаузуле, (2) детерминированный агрегатор вычисляет итоговый вердикт. Это исключает «галлюцинации» LLM в финальном решении и даёт воспроизводимый результат.
Создан действующий прототип (версия 3.0/4.0), который уже используется для юридической проверки договоров и compliance-аудита. Ключевые достижения:
Снижение времени на анализ одного документа с 2–3 часов до 5–10 минут благодаря AI-разметке клаузул и автоматической оценке рисков.
Повышение точности выявления критических условий (indemnification, limitation of liability, termination penalties) — система находит и подсвечивает красные флаги, которые юристы пропускают в объёмных документах.
Стандартизация due diligence — отчёты генерируются по единому шаблону из 12 секций, что упрощает сравнение документов и принятие решений.
Доступность 24/7 через Telegram-бота: клиенты могут оперативно проверить контракт прямо с телефона без необходимости заходить в веб-интерфейс.
Уникальное преимущество — мухурта-планировщик, который помогает выбрать благоприятное время для подписания сделок, что востребовано на рынке РФ и повышает лояльность пользователей.
В перспективе платформа развивается в сторону Citation Graph™ (визуализация связей между клаузулами), шаблонизации документов и интеграции с Neo4j для графового анализа.