Files
buryan-infra/ops/work/SCENARIO-MODEL.md
T

153 lines
7.9 KiB
Markdown

# Модель сценариев: категории, линии, роли, якорь
Дата: 06.11.2026. Решение владельца: **эталонов нет**, есть сценарии и гибкость.
---
## 1. Четыре независимых слоя
```
КАТЕГОРИЯ → набор правил совместимости (что вообще можно соединять)
ЛИНИЯ → VCS-комплект или PRO AV-компонент (разные рынки и логика)
РОЛЬ → функция в комнате (не модель!)
СЦЕНАРИЙ → категория + профиль комнаты + требования + якорь
```
**Правила — данные, не код.** Новый сценарий = новый YAML. Движок не меняется.
---
## 2. Категории (по вашей поправке — с PRO AV отдельно)
| Категория | Что входит | Ключевое правило |
|---|---|---|
| **Bar** | MeetingBar A40/A50 | всё внутри → внешние роли: дисплей, панель, доп. микрофоны |
| **Терминал (кодек)** | MeetingEye 500/500 Pro, MVC-комплекты | модульная сборка: лимиты камер/микрофонов/динамиков |
| **USB / BYOD** | UVC85-BYOD, USB-камеры и микрофоны | **нет SIP/H.323** → нужен хост-ПК; логика комнаты другая |
| **PRO AV** | UVC84/86, MSpeaker II/Pro, VCM35/36, CM20, CS10, VCH51, WPP30 | **компоненты для интегратора**: собираются в произвольную систему, ограничений вендора меньше |
| **Телефония** | SIP-аппараты, конференц-панели | линии, регистрация, PoE |
| **Инфраструктура** | MCU, SBC, шлюзы, платформы | ёмкость, лицензии, протоколы |
| **Пассив** | дисплеи, кронштейны, кабели | геометрия и крепления |
**Почему PRO AV отдельно:** один и тот же `UVC86` в VCS-комплекте и в PRO AV-проекте
имеет разную логику подбора. В комплекте он уже в связке с кодеком; в PRO AV —
самостоятельная позиция, которую интегратор ставит к чужому коду (Cisco, Poly, ПК).
Правила совместимости для него **шире**, и их нельзя смешивать с комплектными.
---
## 3. Роли (функция, а не устройство)
| Роль | Обязательна | Примечание |
|---|---|---|
| `кодек/вычислитель` | всегда | бар = кодек внутри |
| `камера_основная` | всегда, кроме бара | у бара встроена |
| `микрофон` | всегда | массив или расширение |
| `динамик` | всегда | у бара встроен |
| `дисплей` | всегда | обычно 1–2 |
| `панель_управления` | опционально | CTP18/25 |
| `презентация` | опционально | HDMI in, WPP30, VCH51 |
| `крепление` | по монтажу | зависит от стены/потолка |
| `сеть/шлюз` | по инфраструктуре | SBC, PoE-бюджет |
Подбор идёт **по роли**, не по модели. Это и есть основа аналогов и мультивендора.
---
## 4. Якорь (бывший «эталон») — галочка, а не фундамент
Вы правы: эталон не должен быть основой. Он должен быть **опциональным входом**.
```yaml
anchor: # всё опционально, по умолчанию отсутствует
enabled: false # ← галочка «есть готовое / фиксируем»
devices:
- role: камера_основная
model: UVC86 # уже есть у клиента — зафиксировать
fixed: true # не менять при подборе
- role: дисплей
model: null
size_inch: 65 # только размер известен
fixed: true
note: "дисплей 65\" уже висит, остальное подобрать"
```
**Что даёт якорь:**
1. Клиент говорит «есть камера UVC86» — движок подбирает остальное **вокруг неё**.
2. Клиент говорит «есть ниша под дисплей 65"» — подбор учитывает размер.
3. Ничего не задано — движок подбирает всё с нуля.
**Якорь — это ограничение, а не образец.** Он не задаёт «как надо», он сужает пространство поиска.
---
## 5. Сценарий (данные)
```yaml
scenario: medium_bar_full_av
category: bar
line: vcs # vcs | pro_av
room: {площадь_м2: [25, 45], форма: прямоугольная, потолок_м: [2.7, 3.2]}
requirements:
видео: full # full | focused | byod
аудио: standard
sip: true
презентация: [hdmi, wireless]
roles:
codec_bar: {count: 1}
display: {count: [1, 2], min_inch: 65}
touch: {count: 1}
mic_expansion: {count: [0, 2]}
anchor: {enabled: false}
constraints: {бюджет: null, vendor: null}
options:
variants: [эконом, стандарт, премиум]
```
---
## 6. Сравнение вендоров — отдельная команда
Требование владельца: **отдельная команда для сравнения и подбора аналога**.
```
compare --role камера_основная --room medium
```
Что делает:
1. Берёт текущую конфигурацию (или указанную модель).
2. Находит **по роли** все устройства, проходящие правила совместимости.
3. Показывает таблицу различий:
| | Yealink UVC86 | Poly EagleEye IV | Logitech Rally Camera |
|---|---|---|---|
| Покрытие/зум | 36× гибрид | 12× | 15× |
| Совместим с нашим кодеком | ✅ | ⚠️ нужен адаптер | ✅ |
| PoE/питание | VCH | отдельный БП | USB |
| Цена | … | … | … |
| **Что теряем при замене** | — | −зум в 3 раза | −PTZ |
**Ключевое:** «что теряем» считает **движок**, а не LLM. LLM только формулирует.
---
## 7. Приоритет: совместимость — первая
По вашей экспертизе порядок такой:
1. **Совместимость** (электрическая, протокольная, геометрическая, лимиты) — основа
2. **Покрытие** (микрофоны/динамики/камеры) — второй слой
Совместимость проверяется **до** расчёта покрытия: нет смысла считать покрытие
для конфигурации, которая физически не соединится.
---
## 8. Что я делаю дальше
1. Каталог правил совместимости по категориям (начать с `bar` и `terminal`)
3. `compare` — команда сравнения по роли
4. Якорь (anchor) в схеме подбора
**Порядок:** совместимость → роли → сценарии → покрытие → сравнение → оптимизатор.