From c98f190cbc52555ed900524abb84c5bde7a62e92 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E2=80=9CNaeel=E2=80=9D?= Date: Wed, 24 Jun 2026 14:32:36 +0400 Subject: [PATCH] =?UTF-8?q?v1.0.173:=20=D0=9E=20=D1=81=D0=B5=D1=80=D0=B2?= =?UTF-8?q?=D0=B8=D1=81=D0=B5=20=D0=B2=20=D1=82=D0=BE=D0=BF=D0=B1=D0=B0?= =?UTF-8?q?=D1=80,=20=D0=BD=D0=BE=D0=B2=D1=8B=D0=B9=20=D0=BA=D0=BE=D0=BD?= =?UTF-8?q?=D1=82=D0=B5=D0=BD=D1=82=20=E2=80=94=20=D0=B8=D0=BD=D1=81=D1=82?= =?UTF-8?q?=D1=80=D1=83=D0=BA=D1=86=D0=B8=D1=8F=20=D0=B1=D0=B5=D0=B7=20?= =?UTF-8?q?=D1=83=D0=BF=D0=BE=D0=BC=D0=B8=D0=BD=D0=B0=D0=BD=D0=B8=D1=8F=20?= =?UTF-8?q?Lucee/VM?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- index.cfm | 55 +++++++++++++++---------------------------------------- 1 file changed, 15 insertions(+), 40 deletions(-) diff --git a/index.cfm b/index.cfm index eaf793f..8b264d6 100644 --- a/index.cfm +++ b/index.cfm @@ -75,7 +75,8 @@
Nubes - Сверка договоров — LLM AI-driven Event Sourcing v1.0.172 — Lucee + Сверка договоров — LLM AI-driven Event Sourcing v1.0.173 + ℹ️ О сервисе
@@ -83,7 +84,6 @@
Загрузка договоров/приложений/спецификаций - О сервисе
@@ -185,51 +185,26 @@
-

Что делает

-

Автоматический разбор и сравнение договоров облачного провайдера (colocation, ЦОД, аренда стоек, каналы связи, облачные ресурсы). Юрист загружает файлы — система сама определяет что есть что, группирует по контрактам и через LLM находит изменения между версиями.

+

Что это

+

Автоматический разбор и сравнение договоров с помощью ИИ (LLM). Загружаете договоры, допсоглашения и спецификации вперемешку — система сама разбирает что есть что, группирует по контрактам и находит все изменения между версиями. Работает на доменной модели облачного провайдера: colocation, ЦОД, аренда стоек, каналы связи, облачные ресурсы.

-

Архитектура

-

Два сервера:

-
    -
  • Lucee CFML (k8s) — только HTML-оболочка (index.cfm, 191 строка). Домен: contractor.luceek8s.dev.nubes.ru
    • -
  • Python 3.12 (VM, 5.172.178.213) — вся бизнес-логика: загрузка, парсинг, LLM-классификация, сравнение, Event Sourcing. Домен: contracts.kube5s.ru
    • -
-

База данных: PostgreSQL 16 на VM (127.0.0.1:5432/baza). Конфиденциальные данные не покидают ВМ.

-

LLM: gpt-oss-120b через api.aillm.ru (бесплатный доступ, HTTP/2).

+

Как устроено

+

Каждый документ парсится в структурированный JSON. LLM-модель (gpt-oss-120b) используется в трёх режимах: классификация (определяет тип/номер/дату/контрагента), извлечение (вытаскивает строки спецификации из базового договора), сравнение (находит изменения в допсоглашениях). Результат сравнения — операции ADD (новая услуга), UPDATE (изменение), DELETE (удалена), UNRESOLVED (не удалось сопоставить).

+

Все изменения хранятся как события (Event Sourcing) — можно видеть полную историю: кто, когда, на основании какого документа. Данные не покидают сервер.

-

Пайплайн обработки

-
    -
  1. Загрузка — .docx, .doc, .pdf. DOC→DOCX через LibreOffice на VM.
    2. -
  2. Парсинг — python-docx (Word) и PyPDF2 (PDF). Результат: структурированный JSON (параграфы + таблицы).
    3. -
  3. LLM-классификация — каждый файл анализируется LLM (gpt-oss-120b): определяется тип (договор/допсоглашение/спецификация), номер, дата, контрагент. Умная выжимка текста: ~3000 символов (header + маркерные строки) для экономии токенов.
    4. -
  4. Авто-группировка — Python-код нормализует номера договоров и группирует документы по контрактам. Хронологический порядок по датам.
    5. -
  5. LLM-сравнение — для каждой группы: первый документ → извлечение спецификации (extract). Каждый следующий → сравнение с накопленной спецификацией (diff). Операции: ADD (новая услуга), UPDATE (изменение), DELETE (исключена), UNRESOLVED (не удалось сопоставить).
    6. -
+

Как пользоваться

-

Event Sourcing

-

Изменения не перезаписывают спецификацию. Каждая операция — событие в таблице spec_events. Текущее состояние — spec_current. Это даёт:

-
    -
  • Аудит — полная история изменений: кто, когда, на основании какого документа
    • -
  • Provenance — для каждого события хранится: ID документа-источника, версия промпта LLM, полный сырой ответ LLM
    • -
  • Откат — можно вернуться к любому предыдущему состоянию спецификации
    • -
+

1. Загрузка — выберите файлы (.docx, .doc, .pdf). Можно загружать всё вперемешку: договоры, допники, спецификации. Порядок файлов не важен — классификация разберётся.

-

Промпты LLM

-

Хранятся в БД, версионируются. Три вида:

-
    -
  • extract — извлечение спецификации из первого документа (базовый договор)
    • -
  • diff — сравнение допсоглашения с текущей спецификацией
    • -
  • classify — авто-классификация: определение типа/номера/даты/контрагента документа
    • -
+

2. Классификация — нажмите кнопку в появившейся панели. Система через LLM определит для каждого файла: тип документа, его номер, дату, контрагента и родительский договор. Прогресс показывается в реальном времени.

-

Схема БД

-

7 таблиц: documents (файлы + elements_json + поля классификации), contracts, supplements (связь документ→договор), spec_events (события), spec_current (текущая спецификация), prompts (версионные промпты), upload_chunks (временные чанки).

+

3. Группы — после классификации документы автоматически группируются по договорам в хронологическом порядке. Вы увидите карточки групп: «Договор №X с Контрагентом Y». Документы, которые не удалось классифицировать, попадают в отдельную секцию «Не распознано».

-

Безопасность

-

Все файлы и тексты договоров хранятся ТОЛЬКО на ВМ (5.172.178.213). При перезагрузке страницы все данные автоматически удаляются из БД. Промпты (код системы) сохраняются.

+

4. Сравнение — для каждой группы нажмите «▶ Сравнить». Система извлечёт спецификацию из первого документа, затем сравнит каждое допсоглашение с ней. Результат — таблица изменений: что добавилось, что изменилось, что убрали.

-

Стек

-

Lucee 6.0 (CFML, k8s) + Python 3.12 (http.server, psycopg2, httpx, python-docx, PyPDF2) + PostgreSQL 16 + gpt-oss-120b + nginx + systemd.

+

5. Промпты — в выпадающем меню «⚙ Промпты LLM» можно редактировать инструкции для ИИ: как извлекать, как сравнивать, как классифицировать. Промпты версионируются — можно откатиться к предыдущей версии.

+ +

На выходе: структурированная таблица актуальной спецификации по каждому договору + полная история изменений с привязкой к документам-источникам.