contracts/README.md

Сверка договоров (Contracts)

Проект автоматизированной обработки и сверки договоров с помощью ИИ.

Задача

Разбирать спецификации договоров и допников (docx/pdf) в структурированный вид, отслеживать изменения между версиями, восстанавливать историю договора во времени.

Архитектура

Подробное описание архитектуры (компоненты, БД, event sourcing, загрузка через ВМ-буфер, ZIP, конвейер сравнения) — см. DOC/architecture-contracts-flask.md.

Ключевые моменты:

• Основной сервис — contracts-flask/ (Flask + SQLite WAL, managed на Nubes).
• Загрузка — браузер PUT файла в ВМ-буфер (WebDAV), бэк сам тянет с ВМ (managed-gateway рвёт тела > 64 КБ, egress ВМ без лимита).
• ZIP — раскрывается на клиенте (expandZipClient → listZipFiles).
• Event sourcing — spec_events (журнал) + spec_current (текущее состояние).
• Сравнение — /process-v2 (SSE): LLM возвращает ops (ADD/UPDATE/DELETE/ UNRESOLVED), применяются через apply_ops().
• LLM — только своя модель gpt-oss-120b (api.aillm.ru).

Состав репозитория

Папка	Что
contracts-flask/	Основной сервис (Flask + SQLite, managed на Nubes)
contractor-legacy/	Старый Lucee/CFML-сервис (архив)
convert-service/	Микросервис конвертации doc → docx
DOC/	Документация: архитектура, тестирование
History/	История решений, ревью, протоколы
FILES/	Заметки, ключи LLM, ТЗ
dogovora/	Примеры договоров и допников
loadtest/	Нагрузочное тестирование
sim/	Симуляция сценариев
testgen/	Генерация тестовых кейсов
hz/	Разные заметки

Конфиденциальность

Данные договоров строго конфиденциальны. LLM — только собственная модель.