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