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

3.4 KiB
Raw Blame History

Ручной редактор схем v2 (Cytoscape.js, локально) — 12.11.2026

Почему переделан

Первая версия (draw.io через embed) зависела от внешнего сайта и не давала владельцу «просто взять и сделать». Вторая версия — свой редактор на Cytoscape.js, библиотека лежит на нашем сервере: интернет не нужен, всё в одном окне.

Что умеет

Действие Как
Добавить устройство левая панель, поиск, клик по названию
Добавить произвольный блок кнопка «+ Блок»
Соединить кабелем «+ Кабель» → клик по двум блокам
Переименовать двойной клик по блоку или кабелю
Удалить выделить → «Удалить»
Двигать / масштаб / панорама мышь (перетаскивание, колесо)
Авто-раскладка кнопка (сетка)
Сохранить в проект «Сохранить» (нужен X-Token)
Загрузить «Загрузить» — сохранённая или авто-схема
Экспорт «PNG»

Адрес

http://192.168.1.10:8107/canvas?host=<ключ>&item=<модель>:<кол-во>…

Или из Комбайна: раздел Схема → «Ручной режим».

При первом открытии подгружается схема из конструктора (узлы от port_plan, кабели с портами). Дальше правится руками.

Данные

/opt/work-hub/compat/layouts/<хост>.model.json:

{"host": "Roomcast E2",
 "nodes": [{"id": "host", "label": "Roomcast E2", "x": 420, "y": 40}],
 "edges": [{"source": "host", "target": "d0", "label": "out:USB → USB"}]}

Проверено

GET  :8107/canvas                 → 200 (7309 байт, cytoscape подключён)
GET  :8107/canvas/devices         → 200 (каталог)
GET  :8107/static/cytoscape.min.js → 200 (373 304 байта, локально)
GET  :8107/canvas/model?…         → узлов 3, связей 2 (авто-схема)
POST :8107/canvas/save            → {"ok": true, "nodes": 2, "edges": 1}
чтение обратно                    → saved: true

Что осталось

  1. Порты на кабеле — подпись задаётся вручную (двойной клик), автоматически из каталога не подставляется.
  2. Нет undo/redo — правки отменяются только «Загрузить».
  3. Проверка схемы (матрица, цепочки, батарея) считается конструктором, а не ручным редактором: ручная схема — документ, а не расчёт.

Ловушка

svc_base.serve маршрутизирует по точному пути — префиксных маршрутов нет. Поэтому статика отдаётся через явный маршрут /static/cytoscape.min.js, а не как каталог.