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

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

Когда товар заканчивается — покупатель уходит. Форма «Уведомить о поступлении» удерживает этот спрос: вместо потери клиента магазин получает контакт заинтересованного покупателя и возможность вернуть его в момент появления товара. Разработка функционала занимает 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-эндпоинт подписки

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
• Ручное обновление в admin-панели
• 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)
• Время от подписки до поступления товара
• Доля подписчиков, успевших купить товар после уведомления

Товары с большим количеством подписок — сигнал к дозаказу у поставщика.