Files
buryan-infra/ops/work/CANVAS-DRAWIO.md
T

3.6 KiB
Raw Blame History

Ручной редактор схем на draw.io (12.11.2026)

Что было не так

Мой самодельный редактор (combine-drawedit, :8106) умел только таскать узлы авто-схемы, добавлять подписи и линии. Владельцу нужно больше: добавлять устройства вручную, рисовать кабели, свободные фигуры. Самодельный редактор это не покрывал.

Решение: готовый редактор draw.io

Взят зрелый продукт — draw.io (embed.diagrams.net). В нём есть всё: библиотека фигур, коннекторы для кабелей, подписи, свободное рисование, группировка, экспорт SVG/PNG/PDF.

Сервис combine-canvas (:8107)

Маршрут Назначение
GET /canvas?host=…&item=… страница: панель + встроенный draw.io
GET /canvas/xml?host=… стартовая схема (mxGraph XML из port_plan)
POST /canvas/save сохранить схему (нужен X-Token)

Сохранение: /opt/work-hub/compat/layouts/<хост>.drawio.xml.

Как это работает

  1. Открывается авто-схема текущего состава как обычная диаграмма draw.io: терминал в центре, устройства вниз, кабели подписаны портами (out:USB → USB), проблемные — пунктиром и красным.
  2. Дальше владелец правит руками: тащит блоки, добавляет новые устройства из палитры draw.io, рисует кабели коннекторами, ставит подписи.
  3. Сохранить пишет XML в проект (кнопка в верхней панели).
  4. Скачать .drawio — файл для draw.io desktop.
  5. Сброс — вернуть авто-схему.

Проверено

GET  :8107/canvas           → 200
GET  :8107/canvas/xml       → 1930 байт, XML корректный, 4 вершины, 3 ребра
POST :8107/canvas/save      → {"ok": true, "bytes": 209}
файл                        → /opt/work-hub/compat/layouts/<host>.drawio.xml
кнопка в UI                 → открывает :8107/canvas

Попытка self-hosted draw.io (не удалась)

Пробовал поднять jgraph/drawio в Docker на порту 8097: контейнер падает

java.io.IOException: Permission denied
  at sun.security.pkcs12.PKCS12KeyStore.setKeyEntry

— entrypoint генерирует keystore в недоступный каталог. Попытки --user root и --tmpfs не помогли. Поэтому используется официальный embed-хостинг diagrams.net (доступен с хоста: HTTP 200).

Если интернет в браузере недоступен — draw.io не загрузится. Тогда либо доводим self-hosted образ, либо остаётся простой редактор combine-drawedit (:8106).

Ловушка

port_plan ожидает список позиций [[модель, кол-во], …], а не словарь параметров запроса. Первая версия передала q целиком — падало с invalid literal for int(): 'o' (строка "host" разбиралась как позиция).