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

Уявіть: інтернет-магазин з 5 складами по всій Україні. Без правильного розподілу замовлень доставка до Львова може піти з Києва, хоча товар є в Тернополі. Клієнт платить більше і чекає довше. У результаті — зростання повернень і падіння конверсії. Наша система автоматичного вибору регіональних складів та розрахунку доставки знаходить найближчий склад, резервує товар там і розраховує доставку від фактичного міста відправлення. В середньому це скорочує час доставки на 40% для регіональних клієнтів і знижує операційні витрати на 25% за рахунок оптимізації маршрутів. 80% клієнтів отримують замовлення на наступний день. Наприклад, для магазину з 10 000 замовлень на місяць економія складає до 50 000 грн на логістиці. Рішення побудоване на Laravel 11 та React 18, з використанням патернів Repository і BFF.

Як це працює:

1. Покупець вказує місто доставки.
2. Система визначає найближчий склад з товаром.
3. Резервується товар на цьому складі.
4. Розраховується доставка від фактичного міста відправлення.

Які проблеми вирішуємо

• Помилки резерву. Система завжди вибирає склад, найближчий до покупця, і резервує товар саме там. Клієнт отримує замовлення швидше та дешевше.
• Некоректний розрахунок доставки. Доставка рахується від фактичного складу, а не від центрального. Це знижує вартість для регіональних покупців в середньому на 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 групує товари в кошику за вибраними складами і для кожної групи запитує вартість доставки у транспортного калькулятора. Якщо товари відправляються з різних складів, вартості підсумовуються, а клієнту показується єдиний варіант — мінімальний за ціною для кожного методу. Система також обробляє трансфери між складами: при переміщенні товару залишки оновлюються в реальному часі через чергу фонових завдань 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 етапів:

Загальний термін — від 6 до 7 робочих днів без урахування трансферів між складами. Точний термін розраховується після аудиту вашої поточної архітектури.

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

• Документація схеми даних та API.
• Робочі backend-класи (WarehouseSelector, RegionalDeliveryCalculator, StockReservationService).
• UI-компоненти для картки товару та кошика.
• Інструкція для адміністратора з управління складами та пріоритетами.
• Навчання менеджерів роботі з резервами та трансферами.
• Підтримка та гарантія на код протягом 30 днів після здачі.

Порівняння з централізованим складом

Наше рішення краще за централізований склад у 2-3 рази за швидкістю доставки для регіонів.

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