Руководство администратора платформы лояльности

01 Введение

Что это за документ и кому он адресован

Это подробное справочное руководство по платформе лояльности для ресторанов. Оно описывает каждый экран и каждую настройку админ-панели, а также кассовый модуль и то, что видит гость. Используйте его как полный справочник — если нужна короткая шпаргалка для официанта на кассе или для гостя, есть отдельные короткие руководства именно для них.

У платформы три роли, у каждой — свой вход и свой адрес:

02 Тарифы и лицензия

DEMO, BASIC, PRO, ENTERPRISE — что доступно на каждом уровне

Тариф ресторану назначает платформа — самостоятельного апгрейда из панели нет, но запросить продление или переход на другой тариф можно прямо из раздела «Настройки» (см. ниже).

Запросить продление или смену тарифа можно на странице «Настройки»: там показан текущий тариф и срок действия лицензии, а кнопка «Запросить продление» отправляет заявку — с вами свяжутся, чтобы оформить продление или переход на другой тариф.

03 Вход в админ-панель

Адрес и способ входа для владельца/администратора

Админ-панель находится по адресу https://loyalty.solvit.work/login. Вход — по email и паролю, которые вам выдаёт платформа при подключении ресторана. После входа вы попадаете на «Дашборд» — стартовую страницу со сводкой по ресторану.

1. Откройте страницу входа

   Перейдите на https://loyalty.solvit.work/login в браузере компьютера или планшета.

2. Введите email и пароль

   Используйте учётные данные, выданные при подключении ресторана к платформе.

3. Проверьте язык интерфейса

   В правом верхнем углу переключатели RU / EN / CG меняют язык самой панели — они не влияют на то, что видит гость (см. раздел «Гости на разных языках»).

04 Дашборд

Сводка по ресторану на главном экране

«Дашборд» — первая страница после входа. Вверху под заголовком выводится список активных программ лояльности одной строкой (у демо-ресторана: «Кэшбэк 5%, Кэшбэк выходного дня (+1€), Скидка 10% для Платины, Штамп-карта: 10-й кофе в подарок»).

Далее — четыре карточки с ключевыми метриками:

Ниже — отдельная карточка «Всего транзакций»: суммарное число всех операций начисления и списания за всё время.

Блок «Динамика за 14 дней» — столбчатый график с тремя рядами за каждый день: серый — «Потрачено (€)» (сумма чеков), оранжевый — «Начислено (€)», зелёный — «Погашено (€)». По нему удобно увидеть, растёт ли активность и какая доля начисленного гости реально забирают обратно.

Блок «Источники гостей» показывает долю гостей, добавленных персоналом вручную, против тех, кто зарегистрировался сам («Самостоятельная регистрация») — полезно понять, откуда приходит база.

Рядом — блок «Сегменты гостей»: цветная полоска и список с числом гостей в каждом RFM-сегменте (Чемпион/Лояльный/Дрейфующий/Уходящий/Новый — см. раздел «Сегменты»). Клик по любому сегменту в этом списке открывает «Гости» с уже применённым фильтром по этому сегменту.

Ниже — блок «Уровни гостей»: та же идея, но по уровням (Серебро/Золото/Платина у демо-ресторана), включая уровни, до которых пока никто не дошёл — с числом «0». Клик по уровню точно так же открывает отфильтрованный список «Гости».

Таблица «Топ гостей по тратам» — восемь гостей с наибольшей суммой покупок: имя, число визитов и всего потрачено; клик по имени ведёт на детальную страницу гостя. Рядом — блок «Дни рождения» с переключателем периода (7/30/90 дней): кто из гостей отмечает день рождения в ближайшее время, с датой и числом дней до неё — удобно свериться вручную, даже если автоматическая кампания «День рождения» (раздел «Кампании») уже включена.

Таблица «Эффективность программ» — по каждой активной программе: статус («Активна»/«Выключена»), сколько раз она сработала и сколько всего начислено по ней. Это самый быстрый способ увидеть, какая именно программа реально работает, а какая простаивает.

05 Гости

Список гостей, фильтры и карточка одного гостя

Раздел «Гости» открывается пунктом меню «Гости». Сверху — кнопки «QR для саморегистрации» (показывает QR-код ссылки самостоятельной регистрации, тот же, что и в «Настройках») и «+ Новый гость» (добавить гостя вручную).

Блок «Фильтры» позволяет сузить список по: сегменту («Все гости» / конкретный сегмент), полу, уровню, числу дней без визита («Не был визитов, дней»), диапазону среднего чека, минимальной сумме всего потраченного и минимальному числу визитов. Кнопки «Применить» и «Сбросить» управляют фильтрами.

Таблица гостей содержит колонки: Имя, Карта (номер вида LC-XXXXXXXXX), Телефон, Баланс, Уровень (цветной бейдж — например «СЕРЕБРО», «ЗОЛОТО», «ПЛАТИНА»), Сегмент (тоже бейдж — «Новый», «Чемпион», «Лояльный», «Дрейфующий», «Уходящий»), Всего потрачено, Визитов и Средний чек. Заголовки колонок кликабельны для сортировки.

Карточка гостя

Клик по имени гостя открывает детальную страницу. Она показывает:

• Имя, бейдж уровня (например «ПЛАТИНА»), номер карты, телефон и дату регистрации, с ссылкой «Изменить» рядом с уровнем — назначить гостю уровень вручную, а не дожидаться автоматического расчёта по сумме покупок;
• кнопку «История уровня» рядом с «Изменить» — открывает список всех ручных изменений уровня этого гостя: дата и время, с какого уровня на какой изменили, и кто именно (email администратора). Автоматические переходы при накоплении трат в этот список не попадают — только осознанные ручные назначения;
• карточки баланса по каждой активной программе, в которой у гостя есть накопления (например «Кэшбэк 5%: €12.4», «Кэшбэк выходного дня (+1€): €12», «Штамп-карта: 10-й кофе в п...: 12 × / 10»);
• блок «Статистика» — всего потрачено, всего начислено, всего погашено, число визитов, дата первого и последнего визита;
• QR-код карты гостя («Карта гостя (QR)») и ссылку «Открыть страницу гостя →»;
• зелёный баннер «Готово: …» с кнопкой «Выдать», если у гостя есть готовая награда по штамп-карте (как на примере — «Готово: Штамп-карта: 10-й кофе в подарок»);
• полную таблицу истории транзакций — дата, тип операции, описание и сумма, самые новые сверху.

Отдельно на этой же странице — два инструмента симуляции, полезные, если гость расплачивается не через официанта, а администратор сам пробивает операцию из панели:

• «Симулировать покупку (POS)» — поле «Сумма чека, €» и кнопка «Провести покупку». Применяются сразу все подходящие активные программы, точно так же, как на кассе.
• «Списать» — показывает текущий совокупный бонус («Бонусы: €24.4»), поле «Сумма» и кнопка «Списать» для ручного погашения баланса.

Справа также есть блок «Личное уведомление» — поля «Заголовок» и «Текст сообщения» с кнопкой «Отправить этому гостю»: точечный push конкретному гостю, в отличие от массовой рассылки в разделе «Уведомления».

06 Сегменты

Автоматический RFM-анализ и кастомные группы гостей

Раздел «Сегменты» показывает автоматическую RFM-сегментацию (Recency/Frequency — давность и частота визитов) и произвольные группы гостей для точечного маркетинга. Стандартные сегменты пересчитываются автоматически, без какого-либо ручного действия администратора:

Каждая строка таблицы «Сегменты» показывает название, метку («стандартный» — для встроенных RFM-сегментов, без метки — для собственных), тип сегмента и текущее число гостей в нём.

Помимо стандартных, можно создавать собственные сегменты кнопкой «+ Новый сегмент». Тип сегмента бывает двух видов:

• Динамический — по фильтру, обновляется автоматически (например сегмент «Мужчины», построенный по полу — обновляется сам по мере изменения данных гостей, ссылка «Изменить фильтр»);
• Статический — вручную выбранные гости (например «VIP список» — фиксированный список, который вы наполняете сами через ссылку «Управлять гостями»).

07 Кампании

Автоматические сценарии — работают сами, без участия администратора

Раздел «Кампании» содержит два встроенных автоматических сценария. Каждый включается/выключается независимо галочкой «Включено» и, будучи включённым, проверяется раз в день без какого-либо дальнейшего вмешательства администратора.

🎂 День рождения

За X дней до дня рождения гость получает бонус в выбранную программу; в сам день рождения ему приходит напоминание; если бонус не использован, через Y дней после он автоматически сгорает. В примере на скриншоте: начислять за 3 дня до, сумма бонуса €5, сгорание — через 14 дней после дня рождения, программа для начисления — «Кэшбэк 5%».

Поля настройки: «За сколько дней начислять бонус», «Сумма бонуса, €», «Сгорание бонуса через, дней после ДР», «Программа для начисления» (выпадающий список из существующих программ). Кнопка «Сохранить» применяет изменения.

🔄 Реактивация

Срабатывает в момент, когда гость переходит из сегмента «Лояльные» в «Дрейфующие» (то есть проходит порог в 45+ дней без визита) — гость автоматически получает push-уведомление с «приветственным оффером», без необходимости дожидаться какого-либо действия администратора. В примере: заголовок push-уведомления «Соскучились!», текст «Мы приготовили для вас бонус — загляните в гости 🙂», необязательный бонус за возвращение €3 в программу «Кэшбэк 5%».

Поля настройки: «Заголовок push-уведомления», «Текст уведомления», «Бонус за возвращение, € (необязательно)», «Программа для начисления (необязательно)».

Под настройками каждой кампании — таблица «История запусков»: гость, событие («Бонус начислен», «Бонус сгорел», «Оффер отправлен») и дата. По ней владелец видит, что автоматизация действительно срабатывает, а не просто включена «на бумаге».

08 Программы лояльности

Правила «условие → действие», можно держать активными несколько сразу

Раздел «Программы» — сердце системы. Каждая программа — это правило вида «условие → действие»; активными одновременно может быть сколько угодно программ разных типов (например кэшбэк 5% + отдельная программа штампов + скидка по выходным).

Для любой программы можно задать дополнительные условия: минимальная/максимальная сумма покупки, конкретные дни недели, конкретные часы, «только первая покупка», «только в день рождения гостя», ограничение по уровням.

В таблице программ — колонки Название, Условие (например «без условий», «от €5», «уровень: Платина»), Действие (например «× 10», «-10%», «+€1», «5% (max €20)») и Статус («Активна»), а также действия «Изменить», «Выключить», «Удалить».

09 Уровни (тиры)

Автоматические уровни по накопленной сумме покупок

Уровень гостя определяется автоматически по накопленной сумме покупок за всё время. Названия уровней — произвольные: Silver/Gold/Platinum, Bronze/Ruby или свои — как удобно ресторану. У демо-ресторана настроены три уровня:

Как только сумма всех покупок гостя за всё время достигает порога следующего уровня, гость автоматически переходит на него — никакого ручного действия администратора не требуется. Уровень отображается цветным бейджем рядом с именем гостя везде: в списке гостей, на его детальной странице и на его собственной карте.

Уровень можно назначить и вручную — кнопкой «Изменить» рядом с бейджем уровня на детальной странице гостя (раздел «Гости»). Это полезно для VIP-исключений: например, гость ещё не дотратил до «Платины» по формальному порогу, но заслуживает статуса за лояльность или по договорённости лично. Ручное назначение фиксируется как отдельная запись в «Истории уровня» этого гостя (дата, направление изменения, email администратора, который это сделал) — а вот естественный переход при накоплении трат в эту историю не попадает, поскольку это не решение человека, а обычное следствие покупок.

10 Дизайн карты

Оформление, которое видит гость везде

Раздел «Дизайн карты лояльности» позволяет задать: название на карте, подпись (например название программы — «Карта лояльности гостя»), логотип (эмодзи или загруженное изображение), фоновый рисунок карты или градиент из двух цветов («Основной цвет» и «Доп. цвет»), и цвет текста. Справа — живое превью на демо-данных, обновляющееся сразу при изменении полей.

11 Push-уведомления

Массовая рассылка и история доставки

Раздел «Push-уведомления» показывает число подписанных гостей («Подписано гостей: 11») и напоминание: гость включает уведомления сам на своей странице карты (кнопка «Получать уведомления о бонусах») — никого нельзя подписать принудительно из панели.

Ниже — форма массовой рассылки: поле «Заголовок, напр. «Выходные бонусы»», поле «Текст сообщения» и кнопка «Отправить всем». Так рассылается один и тот же текст сразу всем подписанным гостям (в отличие от точечного «Личного уведомления» на странице конкретного гостя).

Таблица «История рассылок — для оценки эффективности маркетинговых кампаний» показывает по каждой прошлой рассылке: дату, заголовок, число «Доставлено», «Не доставлено» и «Охват, %».

12 Настройки

Тариф, название ресторана, PIN персонала, сгорание бонусов, ссылки

Раздел «Настройки» собирает административные параметры ресторана в одном месте:

• Тариф и лицензия — текущий тариф (например «Enterprise»), срок действия («Без ограничения по сроку» либо конкретная дата) и кнопка «Запросить продление» (см. раздел «Тарифы и лицензия»);
• Название ресторана — используется в шапке панели и на карте гостя;
• PIN официантов — теперь у каждого кассира свой личный PIN, а не один общий код на весь персонал: PIN-коды выдаются, меняются и отзываются на отдельной странице «Персонал» (см. следующий раздел), а не здесь. Здесь, в «Настройках», PIN больше не задаётся;
• Защита от мошенничества персонала — два порога: «Порог оповещения, €» (покупка или списание крупнее этой суммы попадает в список «Подозрительная активность» на странице «Персонал» для проверки постфактум) и «Порог подтверждения менеджером, €» (операция крупнее этой суммы не проходит на кассе, пока рядом не введёт свой PIN менеджер — см. раздел «Кассовый модуль»). Пороги задаются отдельно для начисления и для списания;
• Автоблокировка кассы при выключении экрана — галочка «Блокировать кассовую сессию при выключении экрана»: если включена, официант выходит из кассового модуля при блокировке/выключении экрана телефона, и следующему, кто откроет ссылку, снова нужно ввести PIN — полезно, если устройство передаётся между сменами или может остаться без присмотра;
• Автоматическое сгорание бонусов — если гость не появлялся дольше указанного срока, можно списывать часть или весь накопленный бонус; включается галочкой «Включить сгорание бонусов»;
• Ссылка для официантов — постоянная ссылка вида http://.../staff/{slug}, которую нужно открыть на телефоне/планшете официанта; вход теперь — по личному PIN конкретного кассира;
• Ссылка для саморегистрации гостей — ссылка вида http://.../join/{slug}; QR-код для неё также доступен на странице «Гости».

13 Сети: независимые точки и единый бренд

Два разных способа управлять несколькими точками на платформе — с разбором на примерах.

Сеть объединяет две и более ваших точек так, что гости — а иногда и программы лояльности — узнаются на всех точках сразу, а не остаются изолированными в рамках одной точки. Сети доступны на тарифе ENTERPRISE и настраиваются командой платформы по вашему запросу (см. Тарифы и лицензия) — создать сеть самостоятельно в админ-панели нельзя. Как только точки объединены в сеть, на каждой из них в верхнем меню появляется ссылка «Моя сеть», а рядом с названием ресторана — выпадающий список для переключения между точками.

Каждая сеть настраивается ровно в одном из двух режимов, который выбирается один раз, когда команда платформы создаёт сеть: независимые точки или единый бренд. Это не «более или менее» одного и того же — это принципиально разный ответ на вопрос «работает ли карта гостя одинаково на всех точках?». Дальше — разбор обоих режимов на двух реальных демо-сетях со скриншотами бок о бок.

Независимые точки

Этот режим — для группы заведений, у которых общий владелец или бэк-офис, но по сути это разные бизнесы: например, пляжное кафе отеля и его рум-бар на крыше, с разным меню, разными ценами, и без причины, почему кэшбэк за кофе, заработанный в одном месте, должен тратиться в другом.

По умолчанию независимая точка ничем не отличается от обычного отдельного ресторана — её гости, программы и дизайн карты полностью её собственные, а гость, зарегистрировавшийся на одной точке, на другой совершенно не известен. Единственное, что сеть добавляет поверх этого — переключатель «Использовать единый QR-код в сети» на странице «Моя сеть»:

Вот эта разница на реальных демо-данных. Marko Petrović регистрируется и делает покупку на €42 в Adriatic — Beach Café, где действует своя программа кэшбэка 8%:

Переключитесь на точку-сиблинг Adriatic — Rooftop Bar (кнопкой «Switch to» на странице «Моя сеть» или через выпадающий список рядом с названием ресторана) и найдите тот же номер карты:

Имя, номер карты и телефон Marko одинаковы на обеих точках — это и есть общая идентичность в действии, и именно поэтому в строке гостя на Rooftop Bar под именем появляется пометка (Adriatic — Beach Café) — небольшой ярлык домашней точки, который показывается только для гостя, узнанного откуда-то ещё в сети. Но его баланс, уровень, сегмент, сумма покупок и число визитов считаются на каждой точке независимо, и на Rooftop Bar они начинаются с нуля, несмотря на историю покупок в Beach Café.

Для независимых сетей на странице «Моя сеть» есть ещё два специальных инструмента:

1. Скопировать настройки

   Разовое копирование уровней, программ и дизайна карты текущей точки на одну или несколько выбранных точек-сиблингов — по имени: совпадающее по имени обновляется, новое создаётся. Это удобство для быстрой настройки нескольких похожих точек, а не постоянная синхронизация: если потом отредактировать программу, автоматически она заново не разойдётся. Панель результата показывает, что именно было создано, обновлено или пропущено (пропуск бывает, когда имя неоднозначно совпадает с несколькими объектами на целевой точке).

2. Перейти (Switch to)

   Все точки сети, их текущее число гостей и статус лицензии перечислены в одной таблице — кнопка «Перейти» рядом с любой точкой-сиблингом мгновенно переключает вашу сессию туда, без выхода и повторного входа под другими данными. У точек независимой сети нет общего логина, как у единого бренда (см. ниже), но если вы один и тот же владелец/админ на нескольких точках, это избавляет от переключения между разными аккаунтами.

Единый бренд

Этот режим — для случая, когда все точки на самом деле — одна и та же программа лояльности под разными адресами: например, сеть кофеен, где штамп-карта, начатая в центре города, должна продолжать заполняться и в филиале в аэропорту, потому что для гостя (и для бренда) это одни отношения лояльности, а не несколько разных.

У единого бренда — ровно один логин на всю сеть, созданный один раз для первой («владеющей») точки сети; каждая добавленная позже точка доступна только через переключение на неё, тем же механизмом «Перейти», что и у независимых сетей. Отдельного переключателя «единый QR-код» тут нет и не нужно: идентичность, баланс, уровень и прогресс по штампам всегда полностью общие для всех точек единого бренда — в этом весь смысл режима, поэтому это не настраивается.

Сравните с примером независимой сети выше: у Marko в Rooftop Bar все цифры обнулились. У Ana в Airport цифры точно такие же, как в Downtown — €4.50 всего потрачено, уровень SILVER, уже засчитан один визит. Это и есть объединение (pooling), и именно это означает «единый» на практике.

Два способа управления конфигурацией единого бренда

Любая сеть с единым брендом использует общую конфигурацию, но у платформы есть два разных механизма, которыми эта общность поддерживается, и от того, какой из них использует ваша сеть, зависит, как выглядят страница «Моя сеть» и страница «Программы». Оба механизма дают гостю и кассиру одинаковый результат — разница исключительно в том, как админ-панель синхронизирует точки «под капотом», но её стоит узнавать на экране, потому что формулировки действительно разные.

Классический механизм (с него начинается любая сеть с единым брендом): каждая точка физически хранит свою копию каждого уровня, программы и настройки дизайна карты. Изменение с любой точки автоматически и мгновенно записывается в копии всех точек-сиблингов — с точки зрения администратора это ведёт себя как одна общая конфигурация, но «под капотом» это N синхронизированных копий, а не одна вещь.

Новый механизм HQ: для сетей, которые команда платформы перевела на этот механизм (разовый, обратимый переход), никакого «разброса копий» больше нет — программы, уровни и дизайн карты живут как одна физическая строка на точке-владельце сети, и каждая другая точка просто читает эту же строку. Текст на странице «Моя сеть» при этом меняется и упоминает одну дополнительную возможность, которая существует только в этом режиме:

Адресация программ по точкам (только для сетей на HQ)

Сеть на механизме HQ дополнительно может ограничить любую отдельную программу конкретными точками, вместо того чтобы она всегда была активна везде. Это по-настоящему новая возможность, которой нет на классическом механизме синхронизированных копий — там программа либо активна на всей сети, либо отключена на всей сети, ничего промежуточного. На странице «Программы» сети на HQ появляется дополнительная колонка «Точки» с одним переключателем-чипом на каждую точку:

Клик по чипу точки включает или выключает программу на ней: зелёный — активна на этой точке, серый — нет. Новая программа, созданная на сети с HQ, изначально не нацелена ни на одну точку (сознательное решение платформы — программа никогда не включается где-то по умолчанию молча); включите все чипы, чтобы получить поведение как в классической модели «везде сразу», или оставьте частичную адресацию для чего-то вроде бонуса только для точки в аэропорту, который не должен применяться к гостям, никогда не покидающим центр города.

Как выбрать между двумя типами сети

Это решение команда платформы принимает вместе с вами при настройке сети, а не то, что вы настраиваете сами позже — но полезно понимать, какие вопросы его определяют:

• Должен ли бонус, заработанный на одной точке, тратиться на другой? Если да — это единый бренд. Если каждая точка должна вести свою собственную «бухгалтерию» бонусов — это независимые точки.
• У всех точек действительно один и тот же набор программ, уровней и брендинга — или каждой нужны свои цены, свои пороги уровней, свой внешний вид? Одинаково везде — довод в пользу единого бренда; заметно по-разному — довод в пользу независимых точек.
• Хотите ли вы, чтобы карта гостя узнавалась (даже если баланс не общий) на точках, которые в остальном работают независимо — например, чтобы ресепшен отеля мог найти гостя, который также постоянный посетитель ресторана при отеле? Это независимые точки с включённым единым QR-кодом — промежуточный вариант между двумя крайностями.

14 Персонал: PIN, роли, устройства

Личные PIN-коды кассиров, роли, устройства и защита от мошенничества

Раздел «Персонал» — единое место для управления всеми, кто работает на кассе: от выдачи личного PIN до разбора подозрительных операций. Он состоит из трёх блоков.

Кассиры

Таблица со всеми сотрудниками, у которых есть доступ к кассовому модулю: имя, роль и статус. У каждого кассира — свой личный PIN-код, отдельный от чужих. Доступные действия в строке сотрудника:

• Роль — выпадающий список «Кассир» / «Менеджер». Роль «Менеджер» даёт право подтверждать своим PIN операции других кассиров, превышающие порог подтверждения (см. ниже и раздел «Настройки»);
• Сбросить PIN — выдаёт новый PIN взамен старого, если сотрудник его забыл или есть подозрение, что код узнали посторонние;
• Деактивировать — отключает доступ сотрудника к кассе без удаления истории его операций; все прошлые транзакции по-прежнему показывают, кто их провёл.

Новый кассир добавляется кнопкой «+ Новый кассир»: имя, роль и автоматически сгенерированный PIN, который нужно один раз сообщить сотруднику лично.

Устройства

Первое устройство, с которого сотрудник входит по своему PIN, подтверждается автоматически. Каждое следующее новое устройство (например, если кассир получил новый телефон, или кто-то пытается войти с чужого PIN на незнакомом устройстве) появляется здесь в списке как ожидающее подтверждения — вход на нём заблокирован, пока администратор или менеджер не нажмёт «Подтвердить». Уже подтверждённые устройства можно в любой момент отозвать кнопкой «Отозвать» — например, если телефон потерян или сотрудник уволился.

Подозрительная активность

Список операций, превысивших «Порог оповещения, €» из раздела «Настройки» (отдельно для начислений и списаний) — например, слишком крупная разовая покупка или списание бонуса необычного размера. По каждой записи: кто провёл операцию, сумма, гость и дата, а также три действия — «Подтвердить» (операция признана легитимной), «Отклонить» (если необходимо, операция помечается как ошибочная/подозрительная) и «Отметить как проверено» (просто снять с контроля без явного вердикта). Это ретроспективная проверка — сама операция на кассе уже прошла; для операций, требующих подтверждения ДО завершения, см. следующий блок.

15 Кассовый модуль (для персонала)

Вход по PIN, сканирование карты гостя, начисление и списание

Кассовый модуль — это отдельный, максимально упрощённый мобильный интерфейс для официантов, без email и пароля. Он открывается по ссылке из «Настроек» и по умолчанию остаётся залогиненным на устройстве смены (если в «Настройках» не включена автоблокировка при выключении экрана — тогда официант выходит из кассы при каждой блокировке экрана и вводит PIN заново). У каждого кассира — свой личный PIN (выдаётся и управляется на странице «Персонал», см. предыдущий раздел), а не один общий код на всех. Подробная пошаговая инструкция для официанта есть в отдельном коротком руководстве кассира — здесь описан тот же процесс с точки зрения администратора.

1. Вход по личному PIN

   Официант открывает ссылку персонала и вводит свой личный PIN, выданный на странице «Персонал». Первое устройство подтверждается автоматически; при входе с нового устройства может понадобиться подтверждение администратора или менеджера (см. раздел «Персонал»).

2. Экран «Сканировать карту гостя»

   Камера телефона сканирует QR-код с карты, чека или стола гостя. Если камеру не удалось запустить (занята другим приложением или её нет), появляется жёлтое предупреждение «Не удалось запустить камеру...» со ссылкой «Попробовать снова» — и в любом случае ниже всегда доступен ручной способ: поле «Номер карты, напр. LC-123456789» и кнопка «Найти по номеру».

3. Экран начисления/списания

   После того как гость найден, открывается его карточка с именем, бейджем уровня, текущим балансом и списком активных программ, а ниже — переключатель из двух режимов и цифровая клавиатура. Ссылка «← Сканировать другую» над карточкой гостя в любой момент возвращает к экрану сканирования — искать следующего гостя не нужно перезагружать страницу.

Два режима на экране начисления переключаются кнопками-табами:

• «Начислить (покупка)» — официант вводит сумму чека на цифровой клавиатуре и нажимает «Провести покупку». Все подходящие активные программы применяются автоматически — кэшбэк начисляется, скидка уже учтена в сумме, которую должен заплатить гость, штамп добавляется — выбирать программы вручную не нужно.
• «Списать (€X.XX)» — кнопка сразу показывает полный текущий баланс гостя (например «Списать (€24.4)»); официант вводит, сколько из этого баланса списать в счёт текущего чека, и нажимает «Списать».

Если у гостя уже готова награда по штамп-карте, вместо необходимости вводить сумму сверху появляется зелёный баннер «🎁 Готово: [название штамп-карты] — [подсказка гостю]» с кнопкой «Выдать» для выдачи одним нажатием.

16 Карта гостя

Что видит гость на своей персональной странице

Страница карты гостя (`/card/{id}`) — это личный кабинет гостя без какого-либо входа. На ней отображаются:

• название и логотип ресторана (шапка карты — «DEMO COFFEE HOUSE»);
• имя гостя и бейдж уровня (например «Milica Vuković — ПЛАТИНА»);
• общий баланс крупным шрифтом (€24.40) и однострочная сводка активных программ («Кэшбэк 5% · Кэшбэк выходного дня (+1€) · Штамп-карта: ...»);
• номер карты (Карта № LC-943478051);
• кнопка «Добавить приложение на рабочий стол» (см. следующий раздел про установку);
• баннер готовой награды, если применимо: «🎉 У вас готова награда: [название] — скажите официанту!»;
• прогресс штамп-карты, если гость в такой программе участвует (например «Штамп-карта: 10-й кофе в подарок: 12 ×/10»);
• персональный QR-код карты — тот же самый, который сканирует официант;
• переключатель «Получать уведомления о бонусах» — гость включает push-подписку сам, ничего заранее не включено;
• ниже, если уведомления включены, — лента уже полученных сообщений («Уведомления»);
• полная «История операций» — каждое начисление и списание, с понятным описанием («Штамп 2/10 — «Штамп-карта: 10-й кофе в подарок»», «+€1 бонус — «Кэшбэк выходного дня (+1€)»» и т.д.) и суммой. При достаточно долгой истории операции группируются по месяцам — самый свежий месяц раскрыт сразу, более старые месяцы свёрнуты в заголовок вида «Май 2026 (12 операций)» и разворачиваются кликом, чтобы длинная история не превращала страницу в бесконечную ленту.

Новый гость, у которого ещё нет карты, попадает на форму саморегистрации по ссылке `/join/{slug}` — поля «Имя *», «Фамилия», «Телефон *», «Email *», необязательные «Дата рождения» и «Пол», согласие с политикой конфиденциальности и условиями использования, кнопка «Получите карту лояльности за 30 секунд» → «Получить карту».

17 Установка приложения на телефон гостя

PWA вместо нативного приложения — три сценария по платформе

У платформы нет отдельного нативного приложения — страница карты гостя устанавливается прямо из браузера как PWA (прогрессивное веб-приложение) по кнопке «📲 Добавить приложение на рабочий стол». Поведение кнопки зависит от того, какой браузер её открывает.

На iPhone открывается диалог «Установка приложения» с тремя шагами:

1. Нажмите значок «Поделиться» ⬆️ внизу экрана Safari

   Значок «Поделиться» находится на нижней панели инструментов Safari.

2. Выберите «На экран «Домой»»

   Пункт находится в списке действий, обычно нужно немного прокрутить вниз.

3. Нажмите «Добавить» — иконка появится на рабочем столе

   После этого значок с логотипом ресторана появляется на домашнем экране, как у обычного приложения.

После установки иконка на домашнем экране гостя использует собственный логотип и цвета ресторана (заданные в разделе «Дизайн карты»), и с этого момента у гостя начинают технически работать push-уведомления.

18 Важно: гости на разных языках

Названия программ и уровней не переводятся автоматически

Если у вашего ресторана гости говорят на разных языках, при выборе названий программ, уровней и текстов на карте практический совет — использовать универсальные обозначения, понятные без перевода: цифры, знак «%», эмодзи, или короткие слова, узнаваемые на всех нужных языках (например «5%» вместо длинной фразы, ☕ вместо слова «кофе»). Это не ошибка платформы, а особенность её текущей работы, которую стоит учитывать при заполнении названий.