Сами уровни лояльности (название, процент кэшбэка, порог суммы, лимит начисления), правило выдачи самого дешёвого уровня новому пользователю, привязка уровня к аккаунту пользователя, а также назначение карт Apple/Google Wallet уже подробно разобраны на отдельной странице. Здесь эти вещи упоминаются кратко, а раскрываются новые детали: автогенерация вариантов изображений и правила проверки файлов и цветов.Подробнее: «Программа лояльности».
Почему это живёт в модуле пользователей
«Уровень лояльности» и оба оформления карт (для Apple Wallet и Google Wallet) физически описаны рядом с моделью пользователя, в общих (глобальных) таблицах, не привязанных к компании. Причина в том, что ссылка на уровень лояльности хранится прямо в аккаунте пользователя, а фоновая задача пересчёта проходит по всем пользователям. Концептуально же это часть клиентской программы лояльности, поэтому смысловые детали (уровни, проценты, лимиты, назначение карт) описаны на странице «Программа лояльности», а на этой странице — только техническая механика, которой там нет.Модель данных
Уровень лояльности
Уровень лояльности задаёт процент начисления и набор лимитов, действующих начиная с определённого порога суммы завершённых заказов.
Порог активации задаётся полем «Порог (цена)»: именно по нему фоновая задача выбирает подходящий уровень для пользователя (см. раздел ниже).
Дизайн карты Apple Wallet
Оформление карты для Apple Wallet связано с уровнем лояльности отношением один-к-одному — на каждый уровень приходится не более одной записи такого дизайна. Запись хранит цвета, тексты и изображения карты.
Кроме трёх исходных изображений (в разрешении @3x) в записи хранятся автоматически создаваемые уменьшенные варианты @2x и @1x для логотипа, иконки и полосы. Эти варианты недоступны для ручного редактирования — они пересобираются системой из исходников.
Дизайн карты Google Wallet
Оформление карты для Google Wallet тоже связано с уровнем лояльности один-к-одному и хранит цвет, названия, уровни вознаграждений, изображения и дополнительные текстовые блоки.В отличие от карты Apple Wallet, оформление для Google Wallet не создаёт автоматически уменьшенных вариантов изображений — Google принимает исходные изображения и масштабирует их на своей стороне. Поэтому здесь хранятся только исходный логотип и баннер.
Проверки загружаемых данных
Перед сохранением цвета и изображения проходят набор проверок. Они одинаково применяются и в админке, и при программном сохранении.Проверка цветов
- Обязательные цвета проверяются на строгий формат
#RRGGBB(решётка и ровно шесть шестнадцатеричных символов). Значение вне этого формата отклоняется. - Необязательные цвета (например, цвет верхней полосы на карте Apple Wallet) допускают пустое значение; если значение задано — оно проверяется по тому же формату.
Проверка файлов изображений
- Расширение. Принимаются только файлы PNG или JPEG; файлы других форматов отклоняются.
- Минимальный размер. Каждое исходное изображение проверяется на минимальные размеры в пикселях, соответствующие эталонному разрешению @3x. Если ширина или высота меньше требуемой, файл отклоняется с сообщением, в котором указаны требуемый и фактический размеры.
Автогенерация вариантов изображений Apple Wallet
Apple Wallet ожидает изображения в трёх плотностях (@3x, @2x, @1x). Пользователь загружает только исходное изображение @3x, а варианты @2x и @1x система готовит сама при сохранении оформления карты.Когда варианты пересобираются
При каждом сохранении оформления система сначала определяет, какие из трёх исходных изображений (логотип, иконка, полоса) изменились с момента последнего чтения из базы:- Для новой записи изменившимися считаются все непустые исходные изображения.
- Для существующей записи текущие значения сравниваются с тем, что сейчас хранится в базе; в набор изменившихся попадают только реально заменённые или очищенные изображения.
Что происходит с каждым изменившимся изображением
- Если исходник заменён — старые варианты @2x и @1x удаляются, из нового исходника генерируются свежие варианты и сохраняются.
- Если исходник очищен (загруженное ранее изображение убрали) — оба варианта тоже удаляются и обнуляются.
- Квадратный вариант (для иконки): изображение уменьшается с сохранением пропорций и вписывается по центру в прозрачный квадрат заданного размера. Итог — всегда квадратная картинка нужной стороны, даже если исходник был не строго квадратным.
- Вариант с сохранением пропорций (для логотипа и полосы): изображение уменьшается так, чтобы уместиться в заданные габариты, пропорции сохраняются, лишнего поля не добавляется.
Все сгенерированные варианты сохраняются в формате PNG с прозрачностью, независимо от формата исходного файла. То есть даже если загрузить логотип в JPEG, варианты @2x/@1x будут PNG. Имя файла варианта — случайное.
Порядок сохранения
Сохранение оформления Apple Wallet выполняется в два прохода: сначала запись сохраняется целиком (чтобы у неё был идентификатор и исходные изображения были записаны), затем при необходимости отдельно дозаписываются только поля вариантов. Второй проход выполняется лишь тогда, когда варианты действительно пересобирались.Фоновый пересчёт уровня лояльности
Уровень лояльности пользователя пересчитывается фоновой задачей на основе суммы его завершённых заказов.Как считается уровень
- Для каждого пользователя суммируются суммы (со скидкой) по его заказам в статусе «Завершён». Заказы связываются с пользователем через привязанного к заказу клиента.
- По полученной сумме подбирается подходящий уровень лояльности — берётся уровень с наибольшим порогом, который не превышает эту сумму (то есть самый «высокий» из доступных пользователю).
- Обновляются только те пользователи, у которых подобранный уровень отличается от текущего. Строки без изменений не переписываются. При этом, если для пользователя подходящий уровень подобрать не удалось (пустое значение), его строка не обновляется вовсе — текущий уровень сохраняется.
Как это используется
- При создании нового пользователя ему сразу присваивается самый дешёвый (с наименьшим порогом) уровень лояльности — стартовый уровень программы.
- По мере накопления завершённых заказов фоновый пересчёт поднимает пользователя на более высокий уровень, как только сумма достигает соответствующего порога.
- Оформление карт (цвета, тексты, изображения) задаётся отдельно для каждого уровня и используется при генерации карт Apple Wallet и Google Wallet. Подробнее о самих картах — на странице «Программа лояльности».
Связанные страницы
Глоссарий: Лояльность и Wallet-дизайны
Полный перечень полей уровня лояльности и обоих оформлений карт.
Пользователи и доступ
Обзорная страница раздела: аккаунт, участие в компании, роли и права.
Проблемы и логические ошибки
Сводный разбор известных багов и логических нюансов всего модуля.
Аккаунт и участие в компании
Как аккаунт связан с телефоном, как устроено участие в компаниях и откуда берутся роли.
Вход в систему
По каким данным можно войти — телефон, логин или адрес почты — и откуда берутся права.
Сессии и срок действия входа
Сколько живёт вход, как он продлевается и когда потребуется войти заново.
Как система определяет вашу компанию
Определение компании по адресу сайта или по аккаунту и что делать, если компании ещё нет.
Профиль и управление сотрудниками
Редактирование своего профиля, добавление сотрудников и назначение им ролей.
Сброс пароля по коду
Восстановление доступа по коду из письма, с ограничением частоты запросов.
Вход через Google
Вход по аккаунту Google и связывание его с существующим профилем.