# Промпт Cursor: работа с CDN YouOnline24

**Публичная ссылка:** https://cdn.youonline24.ru/docs/v1/cursor-cdn.html  
**Документация по интеграции:** https://cdn.youonline24.ru/docs/v1/integration.html

Скопируйте этот текст в чат Cursor при задачах сборки, деплоя и публикации файлов на CDN.

---

## Контекст

Репозиторий платформы YouOnline24: `BS_youonline24`.  
Публичный CDN: **https://cdn.youonline24.ru**  
Деплой файлов: **FTP** на `ftp.youonline24.ru`.

Учётные данные FTP хранятся локально в файле `deploy/ftp.credentials` (в git не коммитится). Перед деплоем прочитай этот файл.

Формат `deploy/ftp.credentials`:

```
FTP_HOST=ftp.youonline24.ru
FTP_USER=cdn_manager@cdn.youonline24.ru
FTP_PASS=<пароль>
FTP_REMOTE_ROOT=/
CDN_BASE_URL=https://cdn.youonline24.ru
```

---

## Структура на CDN

Загружай файлы с сохранением путей относительно корня CDN:

```
/
├── design/v1/
│   └── yo24-tokens.css
├── blocks/v1/
│   ├── yo24-blocks.js
│   ├── yo24-footer.js
│   ├── yo24-donate.js
│   └── yo24-base.css
├── brand/v1/
│   └── logo_you24.png
├── config/v1/
│   └── projects.json
└── docs/v1/
    ├── integration.html
    └── cursor-cdn.html
```

Локальный источник для сборки:

- `packages/design-tokens/` → `dist/design/v1/`
- `packages/blocks/` → `dist/blocks/v1/`
- `packages/config/` → `dist/config/v1/`
- `packages/docs/cdn/` + `docs/INTEGRATION.md` → `dist/docs/v1/`

Перед загрузкой убедись, что актуальные файлы собраны в `dist/` с той же структурой путей.

---

## Правила деплоя

1. **Не коммить** `deploy/ftp.credentials` и пароли в репозиторий.
2. **Не перезаписывать** мажорные версии (`v1` → `v2`) без явного запроса — ломаются подключённые сайты.
3. После загрузки **проверь URL в браузере**, например:
   - https://cdn.youonline24.ru/design/v1/yo24-tokens.css
   - https://cdn.youonline24.ru/blocks/v1/yo24-blocks.js
4. Для JS/CSS укажи корректный `Content-Type` на сервере (если FTP-клиент не выставляет автоматически).
5. При обновлении файлов в той же версии (`v1`) — сайты подхватят изменения после сброса кэша браузера/CDN.

---

## Задачи, которые ты выполняешь

### Сборка перед деплоем

1. Скопировать/собрать файлы из `packages/` в `dist/` с путями `design/v1/`, `blocks/v1/`, `config/v1/`.
2. Если есть bundler — запустить сборку; иначе копировать вручную с сохранением структуры.

### Деплой по FTP

1. Прочитать `deploy/ftp.credentials`.
2. Подключиться к `ftp.youonline24.ru` под пользователем `cdn_manager@cdn.youonline24.ru`.
3. Загрузить содержимое `dist/` в `FTP_REMOTE_ROOT`, сохраняя структуру каталогов.
4. Не удалять на сервере каталоги других версий (`v1`, будущий `v2`) без подтверждения.

Инструменты (на выбор, в зависимости от окружения):

- `lftp` — `mirror -R dist/ /`
- PowerShell + `WinSCP` / `.NET FtpWebRequest`
- Node-скрипт с `basic-ftp`

Если автоматический деплой невозможен — выведи пошаговую инструкцию и список файлов для ручной загрузки.

### Проверка после деплоя

1. `curl -I https://cdn.youonline24.ru/design/v1/yo24-tokens.css` — статус 200.
2. Открыть URL в браузере, убедиться что содержимое актуальное.
3. Если обновлялся `projects.json` — проверить JSON на валидность.

### Новая мажорная версия (v2)

Только по явному запросу:

1. Создать каталоги `design/v2/`, `blocks/v2/` на CDN.
2. Обновить документацию на CDN: https://cdn.youonline24.ru/docs/v1/integration.html
3. Не трогать файлы в `v1/`.

---

## Ограничения дизайна (напоминание)

- Только **светлая** тема.
- Цвета: `#5a189a`, `#ff9e00`, `#000`, `#fff`, `#f7f7f7`.
- Web Components, не iframe и не копипаста HTML футера.

---

## Пример запроса пользователя

> «Собери dist и залей yo24-tokens.css и projects.json на CDN»

**Твои шаги:** сборка → чтение credentials → FTP upload → curl-проверка → краткий отчёт со списком залитых URL.

---

## Связанные файлы в репозитории

- https://cdn.youonline24.ru/docs/v1/integration.html — документация для разработчиков
- https://cdn.youonline24.ru/docs/v1/cursor-cdn.html — этот промпт
- `deploy/ftp.credentials.example` — шаблон без пароля
- `packages/design-tokens/yo24-tokens.css` — исходник токенов