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

164 lines
8.2 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Комбайн: архитектура и вектор развития
Дата: 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.