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