[COMBINE] Стратегия: каноническая модель, группы A-E/T, 9->2 сервиса, P0/P1/P2, OpenClaw tools
lint / hygiene (push) Failing after 16s
lint / hygiene (push) Failing after 16s
This commit is contained in:
1 parent
f088fc19d3
commit
8b99fb9f65
1 file changed
+156
@@ -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 → варианты «дешевле/равномернее» — то, за что платят.
|
||||
Reference in new issue
Block a user