contracts/History/opus-plan-review-2026-06-27.md

Разбор плана Opus от 2026-06-27

Что произошло

Opus'у дали задачу: «изучи код и напиши подробный план для DeepSeek V4 Pro по созданию параллельного Flask-стека 1:1 с Lucee↔ВМ, домен check.kube5s.ru».

Opus изучил репозиторий (без доступа к ВМ), считая contractor/deploy/ зеркалом продакшена, и выдал план из 6 фаз.

---

Что Opus выяснил правильно

Архитектура продакшена

• Lucee — почти пустая морда. Только index.cfm (HTML+CSS-скелет), chat.cfm (Q&A), Application.cfc. Вся логика — на ВМ.
• JS-файлы (app.js, files.js, groups.js, state.js, compare.js, app_utils.js) — клиентские, загружаются через <script src> из /static/ на ВМ.
• Бэкенд на ВМ — convert_server.py на порту 8766, импортирует services/*.py и db/*.py.
• Nginx маршрутизирует: / → Flask :5001 (UI), /upload, /convert-doc, /process-v2 и т.д. → Python :8766 (API), /lucee/ → managed Lucee.

Проблемы, которые Opus обнаружил

• chat.cfm сломан — ссылается на таблицу spec_rows, которой нет (правильная — spec_current).
• llm_prompt.py зависит от Lucee — _fetch_prompt() ходит в contractor.luceek8s.../prompt.cfm. Для изолированного стека надо переключить на db.prompts.get_active().
• Нет schema.sql — прод-БД baza создавалась руками. Для новой БД нужен pg_dump --schema-only.
• Рестарт через nohup, а не systemd (хотя память говорит про contracts.service).

План Opus (6 фаз)

Фаза	Что
Ф0	Предпосылки: DNS, дамп схемы БД, managed-домен морды, LLM_KEY
Ф1	Бэкенд на ВМ: ~/contracts-flask/, порт 8777, БД contracts_flask, systemd, разрыв связи с Lucee
Ф2	Nginx + SSL: новый server-блок check.kube5s.ru → :8777, certbot
Ф3	JS-фронтенд: копии 6 JS-файлов, VM_API='https://check.kube5s.ru', раздача через /static/
Ф4	Морда на managed Flask: очистить contracts-app, портировать index.cfm в Jinja2, Dockerfile
Ф5	Чат: перенести на ВМ как POST /chat (Python), контекст из spec_current
Ф6	Проверка изоляции и сквозной тест

---

Что Opus НЕ знал (выяснили позже)

1. contractor/deploy/ — ПОБАЙТОВОЕ зеркало ВМ

Opus предполагал это, но не знал точно. Мы проверили md5 всех файлов — ВСЕ файлы в db/ и services/ совпадают с ВМ (кроме services/llm.py, который отличается). Корневые classify.py, grouping.py, prompts.py, unzip.py на ВМ — мусор, не используются.

2. contracts-app — отдельный git-репозиторий

Opus предлагал «очистить contracts-app». Мы его случайно удалили вместе с .git. Репо: https://gitea.services.ngcloud.ru/Nail/contracts-app. Потом Наиль сказал «в ПИЗДУ его» и дал новый пустой репо: https://gitea.services.ngcloud.ru/Nail/contracts-flask.git.

3. check.kube5s.ru — DNS есть, nginx нет

DNS указывает на 5.172.178.213, но nginx не знает про этот домен → проваливается в default-сервер (obdai.ru), показывает чужой LLM-UI.

4. Рестарт — и nohup, и systemd

На ВМ реально перезапуск идёт через pkill -f convert_server.py; nohup python3 ... & (из sync.sh). Systemd-сервис contracts.service упоминается в памяти, но неясно, активен ли он.

5. JS-файлы уже на ВМ

6 JS-файлов лежат в ~/contracts/ (корень) и раздаются бэкендом через /static/. Для нового стека их надо скопировать в ~/contracts-flask/ и поменять VM_API.

---

Моё мнение о плане Opus

Что хорошо

• Полная изоляция — новая папка, новый порт, новая БД, новый systemd-юнит. Прод не заденешь.
• Разрыв связи с Lucee — правильно замечено, критично.
• schema.sql через pg_dump — правильно, ручное воссоздание схемы гарантирует ошибки.
• 6 фаз с зависимостями — логичный порядок.

Что плохо / упущено

1. Ф4 (Flask-морда) завязана на CI/CD managed-платформы, которую Opus не знает. План деплоя Flask-морды — «Dockerfile + gitea CI/CD» — слишком общий. Нужны конкретные шаги под Nubes managed Python.
2. Не учтён services/llm.py — единственный файл, который реально расходится между ВМ и репой. При копировании бэкенда надо брать версию из репы (она новее?) или с ВМ — надо выяснить.
3. JS-файлы — Opus предлагает копировать, но не уточняет что VM_API зашит в app.js (строка 3). Это единственное место, которое надо менять.
4. Чат (Ф5) — предлагает перенести на ВМ, но chat.cfm в Lucee всё равно сломан. Имеет смысл сделать чат сразу правильно, а не портировать сломанное.
5. Нет упоминания tests.js — на ВМ этого файла нет, но в репе есть. Надо включить в новый стек.

Вердикт

План рабочий, но требует уточнений по пунктам выше. Главная ценность — Opus правильно понял архитектуру и предложил изоляцию. Детали (managed-деплой, llm.py, чат) надо доработать.

---

Текущее состояние (на 2026-06-27)

• ✅ DNS check.kube5s.ru → 5.172.178.213
• ✅ Пустой репо contracts-flask (.gitignore создан)
• ✅ contractor/deploy/ подтверждён как зеркало ВМ
• ✅ Мусорные файлы на ВМ помечены
• ✅ Документация vm-layout.md создана
• ❌ Nginx для check.kube5s.ru не настроен
• ❌ Нет дампа схемы БД
• ❌ Не выбран managed-домен для Flask-морды
• ❌ Не выяснено, какая версия services/llm.py правильная (ВМ или репа)