[WORK] Фильтр по требованиям партнёра: 27 устройств × 91 функция; Dante/AES67 у Yealink нет — через внешний DSP

This commit is contained in:
root committed 2026-11-06 15:04:57 +03:00
1 parent 09f9aa6525
commit 3417387d7b
4 files changed
+1309

No files matched your search

+70
View File
@@ -0,0 +1,70 @@
# Фильтр по требованиям партнёра
Дата: 06.11.2026. Задача владельца: «партнёр приходит с требованиями
(например, Dante) — хочу как в фильтре: неподходящие устройства отпадают».
## Что сделано
1. **Каталог функций** — `ops/work/compat/features.yaml`
Из официального `rooms-supported-features-list`: **27 устройств × 91 функция**.
2. **Фильтр** — `ops/work/tools/filter_features.py`
```
filter_features.py --require "Auto Framing,802.1x"
filter_features.py --list-features
```
## Пример работы
Требования: **Auto Framing + 802.1x** → подходят **8 устройств**:
```
MeetingBar A25 USB Mode · MeetingBar A50 USB Mode
SmartVision 40 · SmartVision 80
UVC40 · UVC40 E2 · UVC84 · UVC86
```
Остальные отпали автоматически.
## ⚠️ Dante — важное открытие
**Dante/AES67 нет ни в одном официальном документе Yealink.**
Проверено поиском по всем собранным источникам: 0 упоминаний.
**Что это значит практически:**
| Требование | Реальность |
|---|---|
| Партнёр хочет Dante | Yealink-эндпоинты сами по себе **не дают** Dante |
| Решение | внешний DSP с Dante: **Biamp, Shure, QSC** |
| Как стыкуется | MCore → DSP по **USB** (официально подтверждено в PRO AV) |
Фильтр это учитывает: на `--require dante` отвечает предупреждением
и предлагает схему через внешний DSP, а не молча возвращает «нет».
**Это ценнее, чем просто «фильтр»:** партнёр получает объяснение,
как выполнить требование, даже если у Yealink такой функции нет.
## Типы требований, которые поддерживаются
| Тип | Примеры | Источник |
|---|---|---|
| Функции камеры | Auto Framing, Speaker Tracking, Camera Preset | features-list |
| Функции аудио | Acoustic Shield, Audio Fence, Audio Diagnostic | features-list |
| Сеть | 802.1x, IPv6 | features-list |
| Презентация | AirPlay, Miracast, Client Content Sharing | features-list |
| Протоколы | SIP, H.323 | матрица + datasheets |
| Внешние | **Dante, AES67** | нет у Yealink → через DSP |
## Файлы
- `ops/work/compat/features.yaml` — 27 устройств × 91 функция
- `ops/work/tools/build_features.py` — построение
- `ops/work/tools/filter_features.py` — фильтр
## Что дальше
1. Добавить функции из **PRO AV** (там спикеры, микрофоны, DSP)
2. Расширить с **91 функции** до полного набора (у Yealink 96 в features-list
+ часть есть в datasheets)
3. Связать фильтр с подбором: требований → роли → устройства → совместимость
File diff suppressed because it is too large. Load diff
+100
View File
@@ -0,0 +1,100 @@
#!/usr/bin/env python3
"""Функции устройств + фильтр по требованиям партнёра.
Источник функций: rooms-supported-features-list (96 функций × устройства).
Фильтр: задаём требования (AirPlay, 802.1x, Auto Framing, Dante...) —
получаем устройства, которые им соответствуют.
"""
import glob
import json
import os
import re
import sys
BASE = "/opt/work-hub/compat"
OUT = BASE
TRUE_MARKS = ("√", "✓", "✔", "да", "yes", "y", "支持")
def fix(s):
if s is None:
return ""
s = str(s)
for enc in ("cp1251", "cp866"):
try:
return s.encode(enc).decode("utf-8")
except Exception:
continue
return s
def truthy(v):
t = fix(v).strip().lower()
return any(m in t for m in TRUE_MARKS)
def build_features():
"""Собирает device -> набор функций из таблиц features-list."""
files = glob.glob(os.path.join(BASE, "raw", "rooms-supported-features-list-*.yaml"))
if not files:
print("нет файла features-list")
return {}
import yaml
d = yaml.safe_load(open(files[0], encoding="utf-8"))
devices = {}
for table in d.get("tables") or []:
if not table:
continue
header = [fix(c).strip() for c in table[0]]
# первый столбец — название функции, остальные — устройства
for row in table[1:]:
if not row:
continue
feat = fix(row[0]).strip()
if not feat:
continue
for i, cell in enumerate(row[1:], start=1):
dev = header[i] if i < len(header) else ""
dev = re.sub(r"\s+", " ", dev).strip()
if not dev:
continue
entry = devices.setdefault(dev, {"features": set(), "absent": set()})
if truthy(cell):
entry["features"].add(feat)
elif fix(cell).strip():
entry["absent"].add(feat)
return devices
def main():
import yaml
devices = build_features()
out = {"vendor": "yealink",
"note": "Функции из официального rooms-supported-features-list. "
"Dante/AES67 у Yealink НЕТ — требуется внешний DSP (Biamp/Shure/QSC).",
"devices": [{"device": k,
"features": sorted(v["features"]),
"absent": sorted(v["absent"])}
for k, v in sorted(devices.items())]}
path = os.path.join(OUT, "features.yaml")
with open(path, "w", encoding="utf-8") as f:
yaml.safe_dump(out, f, allow_unicode=True, sort_keys=False, width=160)
all_feats = set()
for v in devices.values():
all_feats |= v["features"]
print("устройств с функциями: %d" % len(devices))
print("уникальных функций: %d" % len(all_feats))
print("\nустройства (первые 10):")
for k, v in list(devices.items())[:10]:
print(" %-28s функций %2d" % (k[:28], len(v["features"])))
print("\nфункции для фильтра (примеры):")
for x in sorted(all_feats)[:20]:
print(" -", x)
print("\nсохранено:", path)
return 0
if __name__ == "__main__":
sys.exit(main())
+81
View File
@@ -0,0 +1,81 @@
#!/usr/bin/env python3
"""Фильтр устройств по требованиям партнёра.
Примеры:
filter.py --require airplay
filter.py --require auto framing,802.1x
filter.py --list-features
filter.py --require dante
"""
import argparse
import os
import re
import sys
BASE = "/opt/work-hub/compat"
def load():
import yaml
f = os.path.join(BASE, "features.yaml")
if not os.path.exists(f):
return {}
d = yaml.safe_load(open(f, encoding="utf-8")) or {}
return {x["device"]: {"features": set(x.get("features") or []),
"absent": set(x.get("absent") or [])}
for x in d.get("devices") or []}
def norm(s):
return re.sub(r"[^a-z0-9]", "", s.lower())
def main():
ap = argparse.ArgumentParser()
ap.add_argument("--require", help="требования через запятую")
ap.add_argument("--list-features", action="store_true", help="показать все функции")
a = ap.parse_args()
devices = load()
if not devices:
print("нет features.yaml — запусти build_features.py")
return 1
if a.list_features:
feats = set()
for v in devices.values():
feats |= v["features"]
for f in sorted(feats):
print(" ", f)
return 0
if not a.require:
print("укажите --require или --list-features")
return 1
req = [x.strip() for x in a.require.split(",") if x.strip()]
print("требования: %s" % ", ".join(req))
if any(norm(x) in ("dante", "aes67") for x in req):
print(" ⚠ Dante/AES67 отсутствует у Yealink — нужен внешний DSP (Biamp/Shure/QSC)")
print(" Yealink стыкуется с ними по USB (MCore → DSP)")
matched, partial = [], []
for dev, v in devices.items():
have = {norm(f) for f in v["features"]}
missing = [r for r in req if norm(r) not in have]
if not missing:
matched.append(dev)
elif len(missing) < len(req):
partial.append((dev, missing))
print("\nПОДХОДЯТ (%d):" % len(matched))
for d in sorted(matched):
print(" ✓", d)
if partial:
print("\nЧАСТИЧНО (%d):" % len(partial))
for d, miss in sorted(partial)[:10]:
print(" ~ %-28s нет: %s" % (d[:28], ", ".join(miss)))
return 0
if __name__ == "__main__":
sys.exit(main())