Files
buryan-infra/ops/work/DRAW-MANUAL.md
T

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`,
в браузере — только в поле ввода (не сохраняется).