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

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

Промокоди — інструмент управління конверсією та лояльністю. За простим полем введення приховується нетривіальна логіка: обмеження по категоріях, мінімальні суми, ліміти використання, сумісність з іншими скидками. Неправильна реалізація ведить до конфліктів правил, некоректних итогів та дир у марж. Розроблення гнучкої системи промокодів займає 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),
    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)
• Успішний промокод: зелена мітка, перерахунок итогу, кнопка видалення
• Помилка: червоний текст з причиною
• Тільки один промокод одночасно (якщо іншен не передбачено бізнес-логікою)

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

Відслідковуємо: кількість застосувань по днях, загальну суму скидок, конверсію з промокодом vs без, середній чек з промокодом. Це дозволяє оцінювати ROI конкретних кампаній.