Интеграция Apple Wallet loyalty card

# Техническое задание

## Система лояльности Apple Wallet / Google Wallet для кофейни

### Цель

Сделать систему лояльности для кофейни с цифровой картой в Apple Wallet и Google Wallet по аналогии с «Кофе в окнах».

---

# 1. Общая логика системы

Клиент:

1. Сканирует QR-код.
2. Переходит на страницу регистрации.
3. Вводит телефон.
4. Получает карту лояльности.
5. Добавляет карту в Apple Wallet / Google Wallet.
6. На кассе показывает QR-код.
7. После покупки бонусы/скидка обновляются автоматически.

---

# 2. Что нужно реализовать

## 2.1 Wallet-карта

### Формат:

* Apple Wallet (.pkpass)
* Google Wallet

### На карте отображать:

* логотип кофейни,
* имя клиента,
* QR-код,
* баланс бонусов,
* процент скидки / статус,
* рекламный баннер/акцию,
* последнее сообщение,
* контакты кофейни.

---

# 3. QR-код

QR должен содержать:

* уникальный ID клиента,
  или
* токен клиента.

Требования:

* QR должен быстро сканироваться,
* работать с iPhone и Android,
* обновляться без перевыпуска карты.

---

# 4. Интеграция с кассой

## Используемая касса:

Предоставлю по итогу обсуждения заказа

### Требуется:

После оплаты:

1. Получить сумму заказа.
2. Начислить бонусы.
3. Обновить:

   * баланс,
   * статус,
   * сообщение на карте.
4. Отправить обновление в Wallet.

---

# 5. Логика лояльности

## пример:

### Скидочная система

| Сумма покупок | Статус | Скидка |
| ------------- | ------ | ------ |
| 0–5000 ₽      | START  | 3%     |
| 5000–15000 ₽  | SILVER | 5%     |
| 15000+ ₽      | GOLD   | 10%    |

ИЛИ

### Бонусная система

* 5% бонусами с каждой покупки.
* 1 бонус = 1 ₽.

(уточнить вариант окончательный перед разработкой)

---

# 6. Push-обновления Wallet

Нужно реализовать:

* автоматическое обновление карты,
* обновление баланса,
* обновление статуса,
* push-сообщения.

Примеры:

* «+50 бонусов начислено»
* «Сегодня капучино -20%»
* «Ваш статус GOLD»

---

# 7. Админ-панель

Минимальный функционал:

* список клиентов,
* телефон,
* баланс,
* статус,
* история начислений,
* ручное начисление/списание,
* отправка push-сообщений,
* изменение акции на карте.

---

# 8. Регистрация клиента

## Варианты:

### Минимально:

* телефон + SMS-код.

### Дополнительно:

* имя фамилия клиента,
* дата рождения.

---

# 9. Дизайн

Нужно:

* современный минималистичный стиль 
* адаптация под:

  * Apple Wallet,
  * Google Wallet.

Использовать:

* фирменные цвета,
* логотип,
* фото продукции.

---

# 10. Технологии

## Предпочтительно:

### Backend:

* Node.js / Python / PHP

### Wallet:

* PassKit API, можно другое

### База:

* PostgreSQL / Firebase

---

# 11. Что должно быть на выходе

Разработчик должен передать:

* рабочую систему,
* доступы,
* исходный код,
* инструкции,
* Apple Wallet certificates,
* документацию подключения.

---

# 12. Важные требования

* Без отдельного мобильного приложения.
* Всё должно работать через Wallet.
* Карта должна обновляться автоматически.
* Система должна выдерживать рост базы клиентов.
* Возможность масштабирования на несколько точек.

---

# 13. Ожидаемый результат

Клиент:

* быстро добавляет карту,
* показывает QR на кассе,
* получает бонусы,
* получает push-акции.

Владелец кофейни:

* видит базу клиентов,
* повышает возврат гостей,
* запускает акции через Wallet.

---

# 14. Сроки

Желаемый срок:

7–14 дней

# Дополнительно (если умеет разработчик)

Будет плюсом:

* реферальная система,
* welcome-бонус,
* гео-push при проходе рядом с кофейней,
* интеграция с CRM/email/SMS.