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

68 lines
3.4 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.
# Ручной редактор схем 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`:
```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`,
а не как каталог.