9.8 KiB
«Комбайн»: аудит, целевая структура и план
Дата: 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)
- Заморозить схему
device/edge/kit/project(JSON Schema + версия). - Дедуп 20 записей и слияние алиасов (MeetingBoard, VCH51, VCR20, UVC84/86...).
- Импорт 53 values-only как
unverified(телефония/DECT/гарнитуры — отдельный домен). - Классификация A/B/C/D/E/T с
confidence; C — только послеprotocols. - Один health/OpenAPI и план слияния 9 сервисов.
- 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. Главные риски
- Дать LLM «дозаполнить» протоколы без цитат → ложные SIP/H.323.
- Свести сервисы «в один день» и сломать UI.
- Импортировать values-only без проверки → мусор в каталоге.
- Оптимизатор без golden set → недоверие.
- Дубли не по имени, а по смыслу (MeetingBoard/PVB) — автоматика не поймает.
9. Главные возможности
- Единый каталог + протоколы → группа C и мультивендор.
- 53 готовых устройства из values → быстрый прирост покрытия.
- 11k LLM-фактов → атрибуты с провенансом.
- Один API → OpenClaw-ассистент и внешние интеграции.
- CP-SAT → варианты «дешевле/равномернее» — то, за что платят.