[PRISM] Маркетинг/L2-контекст, вкладка Материалы, 23 research-задачи, RRP/official policy
lint / hygiene (push) Failing after 32s

This commit is contained in:
root committed 2026-11-18 17:38:25 +03:00
1 parent 4e196caa2b
commit fdf1d49b29
11 files changed
+152 -10

No files matched your search

+3
View File
@@ -28,6 +28,9 @@ OCS — наша компания, но даташитов у нас нет; OCS
L2 (наличие/цена, не specs): OCS, Telinter, Poly Russia, Logitech Russia, SNK-S, КРОК, Hi-Tech.
Маркетинг: официальные брошюры/презентации/solution guides — L1; дистрибьюторские
PDF — L2-контекст. РРЦ — только официальный представитель/прайс, не дистрибьютор.
## Найденные официальные даташиты
- 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).
+59
View File
@@ -0,0 +1,59 @@
# Маркетинг и материалы
Дата: 18.11.2026
## Почему это нужно
Маркетинг вендора — это готовая практика: как позиционируют решение, для какой
комнаты, какие сценарии и преимущества, что говорить на открытой презентации.
Это не заменяет technical datasheet, но **дополняет** его.
## Уровни
| Уровень | Что | Как использовать |
|---|---|---|
| **L1 official** | product page, brochure, presentation, solution guide, battle card, video, image | позиционирование, сценарии, презентации, КП |
| **L2 distributor** | дистрибьюторский каталог, промо, локальная презентация | контекст рынка; **не specs** |
| **RRP** | официальный представитель / прайс-лист РРЦ | цена только оттуда |
## Что собирать
- официальные презентации вендора;
- solution guides и use-case decks;
- брошюры по линейкам;
- battle cards / сравнения;
- изображения, видео, схемы;
- дистрибьюторские PDF — как L2-контекст;
- РРЦ — только официальный источник.
## Формат `materials.yaml`
```yaml
materials:
- id: yealink-a40-brochure-ru
vendor: yealink
family: MeetingBar
model: MeetingBar A40
type: brochure # presentation|brochure|solution_guide|battle_card|video|image|distributor_pdf|price_rrp
title: MeetingBar A40 — брошюра
url: https://...
local_file: vendor-data/yealink/docs/a40-brochure-ru.pdf
language: ru
source_level: L1 # L1|L2
date: 2026-...
notes: для презентаций
```
## UI
Вкладка **«Материалы»**:
- поиск по модели/названию;
- фильтр по типу: презентации, брошюры, solution guide, battle card, L2;
- ссылка «открыть».
В карточке товара материалы будут привязаны к модели (следующий шаг).
## Правило
> Маркетинг показывает, **как продавать**. Datasheet показывает, **что это**.
> Не путать эти роли.
+4 -1
View File
@@ -5,7 +5,10 @@
source_policy:
L1_primary: official_manufacturer
L2_distribution: distributor_or_integrator
rule: "Specs/даташиты — только L1. L2 — наличие, цена, резерв; факт помечается."
marketing_L1: official_brochure_presentation_solution_guide
marketing_L2: distributor_context_only
price: official_representative_rrp_only
rule: "Specs/даташиты — только L1. L2 — наличие, цена, контекст; факт помечается."
vendors:
- id: audiocodes
+36 -6
View File
@@ -17,7 +17,7 @@ BOM и lifecycle. **Только официальные L1-источники Ye
На каждую VCS-модель:
1. **Официальная страница продукта** (URL).
2. **Datasheet PDF** (не маркетинговый буклет, а technical datasheet).
2. **Datasheet PDF** (technical datasheet; маркетинговый буклет — отдельно, не источник specs).
3. **Accessory / compatibility guide** — какие аксессуары, максимум, условия.
4. **Kit / bundle composition** — что входит в MVC/комплект.
5. **Lifecycle** — active / EOL / end-of-sale, дата, successor.
@@ -68,9 +68,39 @@ BOM и lifecycle. **Только официальные L1-источники Ye
- для кого/какая комната;
- конкурирующие модели внутри Yealink;
- **цены/наличие пока не нужны** (это OCS L2 позже);
- **цены/наличие**: только у официальных представителей и **РРЦ**; дистрибьюторские цены не используем как истину, наличие — отдельный L2-слой позже;
- регион/сертификация — если влияет на доступность.
## Маркетинг и презентации
Это тоже нужный слой, а не мусор:
- официальные презентации вендора;
- solution guides и use-case decks;
- брошюры и battle cards;
- сравнения линеек и позиционирование;
- изображения/видео для КП;
- **дистрибьюторские PDF** — как L2-контекст, не как specs;
- **РРЦ** — только из официального прайса/представителя.
Для материалов нужен манифест:
```csv
vendor,family,model,type,title,url,local_file,language,source_level,date
```
`type`: presentation / brochure / solution_guide / battle_card / video / image / distributor_pdf / price_rrp.
## Телефония (reference)
Телефония Yealink — **отдельный домен**, но важный: по нему часто подбирают аналоги.
Нужны:
- официальные модели SIP/DECT/конференц-телефонов/гарнитур;
- протоколы, линии, питание, порты;
- lifecycle и аналоги других вендоров (Poly, AudioCodes, Avaya, Cisco/Snom — если есть в вашей линейке);
- **не смешивать с VCS** в поиске и комнате.
## Формат
Лучше всего — **PDF + Excel/CSV-матрица**. LLM извлечёт из PDF, но матрица
@@ -114,10 +144,10 @@ model,doc_type,url,local_file,version,date,language
## Что не нужно
- дистрибьюторские PDF и пересказы;
- маркетинговые страницы без характеристик;
- цены/наличие (пока);
- телефония Yealink — она в отдельном reference-контуре, не в VCS.
- маркетинговые страницы **вместо** технического datasheet — но маркетинг как отдельный слой нужен;
- дистрибьюторские PDF как источник specs;
- цены/наличие от дистрибьюторов как истина (только официальный представитель/РРЦ);
- телефония Yealink внутри VCS-каталога — она в отдельном reference-контуре, но нужна для аналогов.
## Критерий приёмки
+6
View File
@@ -0,0 +1,6 @@
# Материалы Prism: официальный маркетинг, презентации, L2-контекст.
# type: brochure | presentation | solution_guide | battle_card | video | image |
# distributor_pdf | price_rrp
# source_level: L1 (официальный вендор) | L2 (дистрибьютор/интегратор)
# specs из L2 не считаются истиной; price_rrp — только официальный представитель/РРЦ.
materials: []
+2 -2
View File
@@ -15,7 +15,7 @@
```
research-pack/
README.md
tasks.jsonl # 22 задачи: 10 вендоров + 12 практик
tasks.jsonl # 23 задачи: 10 вендоров + 13 практик
schema-vendor.json # схема vendor audit
schema-practice.json # схема practice audit
prompt-vendor.md
@@ -73,7 +73,7 @@ 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, presales discovery, RFP response,
spec-driven compare UX, AV project documentation.
spec-driven compare UX, AV project documentation, marketing/sales enablement.
## Ограничение
+1 -1
View File
@@ -7,7 +7,7 @@
1. Официальные страницы/документация; не пересказывай случайные статьи.
2. Разделяй: персона/работа, workflow, механика, таксономия, UX, data model,
сильные/слабые стороны, метрики.
сильные/слабые стороны, метрики, маркетинговые материалы и positioning.
3. Что стоит перенять в Prism — конкретно; что не копировать — тоже.
4. Нет факта — `unknowns`, не выдумывай.
5. Только JSON, без markdown вокруг.
@@ -11,6 +11,9 @@
"job_to_be_done": {"type": "array", "items": {"type": "string"}},
"workflow_steps": {"type": "array", "items": {"type": "string"}},
"metrics": {"type": "array", "items": {"type": "string"}},
"marketing_assets": {"type": "array", "items": {"type": "string"}},
"presentation_flow": {"type": "array", "items": {"type": "string"}},
"positioning": {"type": "array", "items": {"type": "string"}},
"mechanics": {"type": "array", "items": {"type": "string"}},
"taxonomy": {"type": "object"},
"ux": {"type": "array", "items": {"type": "string"}},
+2
View File
@@ -20,4 +20,6 @@
{"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"]}
{"id":"practice-marketing-sales-enablement","kind":"practice","name":"Vendor marketing / sales enablement","official":"https://www.cisco.com","focus":"vendor presentations, solution decks, battle cards, positioning, open presentations","sources":["https://www.cisco.com","https://www.poly.com","https://www.yealink.com"]}
+15
View File
@@ -1549,6 +1549,21 @@ class H(BaseHTTPRequestHandler):
return self._out(DIRECTIONS)
if p == "/api/telephony":
return self._out(load_yaml("telephony.yaml"))
if p == "/api/materials":
v = (q.get("vendor", [""])[0] or "").lower()
m = (q.get("model", [""])[0] or "").lower()
t = (q.get("type", [""])[0] or "").lower()
data = load_yaml("materials.yaml").get("materials") or []
out = []
for x in data:
if v and str(x.get("vendor") or "").lower() != v:
continue
if m and m not in str(x.get("model") or "").lower():
continue
if t and str(x.get("type") or "").lower() != t:
continue
out.append(x)
return self._out({"materials": out})
if p == "/api/analogs":
return self._out(analog_search(q.get("q", [""])[0], q.get("domain", ["vcs"])[0]))
if p == "/api/vendor-catalog":
+21
View File
@@ -47,6 +47,7 @@ main{max-width:1560px;margin:0 auto;padding:22px 26px 70px}.view{display:none}.v
<button class="nav" data-v="room">Комната</button>
<button class="nav" data-v="telephony">Телефония</button>
<button class="nav" data-v="vendors">Вендоры</button>
<button class="nav" data-v="materials">Материалы</button>
<button class="nav" data-v="archive">Архив</button>
</nav>
<div class="spacer"></div>
@@ -104,6 +105,15 @@ main{max-width:1560px;margin:0 auto;padding:22px 26px 70px}.view{display:none}.v
<div class="card"><h3>Ветки вендоров</h3><div class="muted">Равноправные ветки. Выбор открывает поиск с фильтром вендора.</div><div id="vendorCards" class="vendors" style="margin-top:12px"></div></div>
</section>
<section id="v-materials" class="view">
<div class="card">
<h3>Материалы и презентации</h3>
<div class="muted" style="margin-bottom:10px">Официальные брошюры, презентации, solution guides и battle cards. L2-материалы дистрибьюторов — как контекст, не как specs.</div>
<div class="bar"><input id="msearch" type="search" placeholder="Модель или материал" oninput="loadMaterials()" style="flex:1"><select id="mtype" onchange="loadMaterials()"><option value="">Все типы</option><option value="presentation">Презентации</option><option value="brochure">Брошюры</option><option value="solution_guide">Solution guide</option><option value="battle_card">Battle card</option><option value="distributor_pdf">L2 дистрибьютор</option></select></div>
<div id="materialsbox"><span class="muted">загрузка…</span></div>
</div>
</section>
<section id="v-archive" class="view">
<div class="card"><h3>Архив оборудования</h3>
<div class="muted">Снято с актуальности, но не удалено: история, источник, восстановление. В поиске и аналогах архивные модели по умолчанию не участвуют.</div>
@@ -129,6 +139,7 @@ function setView(v){
$('#v-'+v).classList.add('on');
if(v==='vendors') loadVendors();
if(v==='telephony') loadTelephony();
if(v==='materials') loadMaterials();
if(v==='archive') loadArchive();
if(v==='room') loadRoomOptions();
}
@@ -140,6 +151,16 @@ async function loadTelephony(){
const rows=ds.map(d=>`<tr><td><b>${esc(d.model)}</b></td><td>${esc(d.vendor||'Yealink')}</td><td>${esc(TG[d.group]||cl(d.solution_class||d.group||''))}</td><td>${esc((d.protocols||[]).join(', ')||'SIP')}</td><td class="muted">${esc(d.note||'')}</td></tr>`).join('');
$('#telephonybox').innerHTML=`<table class="bom"><thead><tr><th>Модель</th><th>Вендор</th><th>Класс</th><th>Протоколы</th><th>Примечание</th></tr></thead><tbody>${rows}</tbody></table>`;
}
async function loadMaterials(){
$('#materialsbox').innerHTML='<span class="muted">загрузка…</span>';
const q=new URLSearchParams();
const s=$('#msearch')?.value?.trim(); const t=$('#mtype')?.value;
if(s)q.set('model',s); if(t)q.set('type',t);
const r=await api('/api/materials?'+q.toString()); const ms=r.materials||[];
if(!ms.length){$('#materialsbox').innerHTML='<div class="muted">Материалов пока нет. Добавьте официальные презентации/брошюры в materials.yaml — они появятся здесь.</div>';return;}
const rows=ms.map(x=>`<tr><td><b>${esc(x.title||x.model||'')}</b></td><td>${esc(x.vendor||'')}</td><td>${esc(x.model||'')}</td><td>${esc(x.type||'')}</td><td>${esc(x.source_level||'')}</td><td>${x.url?`<a href="${esc(x.url)}" target="_blank" rel="noopener">открыть</a>`:'—'}</td></tr>`).join('');
$('#materialsbox').innerHTML=`<table class="bom"><thead><tr><th>Материал</th><th>Вендор</th><th>Модель</th><th>Тип</th><th>L</th><th></th></tr></thead><tbody>${rows}</tbody></table>`;
}
async function loadVendors(){
const vs = await api('/api/vendors');
const opt = ['<option value="all">Все вендоры</option>'].concat((vs||[]).map(v=>`<option value="${v.id}">${esc(v.name)}</option>`)).join('');