Инструкция для сотрудников

🧑‍💻 Кассир

👔 Руководитель

📦 Привезли!

Уведомите клиентов, когда привезли свежий хлеб, молоко или другой товар. Сообщение придёт подписавшимся клиентам по push и в Telegram.

Ограничение: до 5 уведомлений в час на магазин. Заголовок обязателен на русском и татарском.

📋 Порядок работы с покупателем

Спросите про бонусную карту

«У вас есть бонусная карта ИРИС?». Если клиент зарегистрирован — попросите показать QR-код в приложении или Telegram-боте.

Отсканируйте QR-код

Откройте приложение менеджера → «Сканировать» → наведите камеру на QR клиента. Система покажет: ФИО, уровень, баланс.

Введите сумму покупки

Введите сумму покупки и нажмите «Начислить». Кэшбэк рассчитается автоматически по уровню клиента.

Если клиент хочет списать бонусы

Поставьте галочку «Списание» → введите сумму. Клиент подтвердит через уведомление в приложении/Telegram. Без подтверждения — списание не пройдёт.

🚫 Запрещено! — Начислять бонусы без реальной покупки
— Использовать свой QR для начисления себе
— Фотографировать QR-коды покупателей
Система антифрода отслеживает все операции.

👤 Регистрация нового покупателя

Помогите клиенту открыть iris-shop.ru/login на его телефоне
Клиент вводит свой адрес электронной почты и нажимает «Войти»
На электронную почту приходит ссылка — клиент нажимает на неё
Готово! Клиент может показывать QR-код

💡 Альтернатива Клиент может написать боту @iris_laysan_shop_bot — /start и следовать инструкциям.

🏷️ Категории товаров

Категория	Примеры товаров
🍞 Продукты	Хлеб, молоко, крупы, мясо, овощи, напитки
🧹 Хозтовары	Посуда, ведро, швабра, лампочки, батарейки
🧴 Бытовая химия	Стиральный порошок, средство для мытья, мыло

✅ Правило: если в чеке смешанные товары Выбирайте категорию с наибольшей долей в покупке. Если примерно поровну — ставьте «Продукты».

⚠️ Проблемные ситуации

QR-код не сканируется

Попросите клиента обновить QR (нажать повторно). QR действует 2 минуты. Если экран тёмный — увеличьте яркость.

«Нет интернета у клиента»

Предложите подключиться к Wi-Fi магазина, или перечислить бонусы при следующем визите. Без QR — начисление невозможно.

Клиент хочет вернуть товар

Бонусы за возвращённый товар отменяются автоматически при оформлении возврата через систему.

Список не подтверждается

Клиент должен подтвердить списание. Если он не получает уведомление — проверьте, подтверждена ли электронная почта (видно при сканировании 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 секунд — нельзя переиспользовать

⚠️ При подозрении на мошенничество Если кассир начисляет бонусы без покупок или подозрительно часто — система пришлёт алерт администратору. Такие транзакции можно отменить.

📈 Уровни и начисления

Уровень	Кэшбэк	Макс. списание	Порог (∑ покупок)
Лайсан (Бурбаш):
🥉 Бронза	1%	20%	0 — 14 999 ₽
🥈 Серебро	2%	30%	15 000 — 44 999 ₽
🥇 Золото	3%	50%	от 45 000 ₽
ИРИС (Салаусь):
🥉 Бронза	2%	20%	0 — 34 999 ₽
🥈 Серебро	3%	30%	35 000 — 59 999 ₽
🥇 Золото	4%	50%	от 60 000 ₽

📐 Формула начисления Бонусы = Сумма покупки × Ставка уровня
Пример: 2000₽ × 2% (Серебро) = 40 бонусов

🏷️ Пороговые скидки (от суммы покупки)

Сумма покупки	Скидка	Пример
от 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: iris-shop.ru/api/docs
🤖 Telegram: @iris_laysan_shop_bot
📱 APK: Скачать
📖 Инструкция для покупателей: iris-shop.ru/help
🖨️ PDF для продавца: Открыть → Ctrl+P → PDF
🖨️ PDF для руководителя: Открыть → Ctrl+P → PDF

📞 Техподдержка

Администратор системы: ИП Мукминов Р.Р.

Электронная почта: admin@iris-shop.ru

Сайт оператора: run-as-daemon.ru

👩‍💼 Инструкция для сотрудников

📦 Сообщить о привозе