Розробка сповіщення про надходження товару (Back in Stock) для інтернет-магазину

Розробка сповіщення про поступлення товару (Back in Stock) для E-Commerce

Коли товар закінчується — покупатель йде. Форма "Повідомити про поступлення" утримує цей попит: замість втрати клієнта магазин отримує контакт зацікавленого покупця та можливість повернути його у момент появи товару. Розробка функціоналу займає 1–2 робочих дня.

Схема даних

CREATE TABLE back_in_stock_requests (
    id BIGSERIAL PRIMARY KEY,
    product_id BIGINT NOT NULL REFERENCES products(id) ON DELETE CASCADE,
    variant_id BIGINT REFERENCES product_variants(id) ON DELETE CASCADE,
    user_id BIGINT REFERENCES users(id) ON DELETE SET NULL,
    email VARCHAR(255) NOT NULL,
    notified_at TIMESTAMP,
    created_at TIMESTAMP DEFAULT NOW()
);

CREATE UNIQUE INDEX idx_bis_email_product
    ON back_in_stock_requests(email, product_id, COALESCE(variant_id, 0))
    WHERE notified_at IS NULL;

Унікальний індекс запобігає дублюванню підписок від одного email на один товар/варіант.

Форма підписки

Форма показується замість кнопки "В кошик" при stock = 0:

const BackInStockForm = ({ product, variant }: BackInStockProps) => {
  const { user } = useAuth();
  const [submitted, setSubmitted] = useState(false);
  const { register, handleSubmit, formState: { errors, isSubmitting } } = useForm({
    defaultValues: { email: user?.email ?? '' },
  });

  const onSubmit = async (data: { email: string }) => {
    await api.post('/back-in-stock', {
      product_id: product.id,
      variant_id: variant?.id ?? null,
      email: data.email,
    });
    setSubmitted(true);
  };

  if (submitted) {
    return (
      <div className="flex items-center gap-2 text-green-600 text-sm">
        <CheckIcon className="w-4 h-4" />
        <span>Ми повідомимо, коли товар з'явиться в наявності</span>
      </div>
    );
  }

  return (
    <form onSubmit={handleSubmit(onSubmit)} className="space-y-2">
      <p className="text-sm text-gray-600">Товара нема в наявності. Залиште email — повідомимо при поступленні.</p>
      <div className="flex gap-2">
        <input
          type="email"
          placeholder="[email protected]"
          className="flex-1 border rounded px-3 py-2 text-sm"
          {...register('email', { required: true, pattern: /^[^\s@]+@[^\s@]+\.[^\s@]+$/ })}
        />
        <Button type="submit" size="sm" loading={isSubmitting}>
          Повідомити
        </Button>
      </div>
      {errors.email && <p className="text-red-500 text-xs">Введіть коректний email</p>}
    </form>
  );
};

API-endpoint підписки

public function subscribe(Request $request): JsonResponse
{
    $request->validate([
        'product_id' => 'required|exists:products,id',
        'variant_id' => 'nullable|exists:product_variants,id',
        'email'      => 'required|email|max:255',
    ]);

    // Перевіряємо, що товар дійсно не в наявності
    $product = Product::find($request->product_id);
    if ($product->stock > 0) {
        return response()->json(['message' => 'Товар уже в наявності'], 422);
    }

    BackInStockRequest::firstOrCreate([
        'product_id' => $request->product_id,
        'variant_id' => $request->variant_id,
        'email'      => strtolower($request->email),
        'notified_at' => null,
    ], [
        'user_id' => $request->user()?->id,
    ]);

    return response()->json(['message' => 'Підписка оформлена']);
}

Автоматична відправка при пополненні складу

Триггер спрацьовує при оновленні остатків товару. Це може відбуватися через:

• Імпорт з 1С/ERP
• Ручне оновлення у панелі адміністратора
• API від поставщика

// Observer на моделі Product або ProductVariant
class ProductObserver
{
    public function updated(Product $product): void
    {
        if ($product->isDirty('stock') && $product->stock > 0 && $product->getOriginal('stock') === 0) {
            NotifyBackInStockSubscribers::dispatch($product)->onQueue('notifications');
        }
    }
}

Job відправки сповіщень:

class NotifyBackInStockSubscribers implements ShouldQueue
{
    public function handle(): void
    {
        $requests = BackInStockRequest::where('product_id', $this->product->id)
            ->whereNull('variant_id')
            ->whereNull('notified_at')
            ->get();

        foreach ($requests as $request) {
            Mail::to($request->email)->queue(new BackInStockNotification($this->product, $request));
            $request->update(['notified_at' => now()]);
        }
    }
}

Email-сповіщення

Лист містить:

• Фото та назву товару
• Поточну ціну (з урахуванням скидок, якщо застосовуються)
• Пряму ссилку на товар з UTM-меткою utm_source=back_in_stock
• Попередження "Кількість обмежена — встигніть купити"

Лист надсилається один раз при поступленні товару. Повторних сповіщень не буває — notified_at фіксує факт відправки.

Відписка

Посилання "Відписатися" в листі веде на /back-in-stock/unsubscribe?token={token}. Токен — HMAC підпис email + product_id:

$token = hash_hmac('sha256', "{$request->email}:{$request->product_id}", config('app.key'));

Аналітика

Метрики блоку:

• Кількість активних підписок по товарам
• Конверсія підписчиків у покупки (через UTM + orders)
• Час від підписки до поступлення товару
• Частка підписчиків, що встигли купити товар після сповіщення

Товари з великою кількістю підписок — сигнал до дозаказу у поставщика.