Спросите про бонусную карту
«У вас есть бонусная карта ИРИС?». Если клиент зарегистрирован — попросите показать QR-код в приложении или Telegram-боте.
Отсканируйте QR-код
Откройте приложение менеджера → «Сканировать» → наведите камеру на QR клиента. Система покажет: ФИО, уровень, баланс.
Введите сумму и категорию
Введите сумму покупки и выберите категорию: ЕДА / ХОЗТОВАРЫ / БЫТХИМ. Нажмите «Начислить».
Если клиент хочет списать бонусы
Поставьте галочку «Списание» → введите сумму. Клиент подтвердит через уведомление в приложении/Telegram. Без подтверждения — списание не пройдёт.
— Использовать свой QR для начисления себе
— Фотографировать QR-коды покупателей
Система антифрода отслеживает все операции.
- Помогите клиенту открыть iris-shop.ru/login на его телефоне
- Клиент вводит свой email и нажимает «Войти»
- На почту приходит ссылка — клиент нажимает на неё
- Готово! Клиент может показывать QR-код
| Категория | Множитель | Примеры товаров |
|---|---|---|
| 🍞 ЕДА | ×1.0 | Хлеб, молоко, крупы, мясо, овощи, напитки |
| 🧹 ХОЗТОВАРЫ | ×1.5 | Посуда, ведро, швабра, лампочки, батарейки |
| 🧴 БЫТХИМ | ×1.2 | Стиральный порошок, средство для мытья, мыло |
QR-код не сканируется
Попросите клиента обновить QR (нажать повторно). QR действует 2 минуты. Если экран тёмный — увеличьте яркость.
«Нет интернета у клиента»
Предложите подключиться к Wi-Fi магазина, или перечислить бонусы при следующем визите. Без QR — начисление невозможно.
Клиент хочет вернуть товар
Бонусы за возвращённый товар отменяются автоматически при оформлении возврата через систему.
Список не подтверждается
Клиент должен подтвердить списание. Если он не получает уведомление — проверьте, подтверждён ли email (видно при сканировании QR).
Через Telegram-бот (для администраторов)
Напишите боту @iris_laysan_shop_bot:
/report— статистика за период (транзакции, суммы, новые клиенты)/broadcast Текст сообщения— рассылка всем пользователям
Через API (для продвинутых)
API документация: iris-shop.ru/api/docs
Основные эндпоинты:
GET /api/health— проверка работоспособностиGET /api/loyalty/levels— текущие уровниGET /api/loyalty/categories— категорииGET /api/offers/— активные акцииPOST /api/offers/— создать акцию
Как создать акцию
Через API или попросите администратора. Примеры акций:
- Двойной кэшбэк на хозтовары — множитель ×2 на категорию ХОЗТОВАРЫ
- Бонус новичка — 50 бонусов за первую покупку
- Горячий час — повышенный кэшбэк с 10:00 до 12:00
Система автоматически защищает от мошенничества:
| Правило | Описание |
|---|---|
| ⏰ Кулдаун 24ч | Не более 1 транзакции на клиента в 24 часа |
| 🔢 Круглые суммы | Суммы кратные 500 ₽ — повышенный контроль |
| 👤 Привязка к кассиру | Система отслеживает частоту операций кассира |
| ✅ 2FA списание | Списание только с подтверждением клиента |
| 🔐 QR TTL | QR действует 120 секунд — нельзя переиспользовать |
| Уровень | Кэшбэк | Макс. списание | Порог (∑ покупок) |
|---|---|---|---|
| 🪵 Дерево | 0,5% | 10% | 0 ₽ |
| 🥉 Бронза | 1% | 20% | 5 000 ₽ |
| 🥈 Серебро | 2% | 30% | 15 000 ₽ |
| 🥇 Золото | 3% | 50% | 50 000 ₽ |
Пример: 2000₽ × 2% (Серебро) × 1.5 (Хозтовары) = 60 бонусов
🏷️ Пороговые скидки (от суммы покупки)
| Сумма покупки | Скидка | Пример |
|---|---|---|
| от 3 000 ₽ | 3% | 3000 ₽ → −90 ₽ |
| от 5 000 ₽ | 5% | 5000 ₽ → −250 ₽ |
| от 10 000 ₽ | 7% | 10 000 ₽ → −700 ₽ |
Скидка применяется автоматически. Кэшбэк считается от суммы после скидки.
Инфраструктура
| Компонент | Расположение | Статус |
|---|---|---|
| API (FastAPI, 2 реплики) | K3s dodgeram | ✅ |
| Telegram-бот (aiogram 3) | K3s dodgeram | ✅ |
| PostgreSQL | K3s dodgeram | ✅ |
| Redis | K3s dodgeram | ✅ |
| Nginx (сайт) | K3s gateway | ✅ |
| Бэкапы БД | CronJob / 6ч | ✅ |
Полезные ссылки
- 🌐 Сайт: iris-shop.ru
- 📚 API Docs: iris-shop.ru/api/docs
- 🤖 Telegram: @iris_laysan_shop_bot
- 📱 APK: Скачать
- 📖 Инструкция для покупателей: iris-shop.ru/help