diff --git a/ops/work/CANVAS-DRAWIO.md b/ops/work/CANVAS-DRAWIO.md new file mode 100644 index 0000000..315083a --- /dev/null +++ b/ops/work/CANVAS-DRAWIO.md @@ -0,0 +1,68 @@ +# Ручной редактор схем на 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" разбиралась как позиция). diff --git a/ops/work/web/index.html b/ops/work/web/index.html index f46f505..a63bf3d 100644 --- a/ops/work/web/index.html +++ b/ops/work/web/index.html @@ -283,7 +283,7 @@ svg{width:100%;height:520px;background:#0a0e13;border:1px solid var(--line);bord """ + + +def canvas(q, body): + return {"__html": PAGE.replace("__DRAWIO__", DRAWIO)} + + +serve({ + "/canvas": canvas, + "/canvas/xml": load_xml, + "/canvas/save": save_xml, +}, int(sys.argv[1]) if len(sys.argv) > 1 else 8107, "canvas", + before=C.reload_if_changed)