From 8b99fb9f65cba0ceb5049e3cf823be47d626caa0 Mon Sep 17 00:00:00 2001 From: Roman Buryan Date: Wed, 18 Nov 2026 11:42:57 +0300 Subject: [PATCH] =?UTF-8?q?[COMBINE]=20=D0=A1=D1=82=D1=80=D0=B0=D1=82?= =?UTF-8?q?=D0=B5=D0=B3=D0=B8=D1=8F:=20=D0=BA=D0=B0=D0=BD=D0=BE=D0=BD?= =?UTF-8?q?=D0=B8=D1=87=D0=B5=D1=81=D0=BA=D0=B0=D1=8F=20=D0=BC=D0=BE=D0=B4?= =?UTF-8?q?=D0=B5=D0=BB=D1=8C,=20=D0=B3=D1=80=D1=83=D0=BF=D0=BF=D1=8B=20A-?= =?UTF-8?q?E/T,=209->2=20=D1=81=D0=B5=D1=80=D0=B2=D0=B8=D1=81=D0=B0,=20P0/?= =?UTF-8?q?P1/P2,=20OpenClaw=20tools?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- ops/combine/STRATEGY-2026-11-18.md | 156 +++++++++++++++++++++++++++++ 1 file changed, 156 insertions(+) create mode 100644 ops/combine/STRATEGY-2026-11-18.md diff --git a/ops/combine/STRATEGY-2026-11-18.md b/ops/combine/STRATEGY-2026-11-18.md new file mode 100644 index 0000000..5763ec2 --- /dev/null +++ b/ops/combine/STRATEGY-2026-11-18.md @@ -0,0 +1,156 @@ +# «Комбайн»: аудит, целевая структура и план + +Дата: 18.11.2026. Основано на LLM-аудите (`ops/audits/COMBINE-LLM-AUDIT-20261118-1140.md`) +и P0-таксономии (`ops/combine/TAXONOMY-2026-11-18.md`). + +## 1. Что показал аудит + +| Проблема | Факт | +|---|---| +| Каталог | 141 запись; **20 дублей/слитых**, реально ~110 моделей | +| Values | 87 устройств; **53 отсутствуют в каталоге** (SIP-телефоны, DECT, гарнитуры, часть кодеков) | +| Схема | нет `vendor`, `domain`, `line`, `protocols`, `form_factor`, `integrated`, `limits`, `source`, `version` | +| Группа SIP/H.323 | **не выделяется**: поля `protocols` нет; в values протоколы тоже отсутствуют | +| Сервисы | 9 сервисов; **8 из 9 отдают 404** на корне, нет health/OpenAPI/единой точки входа | +| LLM-факты | ~11 400 собраны, **не влиты**; `empty` 6 219 yealink + 211 logitech | +| Качество атрибутов | FOV 120×120, SPL вместо pickup, 24 PoE-порта у камеры, разные форматы разрешений | +| Провенанс | заявлен, но `value/source/verified` не видны в данных | +| Боль/сценарий/якорь | заявлены как сущности, в данных отсутствуют | + +**Главный вывод:** проблема не в количестве функций, а в **отсутствии канонической модели +продукта** и **расползании на 9 сервисов**. Сначала данные и контракты, потом UI и оптимизатор. + +## 2. Группы устройств (как делить) + +Два независимых измерения, а не одно дерево: + +``` +domain: vcs | telephony | pro_av | byod | infra | software +form_factor: terminal | bar | board | phone | headset | camera | mic | + speaker | dsp | touch | sharing | dongle | display | mount | + switch | power | sensor | pc | software +``` + +| Группа | Критерий | Что входит (по данным) | Чего не хватает | +|---|---|---|---| +| **A. Терминалы интеграционные** | кодек без встроенной камеры/аудио, модульная сборка, VCH/HDMI/USB | MeetingEye 400/500/600/800/900; MCore/MCore 4/Lite/Pro/OPS; MVC S40/S50/S60/S80/860; MVC-BYOD-Extender; PVT/PVB — **проверить** | `line`, `protocols`, `kit_composition`, `max_cameras/mics/speakers` | +| **B. Видеобары** | всё в одном корпусе (камера+микрофон+динамик+кодек), настольный/настенный | MeetingBar A10/A20/A25/A30/A40/A50; MeetingBoard 65–86 — **отдельно `board`** | `form_factor`, `integrated_*`, `display_size` | +| **C. Видеобары с SIP/H.323** | встроенный SIP/H.323-стек, регистрация без ПК | **в данных отсутствует**; кандидаты: MeetingEye, MeetingBar A40/A50, PVB/PVT | **`protocols`**, `sip_accounts_max`, `h323_registration`, `nat`, кодеки | +| **D. USB/BYOD** | USB-камера/донгл/хаб, работает через хост-ПК | UVC20–UVC88, SmartVision 40/60/80, MB-CAM, BYOD-BOX, WPP20/30, VCH51 | `usb_class`, `byod_capable`, `host_requirements` | +| **E. Аудио/аксессуары/инфра** | микрофоны, динамики, DSP, панели, дисплеи, крепления, PoE, питание | VCM/CM/CP/CPE/CPW/MSpeaker/PA20/CS10/AP08; CTP/MTouch; RCH/AX; MeetingDisplay/ETV | `dante_capable`, `poe_class`, `mount_type`, `display_size` | +| **T. Телефония** | SIP/DECT-телефоны, гарнитуры | SIP-T33P/T42U/T46U/T48G/T57W/T58W/T88W; W70B, WH6X, UH38, BH72 | **нет в каталоге** — только values | + +**Про «видеобары гарнитурного типа»:** в данных нет признака «гарнитура». +Правильнее ввести `form_factor: compact_bar | room_bar | board` и отдельно +`headset_support: true/false`; от этого и делить B. + +**Про SIP/H.323:** нельзя честно отнести бар к C, пока нет `protocols`. +Сначала выгружаем из даташитов `signaling: [SIP, H.323]`, `verified: true`, +потом группа C появляется как фильтр, а не как ручной список. + +## 3. Целевая структура + +### 3.1. Один канонический каталог + +```yaml +device: + id: yealink.meetingeye-500 + vendor: yealink + domain: vcs + line: vcs.terminal + role: codec + form_factor: terminal + integrated: {camera: false, mic: false, speaker: false} + protocols: {signaling: [SIP, H.323], media: [H.264, Opus], network: [...]} + ports: [{type: HDMI, count: 2, direction: out, poe_class: null}] + power: {consumption_w: 24, poe_class: null} + limits: {max_cameras: 3, max_mics: 6, max_speakers: 2} + docs: [{kind: datasheet, path: ..., url: ...}] + source: {file: ..., page: ..., extracted: rule|llm|manual, verified: true} + version: {date: 2026-11-18, changes: ...} +``` + +Хранение: **Postgres CT151, база `combine`** + YAML-экспорт для Git. +Граф: `edges(source_id,target_id,kind,constraints jsonb,source,verified,max_qty)`. +NetworkX — в памяти, Neo4j не нужен. + +### 3.2. Сервисы: 9 → 2 + +``` +combine-web (8095) — единый UI + API-gateway + OpenAPI +combine-core (8101) — один FastAPI: catalog | engine | project | draw | docs | canvas +Postgres CT151 + pgvector, Ollama 229 +``` + +- `combine-web2` удалить (дубль). +- `drawedit`/`canvas` — модули `draw`, не отдельные процессы. +- health `/health`, OpenAPI `/openapi.json`, версия API. +- миграция: старые сервисы оставить за прокси, новый core поднимать рядом. + +### 3.3. LLM-конвейер + +``` +extract → propose → verify(citation) → merge → catalog +``` + +- только `verified: true` участвует в подборе; +- дедуп с `verified.yaml`, фильтр мусора (`Pageviews`, `Downloads`); +- провенанс в каждой записи; версия каталога; +- golden set 20 комнат — регрессия. + +## 4. Что делаем сегодня (P0) + +1. **Заморозить схему** `device/edge/kit/project` (JSON Schema + версия). +2. **Дедуп 20 записей** и слияние алиасов (MeetingBoard, VCH51, VCR20, UVC84/86...). +3. **Импорт 53 values-only** как `unverified` (телефония/DECT/гарнитуры — отдельный домен). +4. **Классификация A/B/C/D/E/T** с `confidence`; C — только после `protocols`. +5. **Один health/OpenAPI** и план слияния 9 сервисов. +6. **CI-валидация**: обязательные поля, единицы, диапазоны, дубли. + +Артефакты P0 уже начаты: +- `ops/combine/taxonomy-2026-11-18.json` — группы, дубли, values-only, кандидаты C; +- `ops/combine/TAXONOMY-2026-11-18.md`. + +## 5. Roadmap + +| Этап | Срок | Результат | +|---|---|---| +| **P0** | 2–3 дня | схема, дедуп, импорт 53, группы, health/OpenAPI | +| **P1** | 1–2 недели | граф по слоям, kits, проекты/мультирум, docs, экспорт BOM | +| **P2** | 2–4 недели | CP-SAT оптимизатор, сценарии, сравнение вендоров, UI-рабочее место | + +## 6. OpenClaw в Комбайне + +- `combine.search` — найти устройство/линейку. +- `combine.device` — карточка + протоколы + документы. +- `combine.validate` — проверить конфигурацию. +- `combine.bom` — собрать BOM по сценарию. +- `combine.gaps` — ежедневный отчёт о пробелах данных. + +Секретарь отвечает: «подойдёт ли A40 для комнаты 12 мест», «есть ли SIP», +«что теряем при замене». Движок решает, LLM объясняет. + +## 7. Метрики + +- уникальных устройств / дублей = 0; +- полнота обязательных полей ≥ 90%; +- `verified` ≥ 80% для полей, влияющих на подбор; +- группа C покрыта протоколами ≥ 80%; +- BOM vs golden set — совпадение ≥ 90%; +- p95 API < 300 мс; 0 сервисов без health. + +## 8. Главные риски + +1. Дать LLM «дозаполнить» протоколы без цитат → ложные SIP/H.323. +2. Свести сервисы «в один день» и сломать UI. +3. Импортировать values-only без проверки → мусор в каталоге. +4. Оптимизатор без golden set → недоверие. +5. Дубли не по имени, а по смыслу (MeetingBoard/PVB) — автоматика не поймает. + +## 9. Главные возможности + +1. Единый каталог + протоколы → группа C и мультивендор. +2. 53 готовых устройства из values → быстрый прирост покрытия. +3. 11k LLM-фактов → атрибуты с провенансом. +4. Один API → OpenClaw-ассистент и внешние интеграции. +5. CP-SAT → варианты «дешевле/равномернее» — то, за что платят.