stanislav_dubich@dev:~$ cat gamification-promo/README.md

Gamification Promo Portal

Портал вовлечения для маркетинговой промо-акции. Геймификация: квизы, мини-игры, система наград.

Бизнес-задача

Маркетинговая промо-кампания с геймификацией. Пользователи выполняют задания (квизы, мини-игры, промокоды) и получают сундуки с наградами — скидки и промокоды.

Архитектура

┌─────────────────┐         ┌─────────────────┐
│    Frontend     │──REST──▶│   Go Backend    │◀──reCAPTCHA──▶ Google
│   (Portal)      │         │     (Gin)       │
└─────────────────┘         └────────┬────────┘
                                     │
        ┌────────────────────────────┼────────────────────────────┐
        │                            │                            │
        ▼                            ▼                            ▼
┌───────────────┐           ┌───────────────┐            ┌───────────────┐
│  PostgreSQL   │           │     Redis     │            │   SMS Gateway │
│  (tasks,      │           │  (sessions)   │            │    (P1SMS)    │
│   rewards)    │           └───────────────┘            └───────────────┘
└───────────────┘

Аутентификация

Двухэтапная авторизация по телефону с защитой от злоупотреблений:

Шаг 1: SMS OTP (4 цифры), ограничение 3 минуты между попытками, срок действия 10 минут
Шаг 2: Верификация кода → Bearer token в Redis (30 дней)
Приватность: телефоны хранятся зашифрованными (AES-256), HMAC для матчинга
Защита от ботов: Google reCAPTCHA на регистрации

Система заданий

11 типов заданий с ротацией по времени:

Интерактивные: привязка аккаунта, мини-игра, квиз, поиск кода
На основе покупок: интеграция с заказами (сумма, количество товаров, использование промокода)
Ограниченные по времени: start/end для ротации заданий

Выдача наград

8 уровней сундуков (бронза → серебро → золото) с параллельной обработкой:

Пул воркеров: Semaphore для ограничения конкурентности (защита Coupon API от перегрузки)
Атомарность: предотвращение повторного получения через транзакции
Купоны: генерация и трекинг промокодов

База данных

Пул соединений: pgxpool с настроенным размером пула и таймаутами
Миграции: Goose v3 с встроенными SQL-файлами (20 миграций)
Таблицы: member, task, member_task, quiz, promocode, coupon, member_order

Стек

Backend

Go 1.22 Gin Framework pgx/v5 + pgxpool go-redis/v8 Goose (migrations)

Data

PostgreSQL Redis (sessions) AWS S3 (exports)

Integrations

SMS Gateway Google reCAPTCHA External API Orders API

Infra

Docker (multi-stage) GitHub Actions Yandex Cloud Registry

Моя роль

Архитектура backend для геймификации с нуля
Двухэтапная авторизация с ограничением частоты и AES-256 шифрованием
Пул воркеров с Semaphore для защиты внешних API от перегрузки
Интеграция с SMS-шлюзом, reCAPTCHA, Orders API

← На главную