diff --git a/ops/combine/PRISM-QUALITY-BAR.md b/ops/combine/PRISM-QUALITY-BAR.md new file mode 100644 index 0000000..29e84e5 --- /dev/null +++ b/ops/combine/PRISM-QUALITY-BAR.md @@ -0,0 +1,84 @@ +# Prism — quality bar + +Дата: 18.11.2026 + +Цель: не «каталог», а **рабочее место пресейла**: от запроса клиента до +проверенного решения/BOM, с честными данными и понятным интерфейсом. + +## 1. Пользователи и работы + +| Персона | Работа | +|---|---| +| Sales engineer | быстро найти модель/аналог, собрать решение, ответить на ТЗ | +| Presales / architect | комната, совместимость, порты, замены, ограничения | +| Procurement | что можно купить, чем заменить снятое, наличие/срок | +| Manager | покрытие, качество данных, воронка запросов | +| Партнёр/клиент | понятное предложение без внутренних кодов | + +## 2. Путь + +``` +Запрос/ТЗ → Discovery → Поиск → Сравнение → Комната/BOM → Проверка → КП → Lifecycle +``` + +Каждый шаг должен оставлять артефакт: фильтр, сравнение, комнату, BOM, версию. + +## 3. UX-инварианты + +1. **Не более 3 кликов** до карточки/аналога из поиска. +2. **Никаких внутренних кодов** в UI: только человеческие названия; код — в + tooltip/API. +3. **Сравнение 2–4 моделей** — persistent tray, side-by-side specs, «что теряем». +4. **Вендор — граница**: аксессуары другого вендора не подставляются. +5. **Снятое** остаётся, но помечено «купить нельзя»; в проект — можно. +6. **Неизвестно = `—`**, не выдуманное значение. +7. **Любой экран** ведёт к действию: в проект, сравнить, аналоги, КП. +8. **Состояние сохраняется**: фильтры, сравнение, комната. +9. **Быстро**: поиск < 300 мс на локальных данных, без «крутилки» на каждый чих. +10. **Доступность**: клавиатура, контраст, фокус, мобильная версия. + +## 4. Практики, которые берём + +| Практика | Что взять | Источник | +|---|---|---| +| System Surveyor | визуальная совместная проверка плана до КП | [systemsurveyor.com](https://www.systemsurveyor.com) | +| Baymard | compare tray, persistent selection, side-by-side specs | [Baymard](https://baymard.com) | +| Responsive/Loopio | answer library, цитаты, collaboration, win-rate | [Responsive](https://www.responsive.io) | +| CPQ | простые правила, approvals, валидная конфигурация | [Everstage CPQ](https://www.everstage.com/cpq/cpq-strategies) | +| AtroPIM | категории языком покупателя, коды отдельно | [AtroPIM](https://www.atropim.com/en/blog/product-taxonomy-best-practices) | +| D-Tools | site survey, BOM, installation docs, change orders | [D-Tools](https://www.d-tools.com) | +| Octopart/SiliconExpert | parametric search, cross-reference, lifecycle | [Octopart](https://octopart.com) | + +## 5. Что не копируем + +- глубокие деревья категорий без навигационной ценности; +- внутренние коды в UI; +- vendor-first навигацию; +- «похожие» без объяснения; +- скрытые ограничения совместимости; +- каталог без источников и статуса данных; +- сравнение без лимита и без «что теряем». + +## 6. Метрики качества + +- 0 смешанных VCS/телефония результатов; +- 100% карточек с источником или `—`; +- ≥ 90% моделей с заполненными обязательными specs (после research); +- 0 дублей в ветке; +- p95 поиска < 300 мс; +- время «запрос → BOM» < 10 минут для типовой комнаты; +- 0 «купить» у архивных; +- все аналоги объяснены (why/gaps). + +## 7. Roadmap качества + +1. **Сейчас**: данные/таксономия/архив/комната с количествами и зависимостями. +2. **Далее**: compare tray, saved views, coverage dashboard, source badges. +3. **Потом**: companion-проекты, версии BOM, КП, change monitor. +4. **Затем**: OCS-наличие/цена, CRM/1C, роли/аудит. + +## 8. Принцип + +> LLM предлагает — официальный L1-источник подтверждает — человек видит цитату. + +Без этого инструмент превращается в красивую базу слухов. diff --git a/ops/combine/research-pack/README.md b/ops/combine/research-pack/README.md index c57f30e..919a3ed 100644 --- a/ops/combine/research-pack/README.md +++ b/ops/combine/research-pack/README.md @@ -15,7 +15,7 @@ ``` research-pack/ README.md - tasks.jsonl # 18 задач: 10 вендоров + 8 практик + tasks.jsonl # 22 задачи: 10 вендоров + 12 практик schema-vendor.json # схема vendor audit schema-practice.json # схема practice audit prompt-vendor.md @@ -72,7 +72,8 @@ python run_research.py ... Вендоры: Yealink, AudioCodes, Avaya, Poly, Logitech, IVA, Hitrolink, САТЕЛ, ФЛАТ, Информтехника. Практики: Cisco CCW, Yealink Room Designer, Logitech Configurator, Poly, Crestron/Extron, -Octopart/SiliconExpert, Akeneo/Pimcore, B2B CPQ. +Octopart/SiliconExpert, Akeneo/Pimcore, B2B CPQ, presales discovery, RFP response, +spec-driven compare UX, AV project documentation. ## Ограничение diff --git a/ops/combine/research-pack/prompt-practice.md b/ops/combine/research-pack/prompt-practice.md index fc345f8..afbd5bf 100644 --- a/ops/combine/research-pack/prompt-practice.md +++ b/ops/combine/research-pack/prompt-practice.md @@ -6,7 +6,8 @@ ## Правила 1. Официальные страницы/документация; не пересказывай случайные статьи. -2. Разделяй: механика, таксономия, UX, data model, сильные/слабые стороны. +2. Разделяй: персона/работа, workflow, механика, таксономия, UX, data model, + сильные/слабые стороны, метрики. 3. Что стоит перенять в Prism — конкретно; что не копировать — тоже. 4. Нет факта — `unknowns`, не выдумывай. 5. Только JSON, без markdown вокруг. diff --git a/ops/combine/research-pack/schema-practice.json b/ops/combine/research-pack/schema-practice.json index e1eb0f3..592e6ed 100644 --- a/ops/combine/research-pack/schema-practice.json +++ b/ops/combine/research-pack/schema-practice.json @@ -7,6 +7,10 @@ "practice": {"type": "string"}, "source_url": {"type": "string"}, "what_it_is": {"type": "string"}, + "persona": {"type": "array", "items": {"type": "string"}}, + "job_to_be_done": {"type": "array", "items": {"type": "string"}}, + "workflow_steps": {"type": "array", "items": {"type": "string"}}, + "metrics": {"type": "array", "items": {"type": "string"}}, "mechanics": {"type": "array", "items": {"type": "string"}}, "taxonomy": {"type": "object"}, "ux": {"type": "array", "items": {"type": "string"}}, diff --git a/ops/combine/research-pack/tasks.jsonl b/ops/combine/research-pack/tasks.jsonl index 43a84d0..05dce7b 100644 --- a/ops/combine/research-pack/tasks.jsonl +++ b/ops/combine/research-pack/tasks.jsonl @@ -16,3 +16,8 @@ {"id":"practice-octopart-siliconexpert","kind":"practice","name":"Octopart / SiliconExpert","official":"https://octopart.com","focus":"параметрический поиск, cross-reference, аналоги, lifecycle","sources":["https://octopart.com","https://www.siliconexpert.com"]} {"id":"practice-akeneo-pimcore","kind":"practice","name":"Akeneo / Pimcore PIM","official":"https://www.akeneo.com","focus":"taxonomy, attributes, families, lifecycle, governance","sources":["https://www.akeneo.com","https://pimcore.com"]} {"id":"practice-b2b-cpq","kind":"practice","name":"B2B CPQ","official":"https://www.salesforce.com/products/cpq/","focus":"quote, configurator, approvals, pricing, CRM","sources":["https://www.salesforce.com/products/cpq/"]} +{"id":"practice-presales-discovery","kind":"practice","name":"Presales discovery / visual collaboration","official":"https://www.systemsurveyor.com","focus":"discovery, site survey, visual collaboration, proposal revisions","sources":["https://www.systemsurveyor.com"]} +{"id":"practice-rfp-response","kind":"practice","name":"RFP / proposal response","official":"https://www.responsive.io","focus":"answer library, citations, collaboration, win-rate metrics","sources":["https://www.responsive.io","https://www.loopio.com"]} +{"id":"practice-compare-ux","kind":"practice","name":"Spec-driven comparison UX","official":"https://baymard.com","focus":"compare tray, side-by-side specs, selection affordances, limits","sources":["https://baymard.com"]} +{"id":"practice-project-docs","kind":"practice","name":"AV project documentation","official":"https://www.d-tools.com","focus":"site survey, drawings, BOM, installation docs, change orders","sources":["https://www.d-tools.com"]} + diff --git a/ops/scripts/build_reports.py b/ops/scripts/build_reports.py index d948226..5f6d94c 100644 --- a/ops/scripts/build_reports.py +++ b/ops/scripts/build_reports.py @@ -20,6 +20,7 @@ FILES = [ ("UX-стратегия", "/root/buryan-infra/ops/combine/COMBINE-UX-STRATEGY.md"), ("Datasheet research", "/root/buryan-infra/ops/combine/DATASHEET-RESEARCH.md"), ("Видение продукта", "/root/buryan-infra/ops/combine/PRISM-PRODUCT-VISION.md"), + ("Quality bar", "/root/buryan-infra/ops/combine/PRISM-QUALITY-BAR.md"), ("Архив оборудования", "/root/buryan-infra/ops/combine/ARCHIVE.md"), ("P0.7 мусорные факты", "/root/buryan-infra/ops/combine/P0-JUNK-REPORT-2026-11-18.md"), ("Нормализация каталога", "/root/buryan-infra/ops/combine/NORMALIZATION-REPORT-2026-11-18.md"), diff --git a/ops/work/web/reports/DATASHEET-RESEARCH.html b/ops/work/web/reports/DATASHEET-RESEARCH.html index dbac7f0..d5a3f43 100644 --- a/ops/work/web/reports/DATASHEET-RESEARCH.html +++ b/ops/work/web/reports/DATASHEET-RESEARCH.html @@ -3,45 +3,49 @@ 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} -

Datasheet research

# Datasheet-ресёрч: новые вендоры
+

Datasheet research

# Datasheet-ресёрч: official-first
 
 Дата: 18.11.2026
 
-## Правило
+## Иерархия источников
 
-1. Официальный сайт производителя — первичный источник.
-2. Подтверждённый дистрибьютор — вторичный, только для моделей/наличия.
-3. LLM извлекает **строго по схеме** и прикладывает URL/страницу/цитату.
-4. Нет цитаты — `null`, не «примерно».
-5. Модель попадает в ветку только после проверки.
+| Уровень | Кто | Для чего |
+|---|---|---|
+| **L1** | официальный сайт производителя | specs, даташиты, документация — **истина** |
+| **L2** | дистрибьюторы и интеграторы (OCS, КРОК, Hi-Tech, Telinter) | наличие/цена/срок; резервные материалы только с пометкой |
 
-## Вендоры и источники
+Правило: **даташит дистрибьютора не является источником истины**.  
+OCS — наша компания, но даташитов у нас нет; OCS — L2: наличие/цена, не specs.
 
-| Вендор | Официальный | Дистрибьютор/партнёр | Статус |
-|---|---|---|---|
-| AudioCodes | [audiocodes.com](https://www.audiocodes.com) | [Telinter](https://telinter.ru/news/telinter-i-audiocodes-soglashenie-o-sotrudnichestve/) | official_found |
-| Avaya | [avaya.com](https://www.avaya.com) | Verysell (Avaya Diamond) | official_found |
-| Poly | [poly.com](https://www.poly.com) | [poly.com.ru](https://www.poly.com.ru/contacts) | branch_loaded |
-| Logitech («Logy») | [logitech.com](https://www.logitech.com) | [logitechav.ru](https://www.logitechav.ru/contacts) | branch_loaded |
-| IVA Technologies | [iva.ru](https://iva.ru) | [OCS Distribution](https://iva.ru/ru/partneram/) | branch_loaded |
-| Hitrolink | [hitrolink.tech](https://hitrolink.tech) | [SNK-S](https://snk-s.ru) | branch_loaded |
-| САТЕЛ | [satel.ru](https://satel.ru) | — | official_found |
-| ФЛАТ (Flat) | [flat-soft.ru](https://flat-soft.ru) | Softline | official_found |
-| Информтехника | [minicom.ru](https://www.minicom.ru) | — | official_found |
+## Вендоры
 
-## Что уже найдено как даташиты
+| Вендор | L1 официальный | L2 резерв |
+|---|---|---|
+| AudioCodes | [audiocodes.com](https://www.audiocodes.com) | [КРОК](https://www.croc.ru) |
+| Avaya («Awaya») | [avaya.com](https://www.avaya.com) | [КРОК](https://www.croc.ru) |
+| Poly | [poly.com](https://www.poly.com) | [Hi-Tech](https://hi-tech.su) (проверить) |
+| Logitech («Logy») | [logitech.com](https://www.logitech.com) | [КРОК](https://www.croc.ru) |
+| IVA | [iva.ru](https://iva.ru) | [Hi-Tech](https://hi-tech.su) (проверить) |
+| Hitrolink | [hitrolink.tech](https://hitrolink.tech) | [КРОК](https://www.croc.ru) |
+| САТЕЛ | [satel.ru](https://satel.ru) | — |
+| ФЛАТ (Flat) | [flat-soft.ru](https://flat-soft.ru) | — |
+| Информтехника | [minicom.ru](https://www.minicom.ru) | — |
 
-- AudioCodes: [RXVCam70 PTZ](https://www.audiocodes.com/media/4j2l0edn/rxvcam70-ptz-camera-datasheet.pdf), [RXVCAM10-CC](https://backoffice.audiocodes.com/media/ho5lvolz/rxvcam10-cc-content-camera-datasheet.pdf).
-- Avaya: [XT/H175 documentation](https://support.avaya.com/css/public/documents/101035634).
-- Poly: [Poly Studio datasheet](https://www.poly.com/content/dam/www/products/video/studio/studio/doc/poly-studio-ds-it.pdf).
-- Logitech: [CC5000e Plus](https://www.logitech.com/zh-cn/products/video-conferencing/room-solutions/rally-ultra-hd-conferencecam.960-001277.html).
-- IVA: [LARGO 310 datasheet](https://iva.ru/assets/content/iva-largo-310-datasheet..pdf).
-- Hitrolink: [ASP35](https://snk-s.ru/Downloads/HTI-ASP35%20%e2%80%94%20%d0%a2%d0%b5%d1%85%d0%bd%d0%b8%d1%87%d0%b5%d1%81%d0%ba%d0%b0%d1%8f%20%d1%81%d0%bf%d0%b5%d1%86%d0%b8%d1%84%d0%b8%d0%ba%d0%b0%d1%86%d0%b8%d1%8f%20ENG%20(02.2025).pdf), [M240](https://snk-s.ru/Downloads/HTI-A-M240%20%20%e2%80%94%20%d0%a2%d0%b5%d1%85%d0%bd%d0%b8%d1%87%d0%b5%d1%81%d0%ba%d0%b0%d1%8f%20%d1%81%d0%bf%d0%b5%d1%86%d0%b8%d1%84%d0%b8%d0%ba%d0%b0%d1%86%d0%b8%d1%8f%20ENG%20(01.2025).pdf).
-- САТЕЛ / ФЛАТ / Информтехника: официальные порталы найдены, конкретные даташиты — в очередь.
+L2 (наличие/цена, не specs): OCS, Telinter, Poly Russia, Logitech Russia, SNK-S, КРОК, Hi-Tech.
 
-Полный машинный список: `VENDOR-SOURCES-2026-11-18.yaml`.
+## Найденные официальные даташиты
 
-## LLM-схема извлечения
+- AudioCodes [RXVCam70](https://www.audiocodes.com/media/4j2l0edn/rxvcam70-ptz-camera-datasheet.pdf), [RXVCAM10-CC](https://backoffice.audiocodes.com/media/ho5lvolz/rxvcam10-cc-content-camera-datasheet.pdf), [Mediant 9080C](https://www.audiocodes.com/media/ftnex1o5/mediant-9080c-sbc-datasheet.pdf).
+- Avaya [XT/H175](https://support.avaya.com/css/public/documents/101035634).
+- Poly [Studio datasheet](https://www.poly.com/content/dam/www/products/video/studio/studio/doc/poly-studio-ds-it.pdf).
+- Logitech [CC5000e Plus](https://www.logitech.com/zh-cn/products/video-conferencing/room-solutions/rally-ultra-hd-conferencecam.960-001277.html).
+- IVA [LARGO 310](https://iva.ru/assets/content/iva-largo-310-datasheet..pdf).
+- Hitrolink официальный портал; конкретные PDF — искать в официальном разделе документации, не у SNK-S.
+- САТЕЛ / ФЛАТ / Информтехника — официальные порталы, конкретные PDF в очередь.
+
+Полный реестр: `VENDOR-SOURCES-2026-11-18.yaml`.
+
+## LLM-схема
 
 ```yaml
 vendor: audiocodes
@@ -49,39 +53,30 @@ model: RXVCam70
 domain: vcs
 solution_class: vcs.camera.ptz
 role: camera
-form_factor: camera
 specs:
   camera.4k: true
   camera.zoom_optical: 12
   camera.fov_h: 119
   audio.pickup_m: null
-  audio.mic_count: null
-  protocols: []
-source:
-  kind: official_datasheet
-  url: https://...
-  page: 1
-  quote: "12x optical zoom ... 119° DFOV ..."
+protocols: []
+source: {level: L1, url: ..., page: 1, quote: "..."}
 verified: true
 ```
 
-Правила:
-- `domain`/`solution_class` — только после проверки роли;
-- SIP/H.323 — только если явно в даташите;
-- числа — с единицами;
-- конфликт двух источников → `conflict`, не усреднять.
+- L1 → specs;
+- L2 → наличие/цена/резерв; specs только с флагом `needs_confirmation`, не в основной каталог;
+- нет цитаты → `null`;
+- конфликт → `conflict`, не усреднять.
 
 ## Очередь
 
-1. AudioCodes: камеры/бары/терминалы, официальные PDF.
-2. Avaya: XT/H175/Vantage — только VCS-часть, не телефония.
-3. САТЕЛ: ВКС-оборудование и терминалы.
-4. ФЛАТ: софт/терминалы, проверить, что относится к VCS.
-5. Информтехника/Миником: ВКС-терминалы.
-6. Poly/Logitech/IVA/Hitrolink: дополнить specs и модели.
+1. AudioCodes — официальные камеры/терминалы/SBC.
+2. Avaya — XT/H175/Vantage, только VCS.
+3. Poly/Logitech/IVA/Hitrolink — добить официальные specs.
+4. САТЕЛ/ФЛАТ/Информтехника — официальные страницы продуктов.
+5. L2 (КРОК/Hi-Tech) — только если L1 реально нет; помечать.
 
 ## Ограничение
 
-Найденные ссылки — **кандидаты**, не загруженные даташиты. Модели не добавляем,
-пока нет извлечённых specs и цитаты.
+Ссылки — кандидаты. Модель попадает в каталог только после L1-цитаты.
 
\ No newline at end of file diff --git a/ops/work/web/reports/PRISM-QUALITY-BAR.html b/ops/work/web/reports/PRISM-QUALITY-BAR.html new file mode 100644 index 0000000..97e6793 --- /dev/null +++ b/ops/work/web/reports/PRISM-QUALITY-BAR.html @@ -0,0 +1,90 @@ + +Quality bar + +

Quality bar

# Prism — quality bar
+
+Дата: 18.11.2026
+
+Цель: не «каталог», а **рабочее место пресейла**: от запроса клиента до
+проверенного решения/BOM, с честными данными и понятным интерфейсом.
+
+## 1. Пользователи и работы
+
+| Персона | Работа |
+|---|---|
+| Sales engineer | быстро найти модель/аналог, собрать решение, ответить на ТЗ |
+| Presales / architect | комната, совместимость, порты, замены, ограничения |
+| Procurement | что можно купить, чем заменить снятое, наличие/срок |
+| Manager | покрытие, качество данных, воронка запросов |
+| Партнёр/клиент | понятное предложение без внутренних кодов |
+
+## 2. Путь
+
+```
+Запрос/ТЗ → Discovery → Поиск → Сравнение → Комната/BOM → Проверка → КП → Lifecycle
+```
+
+Каждый шаг должен оставлять артефакт: фильтр, сравнение, комнату, BOM, версию.
+
+## 3. UX-инварианты
+
+1. **Не более 3 кликов** до карточки/аналога из поиска.
+2. **Никаких внутренних кодов** в UI: только человеческие названия; код — в
+   tooltip/API.
+3. **Сравнение 2–4 моделей** — persistent tray, side-by-side specs, «что теряем».
+4. **Вендор — граница**: аксессуары другого вендора не подставляются.
+5. **Снятое** остаётся, но помечено «купить нельзя»; в проект — можно.
+6. **Неизвестно = `—`**, не выдуманное значение.
+7. **Любой экран** ведёт к действию: в проект, сравнить, аналоги, КП.
+8. **Состояние сохраняется**: фильтры, сравнение, комната.
+9. **Быстро**: поиск < 300 мс на локальных данных, без «крутилки» на каждый чих.
+10. **Доступность**: клавиатура, контраст, фокус, мобильная версия.
+
+## 4. Практики, которые берём
+
+| Практика | Что взять | Источник |
+|---|---|---|
+| System Surveyor | визуальная совместная проверка плана до КП | [systemsurveyor.com](https://www.systemsurveyor.com) |
+| Baymard | compare tray, persistent selection, side-by-side specs | [Baymard](https://baymard.com) |
+| Responsive/Loopio | answer library, цитаты, collaboration, win-rate | [Responsive](https://www.responsive.io) |
+| CPQ | простые правила, approvals, валидная конфигурация | [Everstage CPQ](https://www.everstage.com/cpq/cpq-strategies) |
+| AtroPIM | категории языком покупателя, коды отдельно | [AtroPIM](https://www.atropim.com/en/blog/product-taxonomy-best-practices) |
+| D-Tools | site survey, BOM, installation docs, change orders | [D-Tools](https://www.d-tools.com) |
+| Octopart/SiliconExpert | parametric search, cross-reference, lifecycle | [Octopart](https://octopart.com) |
+
+## 5. Что не копируем
+
+- глубокие деревья категорий без навигационной ценности;
+- внутренние коды в UI;
+- vendor-first навигацию;
+- «похожие» без объяснения;
+- скрытые ограничения совместимости;
+- каталог без источников и статуса данных;
+- сравнение без лимита и без «что теряем».
+
+## 6. Метрики качества
+
+- 0 смешанных VCS/телефония результатов;
+- 100% карточек с источником или `—`;
+- ≥ 90% моделей с заполненными обязательными specs (после research);
+- 0 дублей в ветке;
+- p95 поиска < 300 мс;
+- время «запрос → BOM» < 10 минут для типовой комнаты;
+- 0 «купить» у архивных;
+- все аналоги объяснены (why/gaps).
+
+## 7. Roadmap качества
+
+1. **Сейчас**: данные/таксономия/архив/комната с количествами и зависимостями.
+2. **Далее**: compare tray, saved views, coverage dashboard, source badges.
+3. **Потом**: companion-проекты, версии BOM, КП, change monitor.
+4. **Затем**: OCS-наличие/цена, CRM/1C, роли/аудит.
+
+## 8. Принцип
+
+> LLM предлагает — официальный L1-источник подтверждает — человек видит цитату.
+
+Без этого инструмент превращается в красивую базу слухов.
+
\ No newline at end of file diff --git a/ops/work/web/reports/index.html b/ops/work/web/reports/index.html index 97f6b76..8664253 100644 --- a/ops/work/web/reports/index.html +++ b/ops/work/web/reports/index.html @@ -3,4 +3,4 @@ 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} -

Отчёты

\ No newline at end of file +

Отчёты

\ No newline at end of file