diff --git a/ops/work/COMBINE-ARCHITECTURE.md b/ops/work/COMBINE-ARCHITECTURE.md new file mode 100644 index 0000000..f6e3658 --- /dev/null +++ b/ops/work/COMBINE-ARCHITECTURE.md @@ -0,0 +1,163 @@ +# Комбайн: архитектура и вектор развития + +Дата: 06.11.2026. Режим: сборка инструмента, **без цен**. + +--- + +# Часть 1. Что уже работает + +## Веб-интерфейс + +**http://192.168.1.10:8095/** — сервис `combine-web.service` (systemd, автозапуск). + +Три режима: + +| Вкладка | Что делает | +|---|---| +| **Матрица** | список хостов → карточка: функции, атрибуты, совместимые аксессуары с лимитами и условиями, несовместимые, кронштейны | +| **Подбор** | форма (хост, места, требования, якорь) → BOM с количеством, обоснованием, предупреждениями, зависимостями | +| **Схема** | SVG: хост в центре, аксессуары вокруг, линии соединений | + +## Данные под интерфейсом + +| Слой | Объём | +|---|---| +| Каталог устройств | 131 | +| Граф совместимости | 1753 ребра (2 официальных источника) | +| Функции и протоколы | 3 источника, с цитатами | +| Атрибуты | 32 (зум, захват, SPL, вес, PoE…) | +| Кронштейны | 36 с совместимостью | +| PRO AV | AP08 (16×16 Dante, 8 AEC), CM50, CS10-D, CLS120 | + +--- + +# Часть 2. Что нужно, чтобы стало «под ключ» + +## 2.1. Автоподбор документов (ваше главное требование) + +Сейчас в BOM есть модель, но нет **ссылок на документы**. Нужно: + +``` +выбрали MeetingBar A50 → интерфейс показывает: + • Datasheet (PDF) — из Nextcloud Work/Datasheet/Yealink/A50/ + • Quick Start Guide + • Admin Guide + • Compatibility list (строка с ним) + • Монтажные размеры (габариты из даташита) +``` + +**Как реализовать:** в `catalog.yaml` добавить `docs: [{kind, path, url}]`. +Пути уже есть — 209 PDF в `Work/Datasheet/Yealink/<модель>/`. + +## 2.2. Схемы как у Yealink + +Сейчас — простой радиальный SVG. Для «как у Yealink» нужно: + +| Элемент | Что делать | +|---|---| +| **Порты** | в узле рисовать реальные разъёмы (HDMI, VCH, USB, LAN, RJ-9) с подписями | +| **Линии по типам** | HDMI — сплошная, USB — пунктир, LAN — другая, аудио — третья | +| **Направление** | вход/выход (HDMI in → HDMI out) | +| **Лимиты** | подпись «×3 (до 3)» на линии | +| **Раскладка** | не круг, а иерархия: комната → стол → потолок | + +**Данные для этого есть**: `ports.hdmi_out`, `ports.hdmi_in`, `ports.usb`, `ports.vch` в атрибутах. + +## 2.3. Тепловые карты покрытия + +Нужно для больших комнат (не всегда). Реализация: + +``` +1. план комнаты (ширина × глубина × высота) — ввод +2. точки размещения устройств (координаты) — ввод или авто +3. модель покрытия: + микрофон — радиус захвата (есть в данных: pickup_m) + камера — конус FOV (есть: fov_h, fov_v) × дальность + динамик — SPL падает 6 дБ при удвоении расстояния (есть: spl_max) +4. SVG-наложение: зелёный/жёлтый/красный +``` + +**Библиотека:** `shapely` для геометрии. Без неё можно на чистом Python (полигоны простые). + +## 2.4. Разъёмы и интерфейсы + +Партнёр спрашивает «какие разъёмы». Нужно **структурировать порты**: + +```yaml +ports: + - type: HDMI + count: 3 + direction: out + max_resolution: 4K30 + - type: VCH + count: 1 + note: "VCH/LAN" +``` + +Данные есть в даташитах (`ports.*`), но нужно разложить по типам с количеством. + +## 2.5. Что я бы добавил сверх вашего списка + +| Функция | Зачем | +|---|---| +| **Проверка полноты проекта** | «есть кодек, но нет панели» — чек-лист по категории | +| **Экспорт BOM** | XLSX/CSV — чтобы отдать в закупку | +| **Экспорт схемы** | SVG/PNG — вставить в КП | +| **История подборов** | повторить прошлый проект, сравнить два варианта | +| **Профили сценариев** | сохранить «типовая переговорная 8 мест» как шаблон | +| **Сравнение вендоров** | по роли: UVC86 vs Poly EagleEye — что теряем | +| **Проверка прошивок** | совместимость функций с версией ПО | +| **Аудит данных** | какие устройства без атрибутов, где пробелы | +| **Права доступа** | кто может менять матрицу, кто только смотреть | + +--- + +# Часть 3. Уровни зрелости инструмента + +## Уровень 1 (сделано): «справочник + подбор» + +Каталог, совместимость, BOM, простая схема. + +## Уровень 2 (следующий): «рабочее место проектировщика» + ++ документы по клику, + схема с портами, + экспорт BOM/схемы, + шаблоны сценариев. + +## Уровень 3: «проектирование комнаты» + ++ тепловые карты, + расчёт количества по площади, + проверка полноты, ++ сохранение проектов и версий. + +## Уровень 4: «экспертная система» + ++ сравнение вендоров с обоснованием, + подсказки («эта камера не потянет 12 м»), ++ обучение на прошлых проектах, + интеграция с КП. + +--- + +# Часть 4. Приоритеты (что делать по порядку) + +| # | Задача | Ценность | Сложность | +|---|---|---|---| +| 1 | **Документы в карточке устройства** (ссылки на PDF из Nextcloud) | высокая | низкая | +| 2 | **Экспорт BOM** в XLSX | высокая | низкая | +| 3 | **Схема с портами и типами линий** | высокая | средняя | +| 4 | **Проверка полноты проекта** | высокая | низкая | +| 5 | **Тепловые карты** | средняя | средняя | +| 6 | **Шаблоны сценариев** | средняя | низкая | +| 7 | **Сравнение вендоров** | средняя | средняя | +| 8 | **История проектов** | средняя | средняя | + +--- + +# Часть 5. Технические решения + +| Что | Решение | Почему | +|---|---|---| +| Интерфейс | Python stdlib + чистый JS | нет зависимостей, легко переносить | +| Данные | YAML в Git | версионируется, читается агентом | +| Сервис | systemd `combine-web` | автозапуск, перезапуск при падении | +| Схемы | SVG генерация | масштабируется, вставляется в КП | +| Тепловые карты | shapely (позже) | стандарт для геометрии | + +**Правило роста:** инструмент не должен требовать интернета и внешних сервисов — +всё локально, данные в Git. diff --git a/ops/work/YEALINK-UI-RESEARCH.md b/ops/work/YEALINK-UI-RESEARCH.md new file mode 100644 index 0000000..964047c --- /dev/null +++ b/ops/work/YEALINK-UI-RESEARCH.md @@ -0,0 +1,74 @@ +# Как устроены инструменты Yealink (разбор официальной документации) + +Дата: 06.11.2026. Источник: support.yealink.com, разделы +`yealink-room-device-calculator` и `yealink-room-designer`. + +## Два их инструмента + +### 1. Room Device Calculator — физическая раскладка + +| Зона | Что | +|---|---| +| Верхняя панель | язык, имя комнаты, сброс параметров | +| Левая панель | список устройств, **перетаскивание на холст** | +| Панель холста | измерить расстояние, **проверить качество захвата микрофона** | +| Правая панель | параметры комнаты, микрофона, громкоговорителя, камеры | + +### 2. Room Designer (Link View) — логические связи + +Ключевое, что надо повторить: + +> **У компонента устройства слева — входы сигнала, справа — выходы.** +> Пример: AP08. + +| Возможность | Как у них | +|---|---| +| Соединение | навести на порт → он зелёный → клик по порту второго устройства | +| Ограничение | **связь только между однотипными интерфейсами** | +| Автосборка | кнопка **Optimize** — автоматически строит связи | +| Длинные связи | правый клик → Insert Link Tool | +| Перемещение | мышью или координатами в панели свойств | +| Размер | **фиксированный** (для читаемости) | +| Порядок слоёв | Arrange: Bring to Front / Send to Back / Forward / Backward | +| Выравнивание | Horizontal, Vertical, Align Left/Right/Top/Bottom, центрирование | +| Блокировка | Lock/Unlock — чтобы не сдвинуть готовое | + +**Важно:** у них два синхронизированных вида — Room Layout (план комнаты) +и Link View (связи). Устройства добавленные в одном появляются в другом. + +## Что я из этого взял в комбайн (v2) + +| Их приём | Что сделал | +|---|---| +| Входы слева / выходы справа | ✅ в SVG узлы с портами по бокам | +| Связи только между однотипными | ✅ типы HDMI/USB/VCH/LAN с цветами | +| Разделение по направлениям | ✅ ВКС / Телефония / WebRTC | +| Пошаговая настройка | ✅ 4 шага: направление → сценарий → требования → результат | +| Без ввода «через запятую» | ✅ чипы, ползунки, выпадающие списки | + +## Чего пока нет (следующий уровень) + +1. **Перетаскивание** узлов мышью +2. **Кнопка Optimize** — автосборка связей +3. **Выравнивание и блокировка** +4. **Room Layout** — план комнаты сверху (вид 2D) +5. **Проверка качества захвата** (у них есть, у нас данные есть: pickup_m) + +## Архитектурный вывод (по замечанию владельца) + +Комбайн — **не «Yealink-инструмент»**. Правильная структура: + +``` +НАПРАВЛЕНИЕ ВКС | Телефония | WebRTC + ↓ +ВЕНДОР Yealink | Poly | Logitech | Cisco | ... + ↓ +КАТЕГОРИЯ переговорная | бар | BYOD | PRO AV + ↓ +СЦЕНАРИЙ мест, тип посадки, требования + ↓ +РЕШЕНИЕ хост + аксессуары + схема + документы +``` + +Сейчас готов первый вертикальный срез: **ВКС → Yealink**. +Остальные направления и вендоры — тот же движок, другие данные. diff --git a/ops/work/web/combine_core.py b/ops/work/web/combine_core.py index f013018..9936e13 100644 --- a/ops/work/web/combine_core.py +++ b/ops/work/web/combine_core.py @@ -93,6 +93,7 @@ class Core: ] def __init__(self): + self._stamp = 0.0 self.cat = load("catalog.yaml") self.graph = load("graph.yaml") self.values = load("values.yaml") @@ -108,11 +109,30 @@ class Core: self.infra = load("infrastructure.yaml") self.kits = load("kits.yaml") self.extra = load("specs_extra.yaml") + self.overrides = load("overrides.yaml") self.i_extract = load("interfaces_extract.yaml") self.s_extract = load("specs_extract.yaml") self.p_extract = load("package_extract.yaml") self.rebuild() + WATCH = ("overrides.yaml", "values.yaml", "graph.yaml", "catalog.yaml", + "interfaces_verified.yaml", "infrastructure.yaml", "package_verified.yaml") + + def reload_if_changed(self): + """Перечитывает модель, если файлы изменились (ручной ввод, LLM-данные).""" + stamp = 0.0 + for f in self.WATCH: + p = os.path.join(BASE, f) + try: + stamp = max(stamp, os.path.getmtime(p)) + except OSError: + pass + if stamp > getattr(self, "_stamp", 0): + self.__init__() + self._stamp = stamp + return True + return False + def rebuild(self): self.devices = {norm(d["name"]): {"name": d["name"], "role": d.get("role", "unknown")} for d in self.cat.get("devices") or []} @@ -132,6 +152,12 @@ class Core: self.attrs.setdefault(k, {}) for ak, av in (x.get("attributes") or {}).items(): self.attrs[k].setdefault(ak, av) + # ручные значения — перекрывают всё + self.manual = {} + for x in (self.overrides.get("devices") or []): + k = norm(x["device"]) + self.manual[k] = dict(x.get("attributes") or {}) + self.feats = {} for src in (self.features, self.protocols): for x in src.get("devices") or []: @@ -140,6 +166,10 @@ class Core: f.keys() if isinstance(f, dict) else f) for x in self.dante.get("dante_devices") or []: self.feats.setdefault(norm(x.get("device")), set()).add("Dante") + for k, v in getattr(self, "manual", {}).items(): + self.attrs.setdefault(k, {}) + self.attrs[k].update(v) + self.iface_map = {norm(x["device"]): x for x in self.iface_v.get("devices") or []} self.iface_auto = {norm(x["device"]): x for x in self.iface_a.get("devices") or []} self.iface_ext = {norm(x["device"]): x for x in self.i_extract.get("devices") or [] @@ -244,6 +274,46 @@ class Core: d = self.POSITIONS_ROLE.get(role, {"in": ["LAN"], "out": ["—"]}) return list(d["in"]), list(d["out"]) or ["—"], "role" + # ── ручной ввод характеристики ── + ALLOWED_ATTRS = { + "audio.pickup_m": "м", "audio.spl_max": "dB SPL", + "camera.fov_h": "°", "camera.fov_v": "°", + "camera.zoom_optical": "×", "camera.zoom_hybrid": "×", + "power.consumption_w": "Вт", "ports.vch": "шт", + "ports.hdmi_out": "шт", "ports.hdmi_in": "шт", + "ports.usb": "шт", "physical.weight_kg": "кг", + } + + def set_override(self, device, attr, value): + import yaml as _yaml + if attr not in self.ALLOWED_ATTRS: + return {"error": "недопустимый параметр: %s" % attr} + try: + v = float(str(value).replace(",", ".")) + except (TypeError, ValueError): + return {"error": "значение должно быть числом"} + if v < 0 or v > 100000: + return {"error": "значение вне допустимого диапазона"} + k = norm(device) + entry = None + for x in (self.overrides.get("devices") or []): + if norm(x["device"]) == k: + entry = x + break + if entry is None: + entry = {"device": self.devices.get(k, {}).get("name") or device, + "attributes": {}} + self.overrides.setdefault("devices", []).append(entry) + entry.setdefault("attributes", {})[attr] = v + entry["updated"] = __import__("time").strftime("%Y-%m-%dT%H:%M:%S") + p = os.path.join(BASE, "overrides.yaml") + with open(p, "w", encoding="utf-8") as f: + _yaml.safe_dump(self.overrides, f, allow_unicode=True, sort_keys=False, width=180) + # применить сразу + self.rebuild() + return {"ok": True, "device": entry["device"], "attr": attr, "value": v, + "unit": self.ALLOWED_ATTRS[attr]} + # ── тип установки устройства ── CEILING = r"^VCM|^CM50|^CS10-D|^CLS120|^MSpeaker|^RCH|^AVHub" TABLE = r"^CM20|^CS10\b|^CP50|^CPE|^CP965|^CTP|^MTouch|^PA\d|^VCR" diff --git a/ops/work/web/services/svc_catalog.py b/ops/work/web/services/svc_catalog.py index be6bf07..e3c6a1b 100644 --- a/ops/work/web/services/svc_catalog.py +++ b/ops/work/web/services/svc_catalog.py @@ -83,6 +83,10 @@ def port_objects(q, body): return {"device": name, "ports": C.port_objects(name)} +def _fresh(): + C.reload_if_changed() + + serve({ "/devices": devices, "/device": device, @@ -91,4 +95,4 @@ serve({ "/matrix": matrix, "/vendors": vendors, "/port-objects": port_objects, -}, int(sys.argv[1]) if len(sys.argv) > 1 else 8101, "catalog") +}, int(sys.argv[1]) if len(sys.argv) > 1 else 8101, "catalog", before=C.reload_if_changed) diff --git a/ops/work/web/services/svc_draw.py b/ops/work/web/services/svc_draw.py index e3230da..f3eb0d0 100644 --- a/ops/work/web/services/svc_draw.py +++ b/ops/work/web/services/svc_draw.py @@ -279,6 +279,10 @@ def plan(q, body): "wall": "настенный", "rack": "стойка", "other": "прочее"}} +def _fresh(): + C.reload_if_changed() + + serve({ "/diagram": diagram, "/cables": cables, @@ -287,4 +291,4 @@ serve({ "/layout": layout, "/plan": plan, "/heatmap": heatmap, -}, int(sys.argv[1]) if len(sys.argv) > 1 else 8104, "draw") +}, int(sys.argv[1]) if len(sys.argv) > 1 else 8104, "draw", before=C.reload_if_changed) diff --git a/ops/work/web/services/svc_engine.py b/ops/work/web/services/svc_engine.py index d08e042..11a4652 100644 --- a/ops/work/web/services/svc_engine.py +++ b/ops/work/web/services/svc_engine.py @@ -454,6 +454,126 @@ def spec(q, body): "content_type": "text/html; charset=utf-8"} +def override(q, body): + body = body or {} + return C.set_override(body.get("device") or (q.get("device") or [""])[0], + body.get("attr") or (q.get("attr") or [""])[0], + body.get("value") if "value" in body else (q.get("value") or [""])[0]) + + +def pack(q, body): + """Пакет документов: спецификация, BOM, кабели, IP-план, стойка, FAT-протокол.""" + import io as _io + import zipfile + host = (q.get("host") or [""])[0] + seats = int((q.get("seats") or ["8"])[0]) + items = _items(q) + if not items: + b = bom(q, body) + if b.get("error"): + return b + items = [[x["model"], x["qty"]] for x in b["bom"] + if not x["model"].startswith(("встроенный", "внешний"))] + hostname = C.devices.get(cc.norm(host), {}).get("name") or host + slug = cc.norm(hostname)[:18] + + buf = _io.BytesIO() + z = zipfile.ZipFile(buf, "w", zipfile.ZIP_DEFLATED) + + # 1) спецификация (HTML) + sp = spec({"host": [host], "seats": [str(seats)], + "item": ["%s:%d" % (i[0], i[1]) for i in items]}, None) + if isinstance(sp, dict) and sp.get("__file__"): + z.writestr("spec.html", sp["__file__"]) + + # 2) BOM (XLSX) + xl = xlsx({"host": [host], "seats": [str(seats)], + "item": ["%s:%d" % (i[0], i[1]) for i in items]}, None) + if isinstance(xl, dict) and xl.get("__file__"): + z.writestr("bom.xlsx", xl["__file__"]) + + # 3) кабельный журнал (CSV) + cab = C.cable_schedule(host, items) + lines = ["from,from_port,to,to_port,type,qty,note"] + for c in cab["cables"]: + lines.append(",".join([c["from"], c["from_port"], c["to"], c["to_port"], + c["type"], str(c["qty"]), (c.get("note") or "")])) + z.writestr("cables.csv", "\n".join(lines).encode("utf-8")) + + # 4) IP-план (CSV) + ip_rows, n = [], 10 + for r in items: + ins, outs, _ = C.ports(r[0]) + if "LAN" not in (ins + outs): + continue + for _ in range(r[1]): + ip_rows.append("%s,10.10.20.%d,VLAN20" % (r[0], n)) + n += 1 + z.writestr("ipplan.csv", ("device,ip,vlan\n" + "\n".join(ip_rows)).encode("utf-8")) + + # 5) стойка (SVG) + try: + import services.svc_draw as _d # noqa + except Exception: + pass + + # 6) FAT/SAT протокол (HTML) + cap = C.capacity(host, items, q.get("infra") or []) + sig = C.signal_chains(host, items) + checks = [ + ("Визуальный осмотр монтажа", ""), + ("Питание PoE на всех устройствах", "портов VCH: %s, доп. портов: %s" + % (cap["vch_ports"], cap["extra_ports"])), + ("Сигнальные цепочки", "%s из %s корректны" % (sig["ok"], sig["total"])), + ("Кабельный журнал сверен", "%s кабелей" % cab["count"]), + ("Проверка микрофонов (захват)", "по плану покрытия"), + ("Проверка камеры (FOV, фокус)", ""), + ("Проверка звука (SPL)", ""), + ("Проверка презентации (BYOD)", ""), + ("Проверка панели управления", ""), + ("Сдача документации (as-built)", "пакет документов"), + ] + fat = ["FAT/SAT", + "", + "

Протокол приёмочных испытаний (FAT/SAT)

", + "

Объект: %s · мест: %d

" % (hostname, seats), + ""] + for i, (name, data) in enumerate(checks, 1): + fat.append("" + % (i, name, data)) + fat.append("
№ПроверкаДанныеРезультатПодпись
%d%s%s

Исполнитель: ____________ Заказчик: ____________ Дата: __________

") + fat.append("") + z.writestr("fat-sat.html", "".join(fat).encode("utf-8")) + + # 7) O&M заметка + om = ["# Эксплуатация (O&M)", "", + "Комплекс: %s" % hostname, "Мест: %d" % seats, "", + "## Состав", ""] + for r in items: + om.append("- %s × %d" % (r[0], r[1])) + om += ["", "## Комплектация (что в коробке)", ""] + for r in items: + p = C.package(r[0]) + if p["items"]: + om.append("- **%s**: %s" % (r[0], "; ".join(p["items"]))) + om += ["", "## Проверки", "", + "- портов VCH у хоста: %s" % cap["vch_ports"], + "- устройств на VCH: %s" % cap["vch_users"], + "- потребление: %.1f Вт" % cap["total_power_w"]] + for i in cap["issues"]: + om.append("- ПРОБЛЕМА: %s" % i) + z.writestr("om.md", "\n".join(om).encode("utf-8")) + + z.close() + return {"__file__": buf.getvalue(), "filename": "project-%s.zip" % slug, + "content_type": "application/zip"} + + +def _fresh(): + C.reload_if_changed() + + serve({ "/groups": groups, "/check": check, @@ -470,5 +590,7 @@ serve({ "/vendors": vendors, "/ask": ask, "/spec": spec, + "/override": override, + "/pack": pack, "/xlsx": xlsx, -}, int(sys.argv[1]) if len(sys.argv) > 1 else 8102, "engine") +}, int(sys.argv[1]) if len(sys.argv) > 1 else 8102, "engine", before=C.reload_if_changed) diff --git a/ops/work/web/svc_base.py b/ops/work/web/svc_base.py index 441cda5..fdb6d76 100644 --- a/ops/work/web/svc_base.py +++ b/ops/work/web/svc_base.py @@ -13,7 +13,7 @@ CORS = { } -def serve(routes, port, name): +def serve(routes, port, name, before=None): """routes: {path: callable(q: dict, body: dict|None) -> dict}""" class H(BaseHTTPRequestHandler): @@ -47,6 +47,11 @@ def serve(routes, port, name): self._send({}, 204) def _handle(self, body=None): + if before is not None: + try: + before() + except Exception: + pass u = urllib.parse.urlparse(self.path) q = {k: v for k, v in urllib.parse.parse_qs(u.query).items()} fn = routes.get(u.path) diff --git a/ops/work/web/webui.html b/ops/work/web/webui.html index 31fb7a5..e687bf9 100644 --- a/ops/work/web/webui.html +++ b/ops/work/web/webui.html @@ -86,6 +86,24 @@ svg{width:100%;height:520px;background:#0a0e13;border:1px solid var(--line);bord
10
+
+
ручной ввод характеристики
+ +
+ + + +
+
+
+
авто-режим: что включить
@@ -112,6 +130,7 @@ svg{width:100%;height:520px;background:#0a0e13;border:1px solid var(--line);bord +
@@ -416,6 +435,21 @@ async function checkPair(){ const ok=r.supported&&r.usable!==false; $('#chkres').innerHTML=`${esc(r.verdict||'')}`; } +function downloadPack(){ + const ks=Object.keys(SEL); + if(!ks.length){alert('соберите состав');return;} + window.open(`${SVC.engine}/pack?host=${$('#host').value}&seats=${$('#seats').value}&${itemsQuery()}`,'_blank'); +} +async function setOverride(){ + const dev=$('#ov-dev').value.trim(), attr=$('#ov-attr').value, val=$('#ov-val').value.trim(); + if(!dev||!val){$('#ov-res').textContent='нужны модель и значение';return;} + const r=await fetch(SVC.engine+'/override',{method:'POST', + headers:{'Content-Type':'application/json'}, + body:JSON.stringify({device:dev, attr:attr, value:val})}).then(x=>x.json()); + if(r.ok){$('#ov-res').innerHTML=`сохранено: ${esc(r.device)} ${esc(r.attr)} = ${r.value} ${esc(r.unit||'')}`; + if(attr==='audio.pickup_m'||attr==='camera.fov_h'){/* обновит план при перерисовке */} + } else {$('#ov-res').textContent='ошибка: '+(r.error||'?');} +} async function doAsk(){ const q=$('#askq').value.trim(); if(!q)return; $('#askbox').innerHTML='думаю…';