Files
buryan-infra/ops/work/ATTRIBUTES.md

3.9 KiB
Raw Permalink Blame History

Атрибуты устройств: любые значения как фильтр

Дата: 06.11.2026. Идея владельца: значения из даташитов (зум, дальность захвата, SPL...) — фильтруемые атрибуты, сгруппированные для «всплывающих» фильтров.

Реестр: 28 атрибутов, 36 устройств

Группа Атрибуты Заполнено
Камера оптический/гибридный/цифровой зум, FOV гориз./верт., PTZ-предустановки, диапазон поворота/наклона, глубина резкости, разрешение 1–6
Аудио дальность захвата (м), SPL (dB), элементов массива, SNR, частоты, расширительные микрофоны 3–11
Сеть PoE, USB-C, Wi-Fi, Bluetooth, Ethernet 8–17
Интерфейсы HDMI выход/вход, USB-портов, VCH-портов 2–17
Физика вес (кг), рабочая температура 2–13

Реальные диапазоны (для ползунков UI)

audio.pickup_m       6 … 12 м        9 устройств
audio.spl_max       90 … 122 dB      7
audio.snr           70 … 86 dB       9
audio.mic_count      8 … 16 шт       7
camera.fov_h        80 … 98.2 °       4
camera.fov_v      20.4 … 81 °         3
camera.zoom_*        4 … 12 ×         4
physical.weight_kg   ? … ? кг        13

Диапазоны берутся из данных — ползунок не выдумывается.

Фильтры

attr_filter.py --ranges                              # диапазоны
attr_filter.py --where "camera.zoom_optical>=10"     # зум от 10×
attr_filter.py --where "audio.pickup_m>=6"
attr_filter.py --where "network.poe=true,audio.pickup_m>=6"
attr_filter.py --show "MeetingBar A50"               # все значения устройства

Защита от мусора — границы правдоподобия

Добавлен контроль: значение вне разумного диапазона отбрасывается как ошибка извлечения. Примеры границ:

Атрибут Допустимо
audio.spl_max 60–140 dB
audio.pickup_m 0.5–30 м
camera.fov_h 20–180°
camera.zoom_optical 1–60×
physical.weight_kg 0.05–100 кг

До фильтра: SPL минимум был 3 dB (мусор), FOV вертикали — 2°. После: SPL 90–122 dB, FOV 20.4–81° — правдоподобно.

Это важно для инструмента, которому доверяют: лучше не иметь значения, чем иметь неверное.

Принцип «нет данных ≠ не подходит»

Фильтр разделяет три состояния:

  1. подходит — значение есть и удовлетворяет условию
  2. не подходит — значение есть и не удовлетворяет
  3. нет данных — значение не извлечено (показывается отдельно)

В примере с network.poe + pickup>=6 подошли 2 устройства, а 34 попали в «нет данных» — и это честно видно, а не спрятано.

Что дальше

  1. Расширить извлечение (часть значений есть в PDF, но не ловится regex)
  2. Нормализация единиц: 10ft (3m) → {value: 3, unit: m}
  3. Связать с подбором: атрибуты → роли → совместимость → BOM