# Резюме для нового чата — contracts (contractor/Lucee)

Дата: 2026-06-23 | Версия в git: v1.0.152 | Версия на Lucee: v1.0.152 (после редеплоя)

---

## Архитектура

```
Браузер (contractor.luceek8s.dev.nubes.ru)
    │
    ├── загрузка файлов → VM (contracts.kube5s.ru/upload)
    │   Python convert_server.py, чанки 10KB → chunk.cfm → Lucee DB
    │
    ├── парсинг: PDF→VM (PyPDF2), DOCX/DOC→Lucee (Apache POI через parser.cfm)
    │
    ├── сравнение → VM SSE /process-v2 → LLM (gpt-oss-120b)
    │
    └── промпты → Lucee prompt.cfm (версионные, extract/diff)
```

**Компоненты:**
- Lucee 6.0 (CFML) на k8s — `contractor.luceek8s.dev.nubes.ru`
- VM Python 3 — `contracts.kube5s.ru` (5.172.178.213)
- PostgreSQL 15 — внутренний, БД `baza`
- LLM: gpt-oss-120b через api.aillm.ru (бесплатно, 8000 токенов)
- Nginx: `/upload`, `/process-v2`, `/unzip-upload`, `/convert-doc` → VM:8766

## Что сделано (v1.0.109 → v1.0.152)

### Успешно работает
- Upload через VM чанками (10KB) — обходит лимит Lucee k8s (~30KB)
- ZIP через /unzip-upload (VM)
- PDF парсинг через PyPDF2 на VM
- Prompts в БД с версионированием, редактор в UI
- Opus-улучшенные промпты (few-shot, глоссарий ЦОД)
- Provenance: prompt_version, source_document_id, raw_llm_response в spec_events
- ↕ стрелки для порядка файлов
- О сервисе — модальное окно

### Критические баги исправлены
- JS: UPPERCASE ключи Lucee (OK, BODY, VERSIONS, IS_ACTIVE...)
- JS: лишний `});` ломавший весь JS
- CORS: дубликаты заголовков на /upload и /unzip-upload
- chunk.cfm: `decode(base64)` для правильного хранения файлов
- parser.cfm: откачен к рабочей версии (PDF→VM, DOCX→Lucee POI)

## Текущее состояние (v1.0.152)

- VM: Python, чанки base64, PDF парсинг ✅
- Lucee: v1.0.152, parser.cfm рабочий, chunk.cfm с base64 ✅
- PDF: загрузка + парсинг работают ✅
- DOCX/DOC: должно работать после v1.0.152 (base64 fix) ✅
- Prompts: работают ✅

## Проблемы решённые сегодня

1. PDF upload: "Network Error" → chunked upload через VM (10KB чанки)
2. PDF parsing: PDFBox сломан → PyPDF2 на VM
3. DOCX storage: hex вместо base64 → base64 в chunk.cfm
4. CORS дубликаты → nginx только OPTIONS, VM — POST
5. JS uppercase keys → исправлено

## Правила (важно!)

- ⛔ НИКОГДА ничего не делать без «делай»
- После каждой правки: проверка синтаксиса (node --check для JS, py_compile для Python)
- После каждого изменения: bump версии в index.cfm
- Перед push: git diff, проверить всё
- Lucee требует ручного редеплоя через Nubes UI
- VM: scp + pkill + nohup для перезапуска
- curl к *.ngcloud.ru всегда с --http2 и --max-time
- Lucee serializeJSON → UPPERCASE ключи
- Lucee k8s лимит тела запроса ~30KB
- Документация в History/*.md

## Если что-то сломалось

1. Проверить git status в /home/naeel/nubes/contracts/contractor
2. Проверить версию на Lucee: curl --http2 --max-time 5 -s 'https://contractor.luceek8s.dev.nubes.ru/' | grep 'v1.0.'
3. Проверить VM: ssh -i ~/.ssh/naeel_vm_id_ed25519 naeel@5.172.178.213 'ps aux | grep convert'
4. Логи nginx: ssh ... 'sudo tail -20 /var/log/nginx/error.log'
5. Тест загрузки: curl --http2 -X POST 'https://contracts.kube5s.ru/upload' -F 'files=@file.pdf'