Loyalty Bot MVP

Telegram-бот лояльности для Kinti Flowers

Уже собран каркас бота для клиента и администратора: регистрация, стартовые бонусы, учет баланса через транзакции, ручное проведение покупки и webhook-архитектура под Vercel.

Клиентский поток
✨ Регистрация за 4 шага
💎 Мой баланс
👤 Профиль
🌷 Как работает клуб
Админ-поток
📊 Статистика
🔎 Найти клиента
🧾 Провести покупку
➕ Начислить вручную
➖ Списать вручную

Навигация

Меню без путаницы

Inline-first UX
Для покупателя

Главное меню ведет в баланс, профиль и правила программы. Регистрация разбита на четыре коротких шага с понятными CTA и кнопкой возврата домой.

Для администратора

В админ-панели есть поиск клиента, статистика, ручные корректировки и сценарий проведения покупки с учетом ограничения на списание и логики начисления 5%.

Правила лояльности

Что уже зафиксировано в логике

01

После первой регистрации клиент получает 300 приветственных бонусов.

02

При покупке можно списать до 20% суммы бонусами.

03

Если бонусы не списываются, на счет начисляется 5% от суммы покупки.

04

История операций хранится как отдельные транзакции, а не одной цифрой баланса.

Setup

Что нужно для запуска

Подключить Vercel Postgres и получить DATABASE_URL.
Заполнить APP_URL, TELEGRAM_WEBHOOK_SECRET и WEBHOOK_SETUP_SECRET.
Прогнать миграцию Prisma и задеплоить проект через Vercel CLI.
После деплоя вызвать защищенный setup endpoint для установки webhook.

Стек

Технологическая база MVP

Next.js 16 + TypeScript
grammY webhook bot
Prisma 7 + PostgreSQL
Vercel deployment via CLI
Отдельная навигация для клиента и администратора