Files
buryan-infra/ops/work/COMBINE-ARCHITECTURE.md

8.2 KiB
Raw Permalink Blame History

Комбайн: архитектура и вектор развития

Дата: 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/<модель>/.

Сейчас — простой радиальный 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. Разъёмы и интерфейсы

Партнёр спрашивает «какие разъёмы». Нужно структурировать порты:

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.