[COMBINE] Строгое разделение VCS/телефония, solution_class/sales_scope, прототип analog engine
lint / hygiene (push) Failing after 16s
standard / check (push) Successful in 7s

This commit is contained in:
root committed 2026-11-18 16:12:08 +03:00
1 parent 9c2d8f0d7f
commit 78f0ee3ff5
8 files changed
+1501 -1

No files matched your search

+68
View File
@@ -0,0 +1,68 @@
# Аналоги и строгое разделение VCS / Телефония
Дата: 18.11.2026
## Главное
**SIP — это протокол, а не домен.** Один и тот же SIP может быть:
- у **VCS-терминала/бара** — SIP/H.323 для подключения к ВКС;
- у **телефонии** — SIP-телефон, DECT, гарнитура.
Поэтому домен определяется **сценарием**, а не наличием SIP.
## Три независимые оси
| Ось | Значения | Зачем |
|---|---|---|
| `domain` | `vcs`, `telephony`, `pro_av`, `infrastructure`, `passive`, `software` | запрет смешивать ВКС и телефонию |
| `solution_class` | `vcs.bar.room`, `vcs.terminal.room`, `vcs.camera.usb`, `telephony.sip.desk`, `telephony.dect` … | аналоги только внутри класса |
| `sales_scope` | `own` (Yealink VCS), `alternative` (Poly/Logitech/Hitrolink/VINTEO/IVA), `reference` (телефония, не наш sales line) | что можно предлагать клиенту |
Дополнительно:
- `protocols: [SIP, H.323, …]` — протоколы;
- `sip_context`: `none` / `vcs_endpoint` / `telephony_endpoint`;
- `native_vcs` — нативная ВКС, а не USB-периферия.
## Жёсткие правила
1. **Никогда** не предлагать `telephony.*` как аналог `vcs.*` и наоборот.
2. SIP сам по себе **не** делает устройство телефонией.
3. Аналог ищется только при совпадении `domain` **и** `solution_class`.
4. Телефония — `reference`: используется для запросов конкурентов/смежных задач, не для нашей VCS-линейки.
5. Другие вендоры VCS — `alternative`: именно они предлагаются, если Yealink не подходит по бизнес-причинам.
## Примеры
| Запрос | Домен/класс | Аналоги |
|---|---|---|
| MeetingBar A40 | vcs / vcs.bar.room | Poly Studio X72, Logitech Rally Bar/MeetUp/Rally |
| UVC86 | vcs / vcs.camera.usb | Poly E60, Logitech Rally Camera/Scribe, Hitrolink UC600/XC600/XC900 |
| MeetingEye 500 | vcs / vcs.terminal.room | HTI-ET700/XT600/VB600, Logitech RoomMate, Poly G62 |
| SIP-T33P | telephony / telephony.sip.desk | только телефония; VCS не предлагается |
## Как будет работать будущий инструмент
1. Приходит ТЗ/запрос: «нужен бар на комнату 8–10 человек, SIP/H.323, 4K».
2. Парсер вытаскивает `domain`, `solution_class`, требования (комната, порты, протоколы, бюджет).
3. Движок фильтрует **только свой домен** и **свой класс**, затем ранжирует:
- совпадение класса;
- form-factor;
- протоколы;
- вместимость/размер комнаты;
- наличие/цена/срок (добавить позже).
4. Если Yealink не подходит по бизнесу — выдаёт `alternative` (Poly/Logitech/Hitrolink).
5. Показывает «почему» и «что теряем»; провенанс — `source`.
## Что уже сделано
- Stage: **284** устройства, 19 `solution_class`;
- `own` 139, `alternative` 67, `reference` 78;
- прототип: `ops/scripts/analog_recommend.py`;
- проверка: `SIP-T33P` не получает VCS-аналогов, `UVC86` получает камеры.
- Прод не изменён.
## Ограничение
Цены, наличие и сроки поставки пока не в модели — без них «лучший аналог»
остаётся техническим, а не коммерческим. Это следующий слой.
@@ -0,0 +1,33 @@
# P0 — solution_class / sales_scope
SIP — протокол, не домен. `domain` и `solution_class` строго разделяют VCS и телефонию.
| solution_class | Кол-во |
|---|---|
| vcs.accessory | 66 |
| telephony.sip.desk | 38 |
| vcs.camera.usb | 29 |
| vcs.terminal.room | 27 |
| vcs.audio | 26 |
| telephony.headset | 19 |
| vcs.control.touch | 12 |
| telephony.sip.conference | 11 |
| vcs.board | 9 |
| passive.display | 8 |
| vcs.bar.room | 7 |
| telephony.accessory | 7 |
| vcs.sharing | 6 |
| vcs.kit.room | 4 |
| infrastructure.network | 4 |
| vcs.bar.compact | 3 |
| passive.power | 3 |
| telephony.dect | 3 |
| passive.mount | 2 |
| sales_scope | Кол-во |
|---|---|
| own | 139 |
| reference | 78 |
| alternative | 67 |
`own` — Yealink VCS; `alternative` — другие VCS-вендоры; `reference` — телефония (не наш sales line).
File diff suppressed because it is too large. Load diff
+90
View File
@@ -0,0 +1,90 @@
#!/usr/bin/env python3
"""Прототип analog engine: аналоги только внутри domain + solution_class.
SIP не является доменом. Для VCS-бара нельзя вернуть SIP-телефон.
"""
import argparse
import json
import sys
import yaml
P = "/root/buryan-infra/ops/combine/catalog-p0-2026-11-18.yaml"
D = yaml.safe_load(open(P, encoding="utf-8"))["devices"]
def score(target, x):
s = 0
why = []
if x["domain"] == target["domain"]:
s += 20
if x["solution_class"] == target["solution_class"]:
s += 50
why.append("same solution_class")
if x.get("form_factor") == target.get("form_factor"):
s += 10
why.append("same form_factor")
tp = {p.upper() for p in target.get("protocols") or []}
xp = {p.upper() for p in x.get("protocols") or []}
if tp and xp & tp:
s += 10
why.append("protocol overlap")
if x.get("sales_scope") == "alternative":
s += 5
why.append("alternative vendor")
return s, why
def find(model):
q = model.lower().strip()
for x in D:
if x["model"].lower() == q or x.get("id", "").lower() == q:
return x
for x in D:
if q in x["model"].lower():
return x
return None
def analogs(model, limit=8):
t = find(model)
if not t:
return {"error": "not_found", "query": model}
cand = []
for x in D:
if x is t or x["vendor"] == t["vendor"]:
continue
# строгий барьер: только тот же домен и тот же класс
if x["domain"] != t["domain"] or x["solution_class"] != t["solution_class"]:
continue
s, why = score(t, x)
cand.append({"id": x["id"], "vendor": x["vendor"], "model": x["model"],
"solution_class": x["solution_class"], "sales_scope": x.get("sales_scope"),
"protocols": x.get("protocols") or [], "score": s,
"why": why})
cand.sort(key=lambda z: (-z["score"], z["vendor"], z["model"]))
return {"target": {"id": t["id"], "vendor": t["vendor"], "model": t["model"],
"domain": t["domain"], "solution_class": t["solution_class"],
"sales_scope": t.get("sales_scope"), "protocols": t.get("protocols") or []},
"alternatives": cand[:limit],
"note": "Аналоги только внутри domain+solution_class; телефония не предлагается для VCS."}
if __name__ == "__main__":
ap = argparse.ArgumentParser()
ap.add_argument("model")
ap.add_argument("--json", action="store_true")
a = ap.parse_args()
r = analogs(a.model)
if a.json:
print(json.dumps(r, ensure_ascii=False, indent=2))
else:
if "error" in r:
print("не найдено:", a.model)
sys.exit(2)
t = r["target"]
print("Цель: %s — %s (%s, %s, %s)" % (t["vendor"], t["model"], t["domain"], t["solution_class"], t["sales_scope"]))
print("Аналоги:")
for x in r["alternatives"]:
print("- %-10s %-32s score=%d %s" % (x["vendor"], x["model"], x["score"], ", ".join(x["why"])))
if not r["alternatives"]:
print("- нет альтернатив в базе")
+1
View File
@@ -14,6 +14,7 @@ FILES = [
("P0.5 применено", "/root/buryan-infra/ops/combine/P0-APPLIED-ATTRS-2026-11-18.md"),
("P0.6 retry-очередь", "/root/buryan-infra/ops/combine/P0-RETRY-QUEUE-2026-11-18.md"),
("Модели других вендоров", "/root/buryan-infra/ops/combine/VENDORS-OTHER-REPORT-2026-11-18.md"),
("Стратегия аналогов", "/root/buryan-infra/ops/combine/COMBINE-ANALOGS-STRATEGY.md"),
("P0.7 мусорные факты", "/root/buryan-infra/ops/combine/P0-JUNK-REPORT-2026-11-18.md"),
("Нормализация каталога", "/root/buryan-infra/ops/combine/NORMALIZATION-REPORT-2026-11-18.md"),
("Стратегия Комбайна", "/root/buryan-infra/ops/combine/STRATEGY-2026-11-18.md"),
+98
View File
@@ -0,0 +1,98 @@
#!/usr/bin/env python3
"""Разметка stage: domain / solution_class / sales_scope / sip_context.
SIP — протокол. Домен определяет сценарий:
vcs — переговорная/commercial video
telephony — SIP-телефоны, DECT, гарнитуры (reference, не наш sales line)
"""
import re
import yaml
from collections import Counter
P = "/root/buryan-infra/ops/combine/catalog-p0-2026-11-18.yaml"
R = "/root/buryan-infra/ops/combine/P0-SOLUTION-CLASSES-2026-11-18.md"
d = yaml.safe_load(open(P, encoding="utf-8"))
devs = d["devices"]
def cls(x):
n = (x.get("model") or "").lower()
dom = x.get("domain") or "vcs"
grp = x.get("group") or ""
role = x.get("role") or ""
if dom == "telephony":
if n.startswith(("sip-t", "t3", "t4", "t5", "t7", "t8", "vp", "mp")):
return "telephony.sip.desk"
if n.startswith("cp"):
return "telephony.sip.conference"
if any(k in n for k in ("w70", "w80", "dect", "w53", "w56", "w57", "w59", "w73", "w76", "w77", "w78", "w79")):
return "telephony.dect"
if any(k in n for k in ("uh", "bh", "ehs", "wh", "yhs")):
return "telephony.headset"
return "telephony.accessory"
if any(k in n for k in ("uvc", "smartvision", "mb-cam", "cam50")):
return "vcs.camera.ptz" if "ptz" in n else "vcs.camera.usb"
if grp == "A_integration_terminals":
if n.startswith("mvc"):
return "vcs.kit.room"
if any(k in n for k in ("mini-pc", "room compute", "conferencing pc")):
return "vcs.pc"
return "vcs.terminal.room"
if grp == "B_video_bars":
if "meetingboard" in n or "hiboard" in n:
return "vcs.board"
if any(k in n for k in ("a10", "a20", "a25", "v12", "p15", "bcc950", "connect")):
return "vcs.bar.compact"
return "vcs.bar.room"
if grp == "D_usb_byod":
if any(k in n for k in ("ptz", "e60", "rally camera", "sight", "scribe")):
return "vcs.camera.ptz" if "ptz" in n else "vcs.camera.usb"
if any(k in n for k in ("vch", "wpp", "swytch", "byod")):
return "vcs.sharing"
if "camera" in role or any(k in n for k in ("uvc", "xc", "uc3", "uc4", "uc5", "cam")):
return "vcs.camera.usb"
return "vcs.accessory"
if grp == "E_audio":
return "vcs.audio"
if grp == "E_control":
return "vcs.control.touch"
if grp == "E_display":
return "passive.display"
if grp == "E_mount":
return "passive.mount"
if grp == "E_power":
return "passive.power"
if grp == "E_infra":
return "infrastructure.network"
return "vcs.accessory"
for x in devs:
x["solution_class"] = cls(x)
x["analog_group"] = x["solution_class"]
if x.get("domain") == "telephony":
x["sales_scope"] = "reference"
elif x.get("vendor") == "yealink":
x["sales_scope"] = "own"
else:
x["sales_scope"] = "alternative"
prots = [p.upper() for p in (x.get("protocols") or [])]
if "SIP" in prots:
x["sip_context"] = "telephony_endpoint" if x.get("domain") == "telephony" else "vcs_endpoint"
else:
x["sip_context"] = "none"
yaml.safe_dump(d, open(P, "w", encoding="utf-8"), allow_unicode=True, sort_keys=False)
c = Counter(x["solution_class"] for x in devs)
s = Counter(x["sales_scope"] for x in devs)
lines = ["# P0 — solution_class / sales_scope", "",
"SIP — протокол, не домен. `domain` и `solution_class` строго разделяют VCS и телефонию.", "",
"| solution_class | Кол-во |", "|---|---|"]
for k, n in c.most_common():
lines.append("| %s | %d |" % (k, n))
lines += ["", "| sales_scope | Кол-во |", "|---|---|"]
for k, n in s.most_common():
lines.append("| %s | %d |" % (k, n))
lines += ["", "`own` — Yealink VCS; `alternative` — другие VCS-вендоры; `reference` — телефония (не наш sales line)."]
open(R, "w", encoding="utf-8").write("\n".join(lines) + "\n")
print("classified", len(devs), "classes", len(c), "scopes", dict(s))
@@ -0,0 +1,74 @@
<!doctype html><html lang="ru"><head><meta charset="utf-8">
<title>Стратегия аналогов</title><style>body{font:15px/1.5 system-ui;background:#0d1117;color:#e6edf3;margin:0;padding:24px}
pre{white-space:pre-wrap;background:#161b22;border:1px solid #30363d;border-radius:10px;padding:18px;overflow:auto}
a{color:#58a6ff} .nav{margin-bottom:16px} h1{font-size:22px}</style></head>
<body><div class="nav"><a href="/">Комбайн</a> · <a href="/reports/">Отчёты</a></div>
<h1>Стратегия аналогов</h1><pre># Аналоги и строгое разделение VCS / Телефония
Дата: 18.11.2026
## Главное
**SIP — это протокол, а не домен.** Один и тот же SIP может быть:
- у **VCS-терминала/бара** — SIP/H.323 для подключения к ВКС;
- у **телефонии** — SIP-телефон, DECT, гарнитура.
Поэтому домен определяется **сценарием**, а не наличием SIP.
## Три независимые оси
| Ось | Значения | Зачем |
|---|---|---|
| `domain` | `vcs`, `telephony`, `pro_av`, `infrastructure`, `passive`, `software` | запрет смешивать ВКС и телефонию |
| `solution_class` | `vcs.bar.room`, `vcs.terminal.room`, `vcs.camera.usb`, `telephony.sip.desk`, `telephony.dect` … | аналоги только внутри класса |
| `sales_scope` | `own` (Yealink VCS), `alternative` (Poly/Logitech/Hitrolink/VINTEO/IVA), `reference` (телефония, не наш sales line) | что можно предлагать клиенту |
Дополнительно:
- `protocols: [SIP, H.323, …]` — протоколы;
- `sip_context`: `none` / `vcs_endpoint` / `telephony_endpoint`;
- `native_vcs` — нативная ВКС, а не USB-периферия.
## Жёсткие правила
1. **Никогда** не предлагать `telephony.*` как аналог `vcs.*` и наоборот.
2. SIP сам по себе **не** делает устройство телефонией.
3. Аналог ищется только при совпадении `domain` **и** `solution_class`.
4. Телефония — `reference`: используется для запросов конкурентов/смежных задач, не для нашей VCS-линейки.
5. Другие вендоры VCS — `alternative`: именно они предлагаются, если Yealink не подходит по бизнес-причинам.
## Примеры
| Запрос | Домен/класс | Аналоги |
|---|---|---|
| MeetingBar A40 | vcs / vcs.bar.room | Poly Studio X72, Logitech Rally Bar/MeetUp/Rally |
| UVC86 | vcs / vcs.camera.usb | Poly E60, Logitech Rally Camera/Scribe, Hitrolink UC600/XC600/XC900 |
| MeetingEye 500 | vcs / vcs.terminal.room | HTI-ET700/XT600/VB600, Logitech RoomMate, Poly G62 |
| SIP-T33P | telephony / telephony.sip.desk | только телефония; VCS не предлагается |
## Как будет работать будущий инструмент
1. Приходит ТЗ/запрос: «нужен бар на комнату 8–10 человек, SIP/H.323, 4K».
2. Парсер вытаскивает `domain`, `solution_class`, требования (комната, порты, протоколы, бюджет).
3. Движок фильтрует **только свой домен** и **свой класс**, затем ранжирует:
- совпадение класса;
- form-factor;
- протоколы;
- вместимость/размер комнаты;
- наличие/цена/срок (добавить позже).
4. Если Yealink не подходит по бизнесу — выдаёт `alternative` (Poly/Logitech/Hitrolink).
5. Показывает «почему» и «что теряем»; провенанс — `source`.
## Что уже сделано
- Stage: **284** устройства, 19 `solution_class`;
- `own` 139, `alternative` 67, `reference` 78;
- прототип: `ops/scripts/analog_recommend.py`;
- проверка: `SIP-T33P` не получает VCS-аналогов, `UVC86` получает камеры.
- Прод не изменён.
## Ограничение
Цены, наличие и сроки поставки пока не в модели — без них «лучший аналог»
остаётся техническим, а не коммерческим. Это следующий слой.
</pre></body></html>
+1 -1
View File
@@ -3,4 +3,4 @@
pre{white-space:pre-wrap;background:#161b22;border:1px solid #30363d;border-radius:10px;padding:18px;overflow:auto}
a{color:#58a6ff} .nav{margin-bottom:16px} h1{font-size:22px}</style></head>
<body><div class="nav"><a href="/">Комбайн</a> · <a href="/reports/">Отчёты</a></div>
<h1>Отчёты</h1><ul><li><a href="/reports/COMBINE-LLM-AUDIT-20261118-1305.html">LLM-аудит Комбайна (13:05)</a></li><li><a href="/reports/P0-STAGE-REPORT-2026-11-18.html">P0-stage отчёт</a></li><li><a href="/reports/P0-DIFF-2026-11-18.html">P0 diff</a></li><li><a href="/reports/P0-ATTR-REPORT-2026-11-18.html">P0.5 карантин атрибутов</a></li><li><a href="/reports/P0-APPLIED-ATTRS-2026-11-18.html">P0.5 применено</a></li><li><a href="/reports/P0-RETRY-QUEUE-2026-11-18.html">P0.6 retry-очередь</a></li><li><a href="/reports/VENDORS-OTHER-REPORT-2026-11-18.html">Модели других вендоров</a></li><li><a href="/reports/P0-JUNK-REPORT-2026-11-18.html">P0.7 мусорные факты</a></li><li><a href="/reports/NORMALIZATION-REPORT-2026-11-18.html">Нормализация каталога</a></li><li><a href="/reports/STRATEGY-2026-11-18.html">Стратегия Комбайна</a></li><li><a href="/reports/VENDORS-RESEARCH.html">Вендоры research</a></li><li><a href="/reports/VPS-FIX-2026-11-18.html">VPS fix</a></li><li><a href="/reports/SCENARIOS.html">Сценарии OpenClaw</a></li><li><a href="/reports/EVAL-FINAL-2026-11-17.html">Оценка (eval)</a></li></ul></body></html>
<h1>Отчёты</h1><ul><li><a href="/reports/COMBINE-LLM-AUDIT-20261118-1305.html">LLM-аудит Комбайна (13:05)</a></li><li><a href="/reports/P0-STAGE-REPORT-2026-11-18.html">P0-stage отчёт</a></li><li><a href="/reports/P0-DIFF-2026-11-18.html">P0 diff</a></li><li><a href="/reports/P0-ATTR-REPORT-2026-11-18.html">P0.5 карантин атрибутов</a></li><li><a href="/reports/P0-APPLIED-ATTRS-2026-11-18.html">P0.5 применено</a></li><li><a href="/reports/P0-RETRY-QUEUE-2026-11-18.html">P0.6 retry-очередь</a></li><li><a href="/reports/VENDORS-OTHER-REPORT-2026-11-18.html">Модели других вендоров</a></li><li><a href="/reports/COMBINE-ANALOGS-STRATEGY.html">Стратегия аналогов</a></li><li><a href="/reports/P0-JUNK-REPORT-2026-11-18.html">P0.7 мусорные факты</a></li><li><a href="/reports/NORMALIZATION-REPORT-2026-11-18.html">Нормализация каталога</a></li><li><a href="/reports/STRATEGY-2026-11-18.html">Стратегия Комбайна</a></li><li><a href="/reports/VENDORS-RESEARCH.html">Вендоры research</a></li><li><a href="/reports/VPS-FIX-2026-11-18.html">VPS fix</a></li><li><a href="/reports/SCENARIOS.html">Сценарии OpenClaw</a></li><li><a href="/reports/EVAL-FINAL-2026-11-17.html">Оценка (eval)</a></li></ul></body></html>