Yokka Stars

LoyaltyCard — карта лояльности в Telegram Mini App (исходный код)

LoyaltyCard — карта лояльности в Telegram Mini App (исходный код)

Продавец: gevDev

Цена: 1919.64 RUB

Товар доступен. Итоговая стоимость зависит от выбранных параметров и проверяется перед оплатой.

Описание товара

Бумажные карты «10-й визит бесплатно» теряются, а клиент не помнит, сколько штампов у него осталось. LoyaltyCard делает карту лояльности частью Telegram: клиент открывает Mini App из бота и видит золотую карту с балансом штампов, прогрессом до следующей награды, списком наград и историей визитов. Сотруднику ничего устанавливать не нужно — он ставит штамп одной командой в боте по короткому коду клиента.

Подходит всем, где люди возвращаются: барбершопы, салоны красоты, кофейни, пекарни, автомойки, детские клубы.

КАК ЭТО РАБОТАЕТ

  • Клиент открывает приложение из бота (/start) и получает личную карту с кодом из 6 символов.
  • На кассе клиент называет код, сотрудник отправляет /stamp КОД (или /stamp КОД 2 для двух штампов) — баланс обновляется сразу.
  • Награды настраиваются в боте: /addreward Стрижка в подарок | 6 — название и стоимость в штампах (1–100).
  • Когда штампов достаточно, клиент нажимает «Получить» рядом с наградой в Mini App — запрос уходит администраторам в чат.
  • Сотрудник подтверждает /give КОД (штампы списываются, награда появляется в истории) или отклоняет /deny КОД (ничего не списывается). Pending-запрос может быть только один на клиента, поэтому награда не выдаётся дважды.

ЧТО ВНУТРИ

  • Mini App: золотая карта с балансом, точками прогресса и полосой, код с копированием, блок запроса на выдачу, трекер следующей награды, список наград, история визитов и контакты
  • Бот для клиентов: /start, /help, /card — своя карта с кодом, балансом и ближайшей наградой
  • Бот для админов: /stamp, /give, /deny, /requests, /rewards, /addreward, /delreward, /profile, /lang ru|en, /stats, /settings, /admin
  • Выдача с явным подтверждением: штампы списываются только после /give
  • Полная история: каждый штамп, каждая выданная награда, каждый отклонённый запрос
  • Коды без похожих символов (0/O, 1/I, 5/S, 8/B исключены) — легко продиктовать и набрать на кассе
  • Уведомления на языке каждого пользователя: клиенту подтверждения, админам запросы; язык админа переключается командой /lang
  • Локализация RU/EN, интерфейс подстраивается под тему Telegram, адаптив под узкие экраны
  • Проверка подписи initData (HMAC), лимиты запросов, ограничение тела запроса 32 КБ, security-заголовки
  • Хранение в JSON — никаких MySQL, Redis и Docker; один процесс Node.js обслуживает приложение, API и бота
  • Демо-режим для локальной проверки интерфейса без токена бота
  • 25 автотестов (node:test)
  • README с запуском, таблицей API и справочником команд

КОМУ ПОДХОДИТ

  • Барбершопам, студиям маникюра и красоты, кофейням, пекарням, автомойкам, детским клубам — любому бизнесу с повторными визитами
  • Тем, кто хочет запустить лояльность сегодня, без платежей сервису за каждого клиента
  • Разработчикам, которым нужен аккуратный Mini App + бот grammY с настоящим сценарием подтверждения награды

ЧТО НУЖНО ОТ ВАС

  • Telegram-бот (создаётся у @BotFather за 2 минуты)
  • Node.js 20+ и любой хостинг с HTTPS (Render Starter или VPS за $3–5; бесплатный Render засыпает — в это время клиенты видят ошибку)

ЧТО НЕ ВХОДИТ

  • Хостинг, домен и токен бота
  • Название заведения, награды и цены (задаются командами в боте или в data/db.json)
  • Онлайн-оплата, SMS и push-уведомления вне Telegram
  • Несколько заведений на одну установку
  • Юридическое оформление деятельности

ФОРМАТ: ZIP-архив с исходниками и документацией. Поддержка и обновления — 6 месяцев.

ВОЗВРАТ: цифровой товар, возврат после передачи файла не предусмотрен. Перед покупкой задайте вопросы — отвечу.

Дополнительная информация

Что нужно от вас:

  • Telegram-бот, создаётся у @BotFather за 2 минуты
  • Node.js 20+ и хостинг с HTTPS (Render Starter или VPS за $3–5; бесплатный Render засыпает — в это время клиенты видят ошибку)

Что не входит:

  • Хостинг, домен и токен бота
  • Название заведения, награды и цены — задаются командами в боте или в файле data/db.json
  • Онлайн-оплата, SMS и push-уведомления вне Telegram
  • Несколько заведений на одну установку
  • Юридическое оформление деятельности