Разработка системы промокодов и купонов для интернет-магазина

Разработка системы промокодов и купонов для интернет-магазина

Промокоды — инструмент управления конверсией и лояльностью. За простым полем ввода скрывается нетривиальная логика: ограничения по категориям, минимальным суммам, количеству использований, совместимости с другими скидками. Разработка гибкой системы промокодов занимает 4–7 рабочих дней.

Модель данных

CREATE TABLE coupons (
    id BIGSERIAL PRIMARY KEY,
    code VARCHAR(50) UNIQUE NOT NULL,
    type VARCHAR(20) NOT NULL, -- 'percent', 'fixed', 'free_shipping', 'buy_x_get_y'
    value NUMERIC(10,2),       -- процент или сумма скидки
    min_order_amount NUMERIC(12,2) DEFAULT 0,
    max_discount_amount NUMERIC(12,2),  -- cap для процентных скидок
    usage_limit INT,            -- NULL = безлимитный
    usage_per_user INT DEFAULT 1,
    used_count INT DEFAULT 0,
    starts_at TIMESTAMP,
    expires_at TIMESTAMP,
    is_active BOOLEAN DEFAULT TRUE,
    applies_to VARCHAR(20) DEFAULT 'all', -- 'all', 'categories', 'products', 'users'
    metadata JSONB DEFAULT '{}'
);

CREATE TABLE coupon_usages (
    id BIGSERIAL PRIMARY KEY,
    coupon_id BIGINT REFERENCES coupons(id),
    user_id BIGINT REFERENCES users(id),
    guest_email VARCHAR(255),
    order_id BIGINT REFERENCES orders(id),
    discount_amount NUMERIC(12,2),
    used_at TIMESTAMP DEFAULT NOW()
);

metadata в JSONB хранит ограничения: применимые категории, конкретные SKU, сегменты пользователей.

Типы промокодов

Валидация промокода

Валидация — многоуровневая проверка перед применением:

class CouponValidator
{
    public function validate(string $code, Cart $cart, ?User $user): CouponResult
    {
        $coupon = Coupon::where('code', strtoupper($code))->first();

        if (!$coupon || !$coupon->is_active) {
            return CouponResult::invalid('Промокод не найден');
        }

        if ($coupon->expires_at && $coupon->expires_at->isPast()) {
            return CouponResult::invalid('Срок действия промокода истёк');
        }

        if ($coupon->starts_at && $coupon->starts_at->isFuture()) {
            return CouponResult::invalid('Промокод ещё не активен');
        }

        if ($coupon->usage_limit && $coupon->used_count >= $coupon->usage_limit) {
            return CouponResult::invalid('Промокод исчерпан');
        }

        if ($cart->subtotal < $coupon->min_order_amount) {
            return CouponResult::invalid(
                "Минимальная сумма заказа: {$coupon->min_order_amount} ₽"
            );
        }

        if ($user && $coupon->usage_per_user) {
            $userUsages = CouponUsage::where('coupon_id', $coupon->id)
                ->where('user_id', $user->id)
                ->count();
            if ($userUsages >= $coupon->usage_per_user) {
                return CouponResult::invalid('Вы уже использовали этот промокод');
            }
        }

        return CouponResult::valid($coupon, $this->calculateDiscount($coupon, $cart));
    }
}

Расчёт скидки по категориям

Если промокод применяется только к товарам определённых категорий:

private function calculateDiscount(Coupon $coupon, Cart $cart): float
{
    $applicableItems = $cart->items;

    if ($coupon->applies_to === 'categories') {
        $categoryIds = $coupon->metadata['category_ids'] ?? [];
        $applicableItems = $cart->items->filter(
            fn($item) => in_array($item->product->category_id, $categoryIds)
        );
    }

    $applicableTotal = $applicableItems->sum(fn($i) => $i->price * $i->quantity);

    $discount = match($coupon->type) {
        'percent' => $applicableTotal * ($coupon->value / 100),
        'fixed'   => min($coupon->value, $applicableTotal),
        default   => 0,
    };

    if ($coupon->max_discount_amount) {
        $discount = min($discount, $coupon->max_discount_amount);
    }

    return round($discount, 2);
}

Атомарное применение и счётчик использований

При оформлении заказа применение промокода должно быть атомарным, с проверкой used_count через lockForUpdate:

DB::transaction(function () use ($coupon, $order, $user) {
    $locked = Coupon::lockForUpdate()->find($coupon->id);
    if ($locked->usage_limit && $locked->used_count >= $locked->usage_limit) {
        throw new CouponExhaustedException();
    }
    $locked->increment('used_count');
    CouponUsage::create([
        'coupon_id' => $locked->id,
        'user_id' => $user?->id,
        'order_id' => $order->id,
        'discount_amount' => $order->discount_amount,
    ]);
});

Генерация массовых купонов

Для маркетинговых кампаний нужна генерация уникальных кодов в количестве тысяч штук:

Artisan::call('coupons:generate', [
    '--count'   => 1000,
    '--prefix'  => 'PROMO24',
    '--type'    => 'percent',
    '--value'   => 15,
    '--expires' => '2024-12-31',
    '--limit'   => 1, // каждый купон — одно использование
]);

Коды формируются как PROMO24-{XXXXXXXX} — 8 случайных символов из [A-Z0-9] без неоднозначных символов (O, 0, I, 1).

UX в корзине

Поле ввода промокода — второстепенный элемент, не конкурирует с кнопкой «Оформить». Рекомендуемое поведение:

• Поле свёрнуто по умолчанию, раскрывается кликом на «Есть промокод?»
• После ввода — мгновенная проверка (debounce 500ms)
• Успешный промокод: зелёная метка, пересчёт итога, кнопка удалить
• Ошибка: красный текст с причиной
• Только один промокод одновременно (если иное не предусмотрено бизнес-логикой)

Аналитика эффективности

В CRM/admin отслеживаем: количество применений по дням, общую сумму скидок, конверсию с промокодом vs без, средний чек с промокодом. Это позволяет оценивать ROI конкретных кампаний.