# Запрос к Opus — генератор тестовых документов + симулятор поведения

## Что за сервис (кратко)

**contracts** — загрузка договоров колокейшн/ЦОД, авто-классификация через LLM,
группировка по контрактам, сравнение версий (сверка спецификаций).

Pipeline: Загрузка (.docx/.doc/.pdf/.zip) → Парсинг → Классификация (LLM) → Группировка → Сравнение (LLM, Event Sourcing)

Фронтенд: одна страница с таблицей файлов, карточками групп, SSE-сравнением.
Бэкенд: Python http.server, PostgreSQL, LLM через api.aillm.ru (gpt-oss-120b).

## Какие файлы уже есть (3 типа, 6 шт.)

### Тип 1: Договор — `договор-XXX001-03700.docx`

Заголовок: "Договор на оказание технологических услуг"
Номер: № 03700_1
Стороны: ЗАО "XXX001" (Заказчик) + ООО "НУБЕС" (Исполнитель)
Адрес/дата: г. Москва, 01.02.2026

Секции: Термины, Предмет, Права/Обязанности, Состав/Порядок/Сроки,
Стоимость, Порядок оплаты, Взаимодействие, Сдача-приёмка, Особые условия
Таблица реквизитов (1×2 — Заказчик | Исполнитель)

### Тип 2: Допсоглашение — `допник-1-XXX003-01300_2.doc`

Заголовок: "Дополнительное Соглашение №1"
Привязка: "к Договору № 01300_2 от 20.12.2025"
Стороны: АО "XXX003" + ООО "НУБЕС"

Таблица услуг (6 колонок): №, Наименование, Цена руб. с НДС, Объем, Сумма, Дата начала
Пример: Организация L2 канала без резерва — 8 283,80 × 1 = 8 283,80, 26.03.2026
Строка итого: Итого инсталляционный платеж — 8 283,80

### Тип 3: Спецификация — `спецификация-XXX001-03700.docx`

Заголовок: "Приложение № 1 к Договору № 03700_1 от 01.02.2026"
Секция: "Спецификация и стоимость услуг"
Подсекция: "Абонентские услуги с ДАТА – ДАТА"
Общая стоимость: 769 279,53 руб.

Таблица услуг (6 колонок): №, Наименование, Цена, Объем, Сумма, Дата начала
9 строк, включая:
- Аренда стойко-места — 213 905,44 × 3 = 641 716,32
- Аренда PDU 3Ф 32А — 2 511,17 × 3 = 7 533,51
- Организация L2 канала — цена × кол-во
- IP-адреса, cross-connect, etc.

### Паттерны имён

```
договор-{КОМПАНИЯ}-{НОМЕР}.docx
допник-{N}-{КОМПАНИЯ}-{НОМЕР}.doc / .docx
спецификация-{КОМПАНИЯ}-{НОМЕР}.docx
```

КОМПАНИЯ = XXX001..XXX010, НОМЕР = 03700, 01200_3, 01300_2
N = номер допника (1, 2, 3...)

Иерархия: спецификация и допник привязаны к договору через НОМЕР.

---

## Что нужно от Опуса

### Часть 1 — Принцип генерации ~100 файлов

Нужна СХЕМА (не код):

1. Сколько контрактов, сколько файлов каждого типа
2. Как варьировать: компании, номера, даты, цены, наборы услуг
3. Ошибочные случаи:
   - без номера договора
   - нестандартный заголовок
   - битый XML внутри docx
   - пустой файл
   - только таблицы / только текст
   - .doc (старый формат, идёт через конвертер)
   - битый PDF
   - дубликаты имён
4. Как связать parent-child (договор → допник → спецификация)
5. Структура шаблонов python-docx

### Часть 2 — Симулятор поведения

Нужна СТРАТЕГИЯ:

1. Хэппи-путь: загрузка → классификация → группы → сравнение
2. Зигзаги: загрузил → удалил → перезагрузил → ещё загрузил
3. Тупые действия: дубликаты (OK/Отмена), удалить всё, смешать форматы
4. ZIP с дубликатами внутри
5. Тайминги и задержки
6. Верификация после каждого шага: число файлов, статусы, группы

### Часть 3 — Верификация

Как проверять корректность после каждого шага симулятора:
- Количество файлов в state.files
- Статусы парсинга (✓ / ✗)
- Наличие групп после classify
- Результаты сравнения

---

## Формат ответа

Принципиальная схема (НЕ реализация):
- Что генерировать (типы, количество, вариации)
- Как генерировать (шаблоны, подстановки)
- Как симулировать (последовательности, тайминги)
- Как проверять (чек-лист верификации)
- Структура папок

Код генератора и симулятора напишу я сам.