diff --git a/ops/work/TERMINALS.md b/ops/work/TERMINALS.md new file mode 100644 index 0000000..3f40905 --- /dev/null +++ b/ops/work/TERMINALS.md @@ -0,0 +1,69 @@ +# Терминалы: камеры и несколько устройств в схеме (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`). Это осознанно: владелец сам решает состав, +а предупреждение о несовместимости остаётся в матрице. diff --git a/ops/work/web/services/svc_catalog.py b/ops/work/web/services/svc_catalog.py index e3c6a1b..47b4e2b 100644 --- a/ops/work/web/services/svc_catalog.py +++ b/ops/work/web/services/svc_catalog.py @@ -46,9 +46,14 @@ def ports(q, body): def hosts(q, body): out = [] for k, v in C.devices.items(): - if v["role"] != "codec" or not C.edges.get(k): + role = v.get("role") + # терминалом может быть не только кодек: камера тоже самостоятельное + # устройство комнаты (10.11.2026 просьба владельца). + if role not in ("codec", "camera"): continue - out.append({"key": k, "name": v["name"], + if role == "codec" and not C.edges.get(k): + continue + out.append({"key": k, "name": v["name"], "kind": role, "accessories": len(C.edges_of(k)), "completeness": C.completeness(k)}) return {"hosts": sorted(out, key=lambda x: x["name"])} diff --git a/ops/work/web/services/svc_engine.py b/ops/work/web/services/svc_engine.py index 9f2b5af..e51f69b 100644 --- a/ops/work/web/services/svc_engine.py +++ b/ops/work/web/services/svc_engine.py @@ -61,6 +61,46 @@ def groups(q, body): if items: out.append({"id": g["id"], "name": g["name"], "hint": "", "items": sorted(items, key=lambda x: x["model"])}) + # ── терминалы: вторым устройством в схеме может быть другой терминал ── + # (RoomCast E2 + UVC86 и т.п.). Берём по совместимости портов, не по графу. + h_in, h_out, _ = C.ports(C.devices[hk]["name"]) + t_items = [] + for k2, v2 in C.devices.items(): + if k2 == hk or v2.get("role") not in ("codec", "camera"): + continue + a_in, a_out, _ = C.ports(v2["name"]) + ports = [p for p in (a_in + a_out) if p != "—"] + if not ports: + continue + if any((p, q) in C.LINKABLE or (q, p) in C.LINKABLE + for p in ports for q in (h_in + h_out) if q != "—"): + t_items.append({"model": v2["name"], "role": v2.get("role"), + "max_qty": 1, "condition": "совместим по портам"}) + if t_items and hk in C.devices: + have = {i["model"] for g in out for i in g["items"]} + t_items = [x for x in t_items if x["model"] not in have] + if t_items: + out.append({"id": "terminal", "name": "Терминалы (можно несколько)", + "hint": "второй терминал в одной схеме", + "items": sorted(t_items, key=lambda x: x["model"])[:40]}) + + # ── если у хоста нет связей в графе (камера-терминал) — список по портам ── + if not out: + comp = [] + for k2, v2 in C.devices.items(): + if k2 == hk: + continue + a_in, a_out, _ = C.ports(v2["name"]) + ports = [p for p in (a_in + a_out) if p != "—"] + if any((p, q) in C.LINKABLE or (q, p) in C.LINKABLE + for p in ports for q in (h_in + h_out) if q != "—"): + comp.append({"model": v2["name"], "role": v2.get("role"), + "max_qty": 1, "condition": "совместим по портам"}) + if comp: + out.append({"id": "byports", "name": "Совместимые по портам", + "hint": "у этого терминала нет связей в графе", + "items": sorted(comp, key=lambda x: x["model"])[:60]}) + return {"host": C.devices[hk]["name"], "groups": out, "completeness": C.completeness(hk)}