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

69 lines
3.6 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Ручной редактор схем на 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" разбиралась как позиция).