Files
buryan-infra/ops/work/COMPATIBILITY-SOURCE.md

68 lines
4.2 KiB
Markdown
Raw Permalink 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.
# Официальные списки Yealink: что собрано
Дата: 06.11.2026. Источник: **support.yealink.com** (портал вендора).
## Технический прорыв
Страницы — Nuxt SPA. Контент лежит в `<script id="__NUXT_DATA__">` как
**ProseMirror JSON** (`{"type":"doc","content":[...]}`), таблицы — узлы `table`.
Извлекатель: `ops/work/tools/fetch_doc_tables.py`
1. `curl` страницы → `__NUXT_DATA__` → рекурсивный поиск ProseMirror-документов
2. `table → tableRow → tableCell` → чистые строки
3. YAML с источником
Работает на **всех** проверенных типах списков.
## Собранные списки (6)
| Список | Таблиц | Что даёт |
|---|---|---|
| **Audio Input/Output Compatibility** | 17 | какой вход совместим с каким выходом (встроенный микрофон, линия, VCM35, USB) |
| **Mounts & Bracket Compatibility** | 8 | матрица «кронштейн × устройство» (A25/A40/A50/A10, UVC86, MeetingBoard) |
| **Headset Compatibility** | 5 | гарнитуры: производитель, модель, подключение, совместимый телефон, интерфейс |
| **Rooms Supported Features** | 23 | функции × устройства (Auto Framing, Speaker Tracking, BYOD-режимы) |
| **Rooms Product Family** | 1 | **каталог продуктов** по сериям: MCore, MeetingBar, MeetingBoard, все модели |
| **Firmware Matching List** | 1 | соответствие версий прошивок по моделям |
**Итого: 55 таблиц** официальных данных.
## Что это даёт комбайну
1. **Каталог** — `rooms-product-family` даёт полный список моделей по сериям.
Это основа ролей и категорий.
2. **Совместимость** — audio I/O, кронштейны, гарнитуры.
3. **Функции** — `rooms-supported-features` позволяет проверять не только
«соединяется ли», но и «умеет ли» (Auto Framing, Speaker Tracking, BYOD).
4. **Прошивки** — проверка, что функции доступны в нужной версии.
## Ловушки (проверено на практике)
1. `web_fetch` на эти страницы возвращает **пустоту** — только `curl` + разбор NUXT.
2. Портал `en/portal/compatible` и `room-configurator` — пустые оболочки (3 КБ).
3. Sitemap содержит **182 919** URL, но только с хешами (`/docs/<hash>`) — по слагам не ищется.
4. Страница поиска сайта (`/en/search`) — SPA, ссылок на документы не отдаёт.
5. Пагинация sitemap: `docs-1.xml … docs-12.xml` на каждый язык (~4000 URL/файл).
6. В матрицах первый столбец пустой (заголовок строки).
## Как искать новые списки
Поиск по слагам даёт мало. Рабочий путь — адресный поиск:
«support.yealink.com compatibility lists <семейство>».
Найденные шаблоны URL: `/docs/<продукт>/<название-списка>/<32-символьный-хеш>`.
## Что осталось найти
- Камеры + аксессуары (UVC-линейка) — отдельный список
- MVC-комплекты (kit → components)
- **PRO AV** — линейка для интеграторов
- **PC как хост** (BYOD): аксессуары, работающие с ПК
- Телефония (SIP-аппараты)
## Следующий шаг
1. Найти оставшиеся списки
2. Привести всё к единой схеме:
`устройство → аксессуар → роль → лимит → условие → источник`
3. Добавить узел **PC** (хост для USB-аксессуаров)