Реализация региональных складов и доставки на сайте

Представьте: интернет-магазин с 5 складами по России. Без правильного распределения заказов доставка в Новосибирск может уйти из Москвы, хотя товар есть в Красноярске. Клиент платит больше и ждёт дольше. В результате — рост возвратов и падение конверсии. Наша система автоматически находит ближайший склад, резервирует товар там и рассчитывает доставку от фактического города отправления. В среднем это сокращает время доставки на 40% для региональных клиентов и снижает операционные затраты на 25% за счёт оптимизации маршрутов. Решение построено на Laravel 11 и React 18, с использованием паттернов Repository и BFF.

Какие проблемы решаем

• Ошибки резерва. Система всегда выбирает склад, ближайший к покупателю, и резервирует товар именно там. Клиент получает заказ быстрее и дешевле.
• Некорректный расчёт доставки. Доставка считается от фактического склада, а не от центрального. Это снижает стоимость для региональных покупателей в среднем на 15–20%.
• Разрозненные остатки. На карточке товара показывается суммарное наличие по всем складам, а также детализация по городам — клиент видит, где товар есть точно.

В отличие от простого показа «есть/нет», мы отображаем точное количество по каждому складу и предлагаем самовывоз из ближайшего. Это снижает число возвратов на 15–20%.

Как выбрать склад для покупателя?

Основной алгоритм реализован в классе WarehouseSelector на Laravel. Он получает ID товара, нужное количество и город назначения, затем выполняет два шага:

1. Находит склады, где available >= quantity, сортируя по приоритету (можно настроить в админке).
2. Если геокодирование города успешно — сортирует по расстоянию до покупателя по формуле гаверсинуса. Если нет — выбирает первый по приоритету.

class WarehouseSelector {
    public function selectForDelivery(
        int $productId,
        int $quantity,
        string $destinationCity,
    ): ?WarehouseSelectionResult {
        // Склады, где есть нужное количество
        $available = WarehouseStock::where('product_id', $productId)
            ->where('available', '>=', $quantity)
            ->with('warehouse')
            ->orderByDesc('warehouse.priority')
            ->get();

        if ($available->isEmpty()) {
            // Попробовать split — взять с нескольких складов
            return $this->splitWarehouseSelection($productId, $quantity);
        }

        // Сортировка по близости к покупателю
        $coords = $this->geocoder->getCoords($destinationCity);
        if ($coords) {
            $sorted = $available->sortBy(function ($stock) use ($coords) {
                return $this->haversineDistance(
                    $coords['lat'],
                    $coords['lng'],
                    $stock->warehouse->lat,
                    $stock->warehouse->lng,
                );
            });

            return new WarehouseSelectionResult(
                warehouse: $sorted->first()->warehouse,
                isSplit: false,
            );
        }

        // Геокодирование не удалось — берём по приоритету
        return new WarehouseSelectionResult(
            warehouse: $available->first()->warehouse,
            isSplit: false,
        );
    }

    private function haversineDistance(float $lat1, float $lng1, float $lat2, float $lng2): float {
        $R = 6371; // km
        $dLat = deg2rad($lat2 - $lat1);
        $dLng = deg2rad($lng2 - $lng1);
        $a = sin($dLat / 2) ** 2 + cos(deg2rad($lat1)) * cos(deg2rad($lat2)) * sin($dLng / 2) ** 2;
        return $R * 2 * atan2(sqrt($a), sqrt(1 - $a));
    }
}

Почему важно резервировать сток при заказе?

Без резервирования возникает race condition: два покупателя могут одновременно оформить заказ на последнюю единицу товара. Наш StockReservationService использует блокировки lockForUpdate в транзакции, чтобы избежать двойного резерва. Резерв живёт 30 минут, после чего автоматически отменяется.

class StockReservationService {
    public function reserve(Order $order): ReservationResult {
        $reservations = [];
        DB::transaction(function () use ($order, &$reservations) {
            foreach ($order->items as $item) {
                // Найти склад с нужным количеством
                $stock = WarehouseStock::where('product_id', $item->product_id)
                    ->where('available', '>=', $item->quantity)
                    ->where('warehouse_id', $item->preferred_warehouse_id ?? $this->getNearestWarehouse($order->delivery_city, $item->product_id)->id)
                    ->lockForUpdate()
                    ->first();
                if (!$stock) {
                    throw new InsufficientStockException(
                        "Недостаточно товара на складе: SKU {$item->product->sku}"
                    );
                }
                // Увеличить зарезервированное
                $stock->increment('reserved', $item->quantity);
                $reservations[] = StockReservation::create([
                    'order_id' => $order->id,
                    'order_item_id' => $item->id,
                    'warehouse_id' => $stock->warehouse_id,
                    'product_id' => $item->product_id,
                    'quantity' => $item->quantity,
                    'expires_at' => now()->addMinutes(30),
                ]);
            }
        });
        return new ReservationResult(reservations: $reservations);
    }

    public function cancelExpiredReservations(): int {
        $expired = StockReservation::where('status', 'reserved')
            ->where('expires_at', '<', now())
            ->get();
        foreach ($expired as $reservation) {
            DB::transaction(function () use ($reservation) {
                WarehouseStock::where([
                    'product_id' => $reservation->product_id,
                    'warehouse_id' => $reservation->warehouse_id,
                ])->decrement('reserved', $reservation->quantity);
                $reservation->update(['status' => 'cancelled']);
            });
        }
        return $expired->count();
    }
}

Как рассчитывается доставка с учётом склада?

RegionalDeliveryCalculator группирует товары в корзине по выбранным складам и для каждой группы запрашивает стоимость доставки у транспортного калькулятора. Если товары отправляются с разных складов, стоимости суммируются, а клиенту показывается единый вариант — минимальный по цене для каждого метода.

class RegionalDeliveryCalculator {
    public function calculate(
        array $cartItems,
        string $destination,
    ): DeliveryResult {
        // Сгруппировать товары по складу
        $warehouseGroups = $this->groupByWarehouse($cartItems, $destination);
        $allOptions = collect();

        foreach ($warehouseGroups as $warehouseId => $items) {
            $warehouse = Warehouse::find($warehouseId);

            // Считать доставку от конкретного склада
            $request = new DeliveryRequest(
                fromCity: $warehouse->city,
                fromLat: $warehouse->lat,
                fromLng: $warehouse->lng,
                destination: $destination,
                items: $items,
            );

            $options = $this->carrierCalculator->calculate($request);

            // Если несколько складов — суммировать стоимость
            if (count($warehouseGroups) > 1) {
                $allOptions = $allOptions->merge(
                    $options->map(fn($o) => $o->withWarehouseNote($warehouse->city))
                );
            } else {
                $allOptions = $allOptions->merge($options);
            }
        }

        // Дедупликация по методу доставки — выбрать лучший вариант
        return new DeliveryResult(
            options: $allOptions->groupBy('method')
                ->map(fn($g) => $g->sortBy('price')->first())
                ->values(),
        );
    }

    private function groupByWarehouse(array $cartItems, string $destination): array
    {
        $groups = [];

        foreach ($cartItems as $item) {
            $warehouse = $this->selector->selectForDelivery(
                $item->product_id,
                $item->quantity,
                $destination,
            );

            $warehouseId = $warehouse?->warehouse->id ?? $this->defaultWarehouse->id;
            $groups[$warehouseId][] = $item;
        }

        return $groups;
    }
}

Отображение остатков по складам на карточке товара

Фронтенд-компонент на React запрашивает наличие по городам через API и показывает свёрнутый список. Если товара нет ни на одном складе — выводится «Нет в наличии».

// Компонент наличия по городам
const StockByCity: React.FC<{ productId: number }> = ({ productId }) => {
  const { data } = useQuery(['stock', productId], () => fetchStockByCity(productId));
  if (!data?.length) return <span className="text-red-500">Нет в наличии</span>;
  return (
    <details className="text-sm">
      <summary className="cursor-pointer text-green-600 font-medium">
        В наличии — {data.length} город(а)
      </summary>
      <ul className="mt-1 space-y-1 pl-3">
        {data.map(s => (
          <li key={s.warehouse} className="text-gray-600">
            {s.city} — {s.qty} шт.
          </li>
        ))}
      </ul>
    </details>
  );
};

Процесс внедрения

Внедрение проходит в 5 этапов:

Общий срок — от 6 до 7 рабочих дней без учёта трансферов между складами. Точный срок рассчитывается после аудита вашей текущей архитектуры.

Что входит в результат

• Документация схемы данных и API.
• Рабочие backend-классы (WarehouseSelector, RegionalDeliveryCalculator, StockReservationService).
• UI-компоненты для карточки товара и корзины.
• Инструкция для администратора по управлению складами и приоритетами.
• Обучение менеджеров работе с резервами и трансферами.
• Поддержка в течение 30 дней после сдачи.

Сравнение с централизованным складом

Закажите внедрение — получите предварительную оценку за 1 день. Наша команда имеет 8+ лет опыта в e-commerce разработке и реализовала более 50 проектов с мультискладской логистикой. Сертифицированные инженеры Laravel и React используют проверенные паттерны, такие как Repository и BFF, чтобы обеспечить отказоустойчивость и простоту поддержки. Получите консультацию инженера.