[WORK] Сверка источников: 21 совпало, 6 конфликтов исключены из подбора (правило: матрица = истина); 22 ребра ждут маппинга имён

This commit is contained in:
root committed 2026-11-06 14:55:03 +03:00
1 parent 95e80381fe
commit 410ff74c46
3 files changed
+6632

No files matched your search

+64
View File
@@ -0,0 +1,64 @@
# Сверка источников совместимости
Дата: 06.11.2026. Правило владельца: **официальное — истина**;
при расхождении вариант **не рассматриваем**.
## Результат сверки
Матрица Yealink (21 хост) против PDF-руководств (MeetingEye 400/600/800, 2022).
| Итог | Кол-во | Что делаем |
|---|---|---|
| **Совпало** | 21 | используем |
| **Конфликтов** | **6** | **исключены из подбора** (`usable: false`) |
| Только в PDF (иные названия) | 22 | требуют сопоставления имён |
## Конфликты (6) — вариант исключён
| Хост | Аксессуар | Матрица | PDF (2022) | Решение |
|---|---|---|---|---|
| MeetingEye 400 | CPW90-BT | **×** | √ | матрица: нет |
| MeetingEye 400 | VCM38 | **×** | √ | матрица: нет |
| MeetingEye 600 | CPW90-BT | **×** | √ | матрица: нет |
| MeetingEye 600 | VCM38 | **×** | √ | матрица: нет |
| MeetingEye 800 | **UVC86** | **√** | × | матрица: да |
| MeetingEye 800 | CPW90-BT | **×** | √ | матрица: нет |
**Почему матрица главнее:** она новее (содержит MeetingEye 900, PVT 140/160,
UVC86 E2 — моделей 2024–2025 годов нет в руководствах 2022). PDF-руководства
описывают прошивки того времени.
**Но по правилу владельца эти варианты не используются вообще** — ни «да», ни «нет».
Они помечены `conflict: true, usable: false` и движок их пропускает.
## Только в PDF (22) — проблема имён
В матрице другие названия аксессуаров, чем в руководствах 2022:
| В PDF | В матрице |
|---|---|
| CPW90-DECT | CPW90-BT (?) |
| VCC22 | UVC84 (по сути та же камера) |
| Dect USB Dongle | (нет отдельной колонки) |
| VCR11/VCR20 | VCR11/VCR20 (есть) |
**Это не конфликты, а разные поколения названий.** Нужна таблица сопоставления —
иначе 22 ребра просто теряются.
## Как это работает в движке
```
матрица (истина) + pdf (2022)
↓
сверка
↓
совпало → usable: true
конфликт → usable: false ← «не рассматриваем»
только pdf → требует маппинга имён
```
## Что дальше
1. **Таблица сопоставления названий** (CPW90-DECT → CPW90-BT и т.д.) — чтобы не терять 22 ребра
2. Свести остальные 8 источников (audio I/O, mounts, headset, features) к той же схеме
3. Добавить узел **PC** как хост для USB-аксессуаров
File diff suppressed because it is too large. Load diff
+134
View File
@@ -0,0 +1,134 @@
#!/usr/bin/env python3
"""Сверка источников совместимости Yealink.
Правило владельца: официальный источник — истина; при расхождении
вариант не рассматриваем (помечаем conflict и исключаем из подбора).
Источники:
matrix/*.yaml — матрица Yealink (21 хост × 42 аксессуара), новее
yealink/*.yaml — из PDF-руководств (MeetingEye 400/600/800), 2022
Выход: ops/work/compat/reconciled.yaml + отчёт
"""
import glob
import os
import re
import sys
BASE = "/opt/work-hub/compat"
OUT = BASE
def load(kind):
"""kind: matrix | yealink"""
out = {}
for f in glob.glob(os.path.join(BASE, kind, "*.yaml")):
if os.path.basename(f).startswith("_"):
continue
try:
import yaml
d = yaml.safe_load(open(f, encoding="utf-8"))
except Exception:
continue
c = (d or {}).get("compatibility") or {}
host = (c.get("device") or "").strip()
if not host:
continue
accs = {}
for a in c.get("accessories") or []:
model = (a.get("model") or "").strip()
if not model:
continue
# derive_supported: в PDF-источниках поля supported нет,
# оно выводится из max_qty (0 = Nonsupport)
if "supported" in a and a["supported"] is not None:
sup = bool(a["supported"])
else:
q = a.get("max_qty")
sup = not (q == 0)
accs[model.lower()] = {
"model": model,
"supported": sup,
"max_qty": a.get("max_qty"),
"note": a.get("note"),
"role": a.get("role"),
"origin": kind,
}
out[host.lower()] = {"host": host, "accessories": accs, "origin": kind}
return out
def norm(s):
return re.sub(r"[^a-z0-9]", "", s.lower())
def main():
import yaml
matrix = load("matrix")
pdf = load("yealink")
print("хостов в матрице: %d | в PDF-руководствах: %d" % (len(matrix), len(pdf)))
merged = {}
report = {"agree": [], "conflict": [], "matrix_only": [], "pdf_only": []}
for hkey, m in matrix.items():
merged[hkey] = {"host": m["host"], "accessories": dict(m["accessories"]),
"sources": ["matrix"]}
for hkey, p in pdf.items():
if hkey not in merged:
merged[hkey] = {"host": p["host"], "accessories": dict(p["accessories"]),
"sources": ["pedf"]}
continue
target = merged[hkey]
target["sources"].append("pdf")
for akey, pa in p["accessories"].items():
matched = None
for k in target["accessories"]:
if norm(k) == norm(akey):
matched = k
break
if matched is None:
target["accessories"][akey] = pa
report["pdf_only"].append((p["host"], pa["model"]))
continue
ma = target["accessories"][matched]
if ma["supported"] != pa["supported"]:
# конфликт: матрица новее — она истина, вариант исключаем
report["conflict"].append({
"host": p["host"], "accessory": ma["model"],
"matrix": ma["supported"], "pdf": pa["supported"],
"resolved": ma["supported"], "rule": "matrix (новее)",
})
ma["conflict"] = True
ma["pdf_supported"] = pa["supported"]
ma["usable"] = False # ← не рассматриваем
else:
report["agree"].append((p["host"], ma["model"]))
# всё, что без конфликта — пригодно
for h in merged.values():
for a in h["accessories"].values():
a.setdefault("usable", not a.get("conflict", False))
path = os.path.join(OUT, "reconciled.yaml")
with open(path, "w", encoding="utf-8") as f:
yaml.safe_dump({"hosts": [{"host": h["host"], "sources": h["sources"],
"accessories": list(h["accessories"].values())}
for h in merged.values()]},
f, allow_unicode=True, sort_keys=False, width=200)
print("\n=== СВЕРКА ===")
print(" совпало: %d" % len(report["agree"]))
print(" КОНФЛИКТОВ: %d ← исключены из подбора" % len(report["conflict"]))
print(" только в матрице: %d" % len(report["matrix_only"]))
print(" только в PDF: %d" % len(report["pdf_only"]))
print("\nконфликты (первые 10):")
for c in report["conflict"][:10]:
print(" %-18s %-12s матрица=%s pdf=%s → берём матрицу"
% (c["host"][:18], c["accessory"][:12],
"√" if c["matrix"] else "×", "√" if c["pdf"] else "×"))
print("\nсохранено:", path)
return 0
if __name__ == "__main__":
sys.exit(main())