Представьте: интернет-магазин с 5 складами по России. Без правильного распределения заказов доставка в Новосибирск может уйти из Москвы, хотя товар есть в Красноярске. Клиент платит больше и ждёт дольше. В результате — рост возвратов и падение конверсии. Наша система автоматически находит ближайший склад, резервирует товар там и рассчитывает доставку от фактического города отправления. В среднем это сокращает время доставки на 40% для региональных клиентов и снижает операционные затраты на 25% за счёт оптимизации маршрутов. Решение построено на Laravel 11 и React 18, с использованием паттернов Repository и BFF.
Какие проблемы решаем
- Ошибки резерва. Система всегда выбирает склад, ближайший к покупателю, и резервирует товар именно там. Клиент получает заказ быстрее и дешевле.
- Некорректный расчёт доставки. Доставка считается от фактического склада, а не от центрального. Это снижает стоимость для региональных покупателей в среднем на 15–20%.
- Разрозненные остатки. На карточке товара показывается суммарное наличие по всем складам, а также детализация по городам — клиент видит, где товар есть точно.
В отличие от простого показа «есть/нет», мы отображаем точное количество по каждому складу и предлагаем самовывоз из ближайшего. Это снижает число возвратов на 15–20%.
Как выбрать склад для покупателя?
Основной алгоритм реализован в классе WarehouseSelector на Laravel. Он получает ID товара, нужное количество и город назначения, затем выполняет два шага:
- Находит склады, где
available >= quantity, сортируя по приоритету (можно настроить в админке). - Если геокодирование города успешно — сортирует по расстоянию до покупателя по формуле гаверсинуса. Если нет — выбирает первый по приоритету.
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 этапов:
| Этап | Длительность |
|---|---|
| Аналитика текущей архитектуры и сбор данных | 1-2 дня |
| Проектирование схемы данных и API | 1 день |
| Реализация backend-классов (WarehouseSelector, RegionalDeliveryCalculator, StockReservationService) | 2-3 дня |
| Интеграция UI-компонентов (карточка товара, корзина) | 1-2 дня |
| Тестирование, деплой и обучение менеджеров | 1-2 дня |
Общий срок — от 6 до 7 рабочих дней без учёта трансферов между складами. Точный срок рассчитывается после аудита вашей текущей архитектуры.
Что входит в результат
- Документация схемы данных и API.
- Рабочие backend-классы (WarehouseSelector, RegionalDeliveryCalculator, StockReservationService).
- UI-компоненты для карточки товара и корзины.
- Инструкция для администратора по управлению складами и приоритетами.
- Обучение менеджеров работе с резервами и трансферами.
- Поддержка в течение 30 дней после сдачи.
Сравнение с централизованным складом
| Характеристика | Один склад | Региональные склады (наше решение) |
|---|---|---|
| Скорость доставки | Высокая только в городе склада | Минимальная для каждого региона |
| Стоимость доставки | Фиксированная от центра | Адаптивная, часто ниже на 15-20% |
| Остатки на сайте | Только общие | По складам с детализацией |
| Риск ошибок резерва | Низкий | Практически исключён |
Закажите внедрение — получите предварительную оценку за 1 день. Наша команда имеет 8+ лет опыта в e-commerce разработке и реализовала более 50 проектов с мультискладской логистикой. Сертифицированные инженеры Laravel и React используют проверенные паттерны, такие как Repository и BFF, чтобы обеспечить отказоустойчивость и простоту поддержки. Получите консультацию инженера — бесплатно.