Редактирование: о-системе-remarked

Путь: 00_Введение/о-системе-remarked.md

Содержимое (Markdown)

# О системе ReMarked

ReMarked — это система лояльности для предприятий общественного питания, работающая в связке с кассовыми системами **iiko** и **r-keeper**. Система позволяет идентифицировать гостя прямо на кассе, начислять и списывать бонусы, применять скидки, продавать сертификаты и реализовывать сложные маркетинговые механики без участия ИТ-отдела ресторана.

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

## Что такое программа лояльности (ПЛ) ReMarked

**Программа лояльности (ПЛ)** — это инструмент работы с гостями на кассе. После установки плагина касса начинает «узнавать» гостя по карте или номеру телефона и применять к заказу заранее настроенные правила: кешбэк, скидки, списание бонусов, подарки и т. д.

Ключевая идея: вся логика начислений и списаний хранится и рассчитывается на стороне ReMarked, а касса лишь отправляет данные о заказе и получает готовый результат (сумму скидки, доступные к списанию бонусы и т. п.).

## Общая архитектура

Система состоит из четырёх основных компонентов, которые взаимодействуют между собой.

| Компонент | Назначение |
|---|---|
| **Касса (iiko / r-keeper)** | Рабочее место официанта или администратора. Здесь гость привязывается к заказу, начисляются и списываются бонусы. |
| **Плагин / интеграционный модуль** | ПО, устанавливаемое на кассу. Для iiko это плагин Remarked, для r-keeper — связка модулей FarCards, menu_dump и мониторинга. Плагин связывает кассу с CRM ReMarked. |
| **CRM (личный кабинет, кабинет клиента)** | Хранит карточки гостей, кошельки, категории, настройки программы лояльности, статистику. Здесь инженер настраивает ПЛ, а поддержка анализирует кейсы. |
| **API ReMarked** | Канал обмена данными между кассой и CRM. Через него идёт **процессинг** — обработка заказа: авторизация гостя, расчёт скидок и бонусов, фиксация транзакции. |

### Как это работает в общих чертах

1. Гость предъявляет карту (физическую, в Wallet, в приложении или в Telegram-боте) либо называет номер телефона.
2. Официант привязывает гостя к заказу на кассе через интерфейс плагина (например, «ReMarked Loyalty» → «Привязать гостя»).
3. Плагин обращается к API ReMarked, CRM рассчитывает скидку/кешбэк/доступные к списанию бонусы и возвращает результат на кассу.
4. При закрытии заказа (через пречек или вызов типа оплаты) транзакция фиксируется в CRM. Когда транзакция переходит в статус `success` — ПЛ отрабатывает по гостю: начисляются и списываются бонусы, меняются категории.

> **Важно:** если транзакции по заказу нет в системе — значит, гостя не «чекинили» через плагин ReMarked. Без транзакции бонусы не начисляются и не списываются.

## Носители лояльности

Гость может пользоваться программой лояльности через любой из носителей:

- **электронная карта** в приложении Wallet / Wallet Union (добавляется по QR-коду из анкеты);
- **мобильное приложение** клиента;
- **Telegram-бот** (баланс, бронирования, чекин по QR, персональные предложения);
- **номер телефона** (когда авторизация по телефону включена в настройках).

Физическая пластиковая карта при переходе на ReMarked, как правило, перестаёт действовать — накопления переносятся на электронный носитель.

## Для кого эта документация

- **Поддержка и внедрение** — настройка ПЛ, установка и обновление плагина, разбор ошибок, постановка задач.
- **Менеджеры отдела ПЛ** — ведение клиентов, брифирование, согласование условий, коммуникация с заказчиком.

Подробнее о возможностях системы см. «Доступный функционал лояльности».

Отмена