# A1TRACK Partner Marketing Kit

Канонические материалы A1TRACK для партнёров. HTML/CSS и `manifest.json` — источники; PDF, превью, публичные HTML и ZIP собираются автоматически.

## Состав

- `sources/brandbook/` — A1TRACK Brand Guidelines, 21 страница A4 landscape;
- `sources/presentation-short/` — короткая клиентская презентация, 1 высокий лист 210 × 418 мм;
- `sources/presentation-full/` — расширенная клиентская презентация, 14 слайдов 16:9;
- `sources/web-examples/` — блок для главной и отдельная коммерческая страница;
- `assets/` — мастер-логотипы, Onest, изображения и продуктовые скриншоты;
- `manifest.json` — единый каталог страницы `/marketing` и сборки;
- `tools/build.mjs` — PDF/ZIP/public/previews;
- `tools/validate.mjs` — структурные и release-проверки.

## Состав выпуска 1.0.0

В `manifest.json` ресурс и каждый download имеют статус:

- `ready` — входит в текущий публичный выпуск;
- `draft` — остаётся в исходниках и не попадает в каталог или release-сборку.

Сейчас в выпуск входят PDF-версия Brand Guidelines, блок `homepage-block`, набор ассетов
и полный комплект, который объединяет эти готовые материалы в одном архиве. Обе презентации
и расширенная коммерческая web-страница имеют статус `draft` до отдельной финальной проверки.

## Команды

```bash
npm run marketing:validate -- --source --ready
npm run marketing:build
npm run marketing:validate -- --release
```

Полная проверка всех рабочих исходников запускается отдельно командой
`npm run marketing:validate -- --source`. Она может показывать ошибки в
материалах со статусом `draft` и не определяет готовность текущего выпуска.

Локальная разработка HTML-примеров без сборки:

```bash
npm run marketing:web:dev
```

Откройте `http://127.0.0.1:4322/`. Сервер читает файлы прямо из
`sources/web-examples/`, подключает оригиналы из `assets/` и автоматически
обновляет браузер при изменении HTML, CSS, JavaScript или ассетов. Полная сборка
для такой проверки не нужна.

Точечная PDF-сборка:

```bash
npm run marketing:pdf -- brand
npm run marketing:pdf -- short
npm run marketing:pdf -- full
```

Сборщик использует установленный Google Chrome в headless-режиме. Для превью и render-проверки PDF он автоматически ищет `pdftoppm` в `PATH`, стандартных каталогах Homebrew и локальном runtime Codex. Нестандартный путь можно передать через `PDFTOPPM_PATH`. Итоговые файлы размещаются только в `public/marketing/` и получают стабильные имена из `manifest.json`. Полная сборка создаёт только `ready`-ресурсы и удаляет публичные артефакты, помеченные `draft`. Превью сохраняют пропорции исходного материала без непрозрачных полей; фон и заполнение карточки формируются CSS страницы.

В публичные HTML-превью сборщик добавляет `robots: noindex, nofollow`, а ссылки на них в каталоге помечены `nofollow`. Release-валидация проверяет директиву. В партнёрский ZIP она не добавляется, чтобы не закрывать от поиска страницу партнёра.

## Настройка контактов партнёра

Обе презентации используют `sources/shared/partner-config.js`. HTML-примеры используют собственный `sources/web-examples/partner-config.js`. Меняются только значения конфигурации; макет править не нужно.

## Граница утверждений

Не добавлять без отдельного подтверждения:

- проценты экономии, ROI и гарантированный финансовый результат;
- универсальную совместимость оборудования;
- фиксированные сроки запуска, миграции или разработки;
- SLA, uptime, точность, срок хранения и сертификации;
- полный перенос истории из другой системы;
- white label как безусловно доступную стандартную функцию.

Конкретную модель, прошивку, протокол, состав параметров, команды и интеграцию проверяют до подключения.

## Публикация

`npm run marketing:build` воспроизводит публичный набор. В текущем manifest
`deploymentAuthorized: false`: сборка и проверка не являются разрешением на
deployment. Публикация сайта выполняется отдельно после явного решения владельца.
