8.2 KiB
Комбайн: архитектура и вектор развития
Дата: 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. Разъёмы и интерфейсы
Партнёр спрашивает «какие разъёмы». Нужно структурировать порты:
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.