69 lines
3.5 KiB
Markdown
69 lines
3.5 KiB
Markdown
# Ручной режим схем в Комбайне (12.11.2026)
|
|
|
|
## Задача
|
|
|
|
Авто-схема (`svc_draw.py`, :8104) расставляет узлы по жёсткому алгоритму
|
|
(центр + два столбца) — на практике получается нечитаемо. Нужно было дать
|
|
возможность поправить схему **руками**: подвинуть, подписать, дорисовать.
|
|
|
|
## Что сделано
|
|
|
|
### Сервис `combine-drawedit` (:8106)
|
|
|
|
Новый файл `ops/work/web/services/svc_drawedit.py`:
|
|
|
|
| Маршрут | Назначение |
|
|
|---|---|
|
|
| `GET /editor` | страница-редактор (SVG, мышь) |
|
|
| `GET /load?host=…` | узлы авто-раскладки + сохранённые позиции |
|
|
| `POST /save` | сохранить раскладку (нужен `X-Token` с правом записи) |
|
|
| `GET /render?host=…` | готовый SVG из сохранённой раскладки |
|
|
|
|
Раскладки: `/opt/work-hub/compat/layouts/<хост>.json`
|
|
(узлы с координатами, подписи, линии).
|
|
|
|
### Возможности редактора
|
|
|
|
* **таскать узлы** мышью — позиция запоминается по имени устройства;
|
|
* **подписи** — кнопка «+ Подпись», текст перетаскивается;
|
|
* **линии** — кнопка «+ Линия», две точки кликом;
|
|
* **сохранить** — пишет раскладку (в аудит `audit.jsonl`);
|
|
* **сброс** — вернуть авто-раскладку;
|
|
* **экспорт SVG** — скачать готовую схему.
|
|
|
|
### Кнопка в интерфейсе
|
|
|
|
В разделе «Схема» добавлена кнопка **«Ручной режим»** → открывает редактор
|
|
для выбранного хоста и текущего состава.
|
|
|
|
### Правка общей базы
|
|
|
|
`svc_base.py` научился отдавать HTML: `{"__html": "..."}`.
|
|
Это точечное дополнение, остальные сервисы не затронуты.
|
|
|
|
## Проверка
|
|
|
|
```
|
|
GET :8106/editor?host=MeetingBar+A30&item=A40:2 → 200
|
|
GET :8106/load → 2 узла (A40 @175,185 · CPE40 @925,435)
|
|
POST :8106/save (X-Token) → ok: узлов 1, подписей 1, линий 1
|
|
GET :8106/render → SVG с подписью и линией
|
|
UI :8095 → кнопка «Ручной режим» есть
|
|
```
|
|
|
|
Все сервисы Комбайна active: web, catalog, engine, project, draw, docs, drawedit.
|
|
|
|
## Как пользоваться
|
|
|
|
1. Открыть Комбайн (`http://192.168.1.10:8095`), собрать состав.
|
|
2. Раздел **Схема** → кнопка **«Ручной режим»**.
|
|
3. Подвинуть узлы, добавить подписи/линии.
|
|
4. Ввести `X-Token` (роль editor/admin из `compat/access.yaml`) → **Сохранить**.
|
|
5. «Экспорт SVG» — забрать картинку.
|
|
|
|
## Ловушка
|
|
|
|
`/save` защищён токеном (общий механизм `svc_base`): без заголовка `X-Token`
|
|
с правом записи вернётся 403. Токен хранится в `compat/access.yaml`,
|
|
в браузере — только в поле ввода (не сохраняется).
|