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

Представьте: интернет-магазин с 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, чтобы обеспечить отказоустойчивость и простоту поддержки. Получите консультацию инженера — бесплатно.