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

7.9 KiB
Raw Permalink Blame History

Модель сценариев: категории, линии, роли, якорь

Дата: 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. Якорь (бывший «эталон») — галочка, а не фундамент

Вы правы: эталон не должен быть основой. Он должен быть опциональным входом.

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. Сценарий (данные)

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)
  2. compare — команда сравнения по роли
  3. Якорь (anchor) в схеме подбора

Порядок: совместимость → роли → сценарии → покрытие → сравнение → оптимизатор.