> ## Documentation Index
> Fetch the complete documentation index at: https://docs.yume.cloud/llms.txt
> Use this file to discover all available pages before exploring further.

# Глоссарий: Лояльность и Wallet-дизайны

> Справочник моделей уровней лояльности, оформления карт для Apple и Google Wallet и вспомогательных валидаторов и рендеров изображений.

Справочник к странице [«Лояльность»](/ru/logic/user/loyalty).

## Понятия

| Понятие                                    | Значение                                                                                                                                                                                                                                         |
| ------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Задача пересчёта лояльности                | задача: пересчитывает уровень лояльности пользователя по сумме завершённых заказов клиента и выбирает подходящий уровень. Выбирает максимальный уровень, чей порог не превышает сумму завершённых заказов; обновляет только изменившиеся строки. |
| Валидатор минимальных размеров изображения | Валидатор, отклоняющий изображения меньше эталонного @3x-размера. Используется для минимальных размеров иконок, логотипов и полос Apple, а также логотипов и баннеров Google.                                                                    |
| Валидатор hex-цвета                        | Проверяет, что строка цвета задана в формате #RRGGBB.                                                                                                                                                                                            |
| Валидатор hex-цвета (необязательный)       | Пропускает пустое значение, иначе проверяет формат #RRGGBB.                                                                                                                                                                                      |
| Валидатор расширения изображения           | Допускает только файлы PNG или JPEG.                                                                                                                                                                                                             |
| Рендер квадратного варианта                | Вписывает изображение по центру в прозрачный PNG-квадрат заданного размера; используется для квадратных ассетов (иконки Apple).                                                                                                                  |
| Рендер варианта с сохранением пропорций    | Масштабирует изображение с сохранением пропорций и возвращает PNG; используется для логотипов и полос.                                                                                                                                           |

## Модели и поля

### Уровень лояльности

*Уровень программы лояльности: процент кэшбэка и лимиты, привязанные к порогу суммы завершённых заказов. Порог активации определяется полем порога; уровень пользователя пересчитывается задачей пересчёта лояльности.*

| Поле              | Тип              | Описание                                                       |
| ----------------- | ---------------- | -------------------------------------------------------------- |
| Название          | текст            | Название уровня лояльности (необязательное).                   |
| Процент           | число            | Процент начисления/кэшбэка на уровне (по умолчанию 3).         |
| Порог (цена)      | число (2 знака)  | Порог суммы завершённых заказов, с которого действует уровень. |
| Лимит начисления  | число (2 знака)  | Максимальная сумма начисления (по умолчанию 200000).           |
| Лимит по времени  | интервал времени | Ограничение по длительности события (по умолчанию 3 дня).      |
| Лимит на доставку | число (2 знака)  | Максимальная сумма по доставке (по умолчанию 15000).           |

### Дизайн карты Apple Wallet

*Оформление карты лояльности для Apple Wallet: цвета, тексты и изображения с автогенерацией вариантов @2x/@1x. Связь 1:1 с уровнем лояльности; варианты @2x/@1x генерируются из исходных @3x-изображений.*

**Связи**

| Поле               | Тип   | Описание                                  |
| ------------------ | ----- | ----------------------------------------- |
| Уровень лояльности | связь | Связь один-к-одному с уровнем лояльности. |

**Цвета**

| Поле          | Тип         | Описание                                |
| ------------- | ----------- | --------------------------------------- |
| Цвет фона     | текст (hex) | Цвет фона карты в формате #RRGGBB.      |
| Цвет текста   | текст (hex) | Основной цвет текста в формате #RRGGBB. |
| Цвет подписей | текст (hex) | Цвет подписей/меток в формате #RRGGBB.  |
| Цвет полосы   | текст (hex) | Цвет верхней полосы (необязательный).   |

**Тексты**

| Поле                    | Тип   | Описание                            |
| ----------------------- | ----- | ----------------------------------- |
| Текст рядом с логотипом | текст | Текст, отображаемый возле логотипа. |
| Убрать блик на полосе   | флаг  | Отключает эффект блика на полосе.   |
| Описание                | текст | Текстовое описание карты.           |

**Логотип**

| Поле          | Тип         | Описание                               |
| ------------- | ----------- | -------------------------------------- |
| Логотип (@3x) | изображение | Исходный логотип; минимум 160×50 px.   |
| Логотип @2x   | изображение | Автогенерируемый вариант логотипа @2x. |
| Логотип @1x   | изображение | Автогенерируемый вариант логотипа @1x. |

**Иконка**

| Поле         | Тип         | Описание                                        |
| ------------ | ----------- | ----------------------------------------------- |
| Иконка (@3x) | изображение | Исходная квадратная иконка; минимум 87×87 px.   |
| Иконка @2x   | изображение | Автогенерируемый квадратный вариант иконки @2x. |
| Иконка @1x   | изображение | Автогенерируемый квадратный вариант иконки @1x. |

**Полоса**

| Поле         | Тип         | Описание                                                                  |
| ------------ | ----------- | ------------------------------------------------------------------------- |
| Полоса (@3x) | изображение | Исходное изображение верхней полосы; минимум 1125×432 px (необязательно). |
| Полоса @2x   | изображение | Автогенерируемый вариант полосы @2x.                                      |
| Полоса @1x   | изображение | Автогенерируемый вариант полосы @1x.                                      |

### Дизайн карты Google Wallet

*Оформление карты лояльности для Google Wallet: цвет, названия, уровни вознаграждений, изображения и текстовые модули. Связь 1:1 с уровнем лояльности.*

**Связи**

| Поле               | Тип   | Описание                                  |
| ------------------ | ----- | ----------------------------------------- |
| Уровень лояльности | связь | Связь один-к-одному с уровнем лояльности. |

**Цвета**

| Поле      | Тип         | Описание                           |
| --------- | ----------- | ---------------------------------- |
| Цвет фона | текст (hex) | Цвет фона карты в формате #RRGGBB. |

**Тексты**

| Поле                   | Тип   | Описание                           |
| ---------------------- | ----- | ---------------------------------- |
| Название программы     | текст | Название программы лояльности.     |
| Подпись ID аккаунта    | текст | Подпись к идентификатору аккаунта. |
| Подпись имени аккаунта | текст | Подпись к имени аккаунта.          |

**Вознаграждения**

| Поле                               | Тип   | Описание                                    |
| ---------------------------------- | ----- | ------------------------------------------- |
| Уровень вознаграждения             | текст | Значение уровня вознаграждения.             |
| Подпись уровня вознаграждения      | текст | Подпись к уровню вознаграждения.            |
| Доп. уровень вознаграждения        | текст | Вторичное значение уровня вознаграждения.   |
| Подпись доп. уровня вознаграждения | текст | Подпись к вторичному уровню вознаграждения. |

**Изображения**

| Поле              | Тип         | Описание                                                         |
| ----------------- | ----------- | ---------------------------------------------------------------- |
| Логотип программы | изображение | Логотип программы; минимум 660×660 px.                           |
| Баннер (hero)     | изображение | Широкое изображение-баннер; минимум 1032×336 px (необязательно). |

**Модули**

| Поле             | Тип              | Описание                                     |
| ---------------- | ---------------- | -------------------------------------------- |
| Текстовые модули | список           | JSON-список дополнительных текстовых блоков. |
| Модуль ссылок    | структура (JSON) | JSON-объект с ссылками карты.                |

### Валидатор минимальных размеров изображения

*Валидатор, отклоняющий изображения меньше эталонного @3x-размера.*

| Поле               | Тип   | Описание                                 |
| ------------------ | ----- | ---------------------------------------- |
| Минимальная ширина | число | Минимально допустимая ширина в пикселях. |
| Минимальная высота | число | Минимально допустимая высота в пикселях. |
| Метка              | текст | Название актива для сообщения об ошибке. |
