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