Files
buryan-infra/ops/work/web/reports/STRATEGY-2026-11-18.html
T

162 lines
10 KiB
HTML
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
<!doctype html><html lang="ru"><head><meta charset="utf-8">
<title>Стратегия Комбайна</title><style>body{font:15px/1.5 system-ui;background:#0d1117;color:#e6edf3;margin:0;padding:24px}
pre{white-space:pre-wrap;background:#161b22;border:1px solid #30363d;border-radius:10px;padding:18px;overflow:auto}
a{color:#58a6ff} .nav{margin-bottom:16px} h1{font-size:22px}</style></head>
<body><div class="nav"><a href="/">Комбайн</a> · <a href="/reports/">Отчёты</a></div>
<h1>Стратегия Комбайна</h1><pre># «Комбайн»: аудит, целевая структура и план
Дата: 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 &lt; 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 → варианты «дешевле/равномернее» — то, за что платят.
</pre></body></html>