Files
buryan-infra/ops/work/DRAW-MANUAL.md
T

3.5 KiB
Raw Blame History

Ручной режим схем в Комбайне (12.11.2026)

Задача

Авто-схема (svc_draw.py, :8104) расставляет узлы по жёсткому алгоритму (центр + два столбца) — на практике получается нечитаемо. Нужно было дать возможность поправить схему руками: подвинуть, подписать, дорисовать.

Что сделано

Сервис combine-drawedit (:8106)

Новый файл ops/work/web/services/svc_drawedit.py:

Маршрут Назначение
GET /editor страница-редактор (SVG, мышь)
GET /load?host=… узлы авто-раскладки + сохранённые позиции
POST /save сохранить раскладку (нужен X-Token с правом записи)
GET /render?host=… готовый SVG из сохранённой раскладки

Раскладки: /opt/work-hub/compat/layouts/<хост>.json (узлы с координатами, подписи, линии).

Возможности редактора

  • таскать узлы мышью — позиция запоминается по имени устройства;
  • подписи — кнопка «+ Подпись», текст перетаскивается;
  • линии — кнопка «+ Линия», две точки кликом;
  • сохранить — пишет раскладку (в аудит audit.jsonl);
  • сброс — вернуть авто-раскладку;
  • экспорт SVG — скачать готовую схему.

Кнопка в интерфейсе

В разделе «Схема» добавлена кнопка «Ручной режим» → открывает редактор для выбранного хоста и текущего состава.

Правка общей базы

svc_base.py научился отдавать HTML: {"__html": "..."}. Это точечное дополнение, остальные сервисы не затронуты.

Проверка

GET :8106/editor?host=MeetingBar+A30&item=A40:2     → 200
GET :8106/load                                     → 2 узла (A40 @175,185 · CPE40 @925,435)
POST :8106/save (X-Token)                          → ok: узлов 1, подписей 1, линий 1
GET :8106/render                                   → SVG с подписью и линией
UI :8095                                           → кнопка «Ручной режим» есть

Все сервисы Комбайна active: web, catalog, engine, project, draw, docs, drawedit.

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

  1. Открыть Комбайн (http://192.168.1.10:8095), собрать состав.
  2. Раздел Схема → кнопка «Ручной режим».
  3. Подвинуть узлы, добавить подписи/линии.
  4. Ввести X-Token (роль editor/admin из compat/access.yaml) → Сохранить.
  5. «Экспорт SVG» — забрать картинку.

Ловушка

/save защищён токеном (общий механизм svc_base): без заголовка X-Token с правом записи вернётся 403. Токен хранится в compat/access.yaml, в браузере — только в поле ввода (не сохраняется).