# Ручной редактор схем на 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/.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" разбиралась как позиция).