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

75 lines
3.9 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. Идея владельца: значения из даташитов (зум, дальность захвата,
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