Files
buryan-infra/ops/work/TERMINALS.md
T

70 lines
3.8 KiB
Markdown

# Терминалы: камеры и несколько устройств в схеме (12.11.2026)
## Просьба владельца
1. Камеры удобно использовать **как терминал**.
2. Важно, чтобы терминальное устройство могло быть **не одно**
(например RoomCast E2 и UVC86 в одной схеме).
## Что было
* `/hosts` отдавал только роль `codec` — камеру нельзя было выбрать терминалом;
* группы совместимых устройств строились **только по графу** (`graph.yaml`).
У камеры связей в графе нет → список был пуст;
* второй терминал в схеме нельзя было добавить: в группах были только
аксессуары (микрофоны, панели, презентация, кронштейны, инфраструктура).
При этом движок `port_plan` уже умел связывать любые устройства по портам —
ограничение было на уровне выбора в интерфейсе.
## Что изменено
### 1. `/hosts` — терминалом может быть камера
```python
if role not in ("codec", "camera"):
continue
if role == "codec" and not C.edges.get(k): # у камеры связей может не быть
continue
```
В ответ добавлено поле `kind` (`codec` / `camera`).
### 2. `/groups` — группа «Терминалы (можно несколько)»
Собирается **по совместимости портов**, а не по графу: любое устройство
роли `codec`/`camera`, чьи порты соединяются с портами хоста.
Плюс запас: если у хоста вообще нет связей в графе (камера-терминал),
строится группа «Совместимые по портам».
## Проверка
```
/hosts: 47 терминалов (было 24) — 24 кодека + 23 камеры
A30: появилась группа «Терминалы (можно несколько)» — 40 позиций
камера-терминал (MB-12X Pro): 2 группы, 43 позиции
Схема A30 + RoomCast E2 + UVC86:
MeetingBar A30 LAN → Roomcast E2 LAN
MeetingBar A30 out:USB → UVC86 USB
кабелей: 2 · нерешённых: 0
```
## Вывод по вопросу «может ли терминалов быть несколько»
**Да, уже работает.** Терминал-хост — один (от него считаются порты и схема),
остальные терминалы добавляются в состав как устройства и подключаются
по портам. Пример выше: A30 (хост) + RoomCast E2 + UVC86.
Ограничение, которое стоит знать: **схема строится от одного хоста** —
если нужно два равноправных терминала (например, два RoomCast в большой
комнате), один из них будет «главным» в расчёте портов.
## Ловушка
Список терминалов строится по портам, поэтому в него попадают и устройства,
которые по графу несовместимы с хостом (например A30 + внешняя камера:
в графе `supported: false`). Это осознанно: владелец сам решает состав,
а предупреждение о несовместимости остаётся в матрице.