Стратегия Комбайна
# «Комбайн»: аудит, целевая структура и план
Дата: 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 → варианты «дешевле/равномернее» — то, за что платят.