Files
buryan-infra/ops/combine/STRATEGY-2026-11-18.md
T

9.8 KiB
Raw Blame History

«Комбайн»: аудит, целевая структура и план

Дата: 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. Один канонический каталог

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 → варианты «дешевле/равномернее» — то, за что платят.