Files
buryan-infra/ops/work/DATASHEETS.md
T

58 lines
3.6 KiB
Markdown
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.
# Даташиты оборудования (VCS) — как добываются
Задача от 28.10.2026: собрать даташиты по каталогу оборудования (Logitech,
Yealink, Poly, SilexPro, Hitrolink, WeDoInnov, iSmart), ~250 позиций,
предпочтительно официальные сайты и русский язык.
## Что проверено фактами
| Проверка | Результат |
|---|---|
| Хост `192.168.1.10` → logitech.com, poly.com | **000**, не достаёт (блокировка/маршрут) |
| Хост → support.yealink.com | **200**, страницы читаются |
| **VPS `193.233.210.184` → logitech.com** | **200**, PDF 2.9 МБ, валидный (`PDF document, version 1.4, 3 pages`) |
| VPS → poly.com, support.yealink.com | 200 |
Вывод: скачивание идёт **через VPS** (внешний контур), затем `scp` на хост в
`/opt/work-hub/docs/datasheets/`.
## Что уже лежит
```
/opt/work-hub/docs/datasheets/
index.csv vendor, product, file, size, source_url, language, note
logitech/rallybar_nl.pdf 2.9 МБ, проверено file(1)
```
Источник: `https://www.logitech.com/content/dam/logitech/nl_nl/video-collaboration/pdf/rallybar.pdf`.
## Где узкое место
Не скачивание, а **поиск URL** конкретного документа:
1. **Logitech.** Прямые пути вида `/content/dam/logitech/<locale>/video-collaboration/pdf/<slug>.pdf`
есть, но slug не выводится из парт-номера: `rallybar` сработал,
`rallybar-mini`, `meetup`, `tap`, `rope`, `sight`, `scribe` — 404.
Нужен разбор карточки товара (на странице есть ссылка «Скачать даташит»).
2. **Yealink.** `support.yealink.com/docs/...` — страница JS-приложения,
PDF отдаётся через внутренний API (`fileID`, `attachmentID`). Нужно
разобрать один вызов и повторить его для остальных моделей.
3. **Poly / HP.** Даташиты лежат на `hp.com`/`poly.com` в dam-структуре
с непредсказуемыми путями; проще брать страницы спецификаций.
4. **SilexPro, Hitrolink, WeDoInnov, iSmart.** Небольшие вендоры, часть
материалов есть только у дистрибьютора (OCS), не на сайте.
## План
1. Получить каталог файлом (xlsx/csv) — чтобы не парсить текст вручную
и держать соответствие «парт-номер → продукт».
2. По вендорам написать адаптер: карточка товара → ссылка на PDF → скачать через VPS → проверить `file(1)` → записать в `index.csv`.
3. Порядок: Yealink (самый большой блок), Logitech, Poly/HP, затем мелкие.
4. Русский язык — где есть; иначе берём английский и помечаем `language` в индексе.
## Ограничение, о котором надо помнить
Часть вендоров не публикует даташиты открыто (нужен партнёрский логин).
Такие позиции помечаем в индексе как `manual` и складываем ссылку на карточку,
чтобы можно было открыть руками из браузера.