# Комбайн: архитектура и вектор развития Дата: 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.