Уявіть: інтернет-магазин з 5 складами по всій Україні. Без правильного розподілу замовлень доставка до Львова може піти з Києва, хоча товар є в Тернополі. Клієнт платить більше і чекає довше. У результаті — зростання повернень і падіння конверсії. Наша система автоматичного вибору регіональних складів та розрахунку доставки знаходить найближчий склад, резервує товар там і розраховує доставку від фактичного міста відправлення. В середньому це скорочує час доставки на 40% для регіональних клієнтів і знижує операційні витрати на 25% за рахунок оптимізації маршрутів. 80% клієнтів отримують замовлення на наступний день. Наприклад, для магазину з 10 000 замовлень на місяць економія складає до 50 000 грн на логістиці. Рішення побудоване на 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 групує товари в кошику за вибраними складами і для кожної групи запитує вартість доставки у транспортного калькулятора. Якщо товари відправляються з різних складів, вартості підсумовуються, а клієнту показується єдиний варіант — мінімальний за ціною для кожного методу. Система також обробляє трансфери між складами: при переміщенні товару залишки оновлюються в реальному часі через чергу фонових завдань Laravel Horizon.
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% |
| Залишки на сайті | Тільки загальні | По складах з деталізацією |
| Ризик помилок резерву | Низький | Практично виключений |
Наше рішення краще за централізований склад у 2-3 рази за швидкістю доставки для регіонів.
Замовте впровадження — отримайте попередню оцінку за 1 день. Наша команда має 8+ років досвіду в e-commerce розробці та реалізувала понад 50 проєктів з мультискладською логістикою. Сертифіковані інженери Laravel і React використовують перевірені патерни, такі як Repository і BFF, щоб забезпечити відмовостійкість і простоту підтримки. Отримайте консультацію інженера — безкоштовно.