Inventory & MSIالمخزون.

مخزن القاهرة:  10 قطع
مخزن جدة:       5 قطع
                ──────
Aggregated:     15 قطعة   # الموجود فعلياً

طلبات لسه ما اتشحنتش: 3
                ──────
Salable:        12 قطعة   # اللي ينفع تبيعه

# الـ 3 دول لسه في المخزن فيزيائياً
# بس محجوزين لعملاء اشتروهم

inventory_reservation
──────────────────────────────────────
id │ stock │ sku      │ quantity
 1 │   1   │ SKU-001  │  -2    # أوردر
 2 │   1   │ SKU-001  │  -1    # أوردر تاني
 3 │   1   │ SKU-001  │  +2    # اتشحن، الحجز اتلغى

# المحصلة: -1 → قطعة واحدة محجوزة

use Magento\InventorySalesApi\Api\
     GetProductSalableQtyInterface;
use Magento\InventorySalesApi\Api\
     StockResolverInterface;
use Magento\InventorySalesApi\Api\Data\
     SalesChannelInterface;

class StockChecker
{
    public function __construct(
        private readonly GetProductSalableQtyInterface $getSalableQty,
        private readonly StockResolverInterface $stockResolver
    ) {}

    public function getQty(
        string $sku,
        string $websiteCode
    ): float {
        // نحوّل الـ website لـ stock
        $stock = $this->stockResolver->execute(
            SalesChannelInterface::TYPE_WEBSITE,
            $websiteCode
        );

        // الكمية القابلة للبيع فعلاً
        return $this->getSalableQty->execute(
            $sku,
            (int) $stock->getStockId()
        );
    }
}

use Magento\InventorySalesApi\Api\
     IsProductSalableInterface;

// لو عايز تعرف بس "متاح ولا لأ"
$canSell = $this->isProductSalable->execute(
    $sku,
    $stockId
);

// أو بكمية محددة
use Magento\InventorySalesApi\Api\
     IsProductSalableForRequestedQtyInterface;

$result = $this->isSalableForQty->execute(
    $sku, $stockId, $requestedQty
);

if (!$result->isSalable()) {
    // بيرجّع أسباب الرفض
    foreach ($result->getErrors() as $error) {
        // $error->getMessage()
    }
}

use Magento\InventoryApi\Api\SourceItemsSaveInterface;
use Magento\InventoryApi\Api\Data\SourceItemInterfaceFactory;
use Magento\InventoryApi\Api\Data\SourceItemInterface;

$sourceItem = $this->sourceItemFactory->create();

$sourceItem->setSku('SKU-001');
$sourceItem->setSourceCode('cairo_warehouse');
$sourceItem->setQuantity(50);
$sourceItem->setStatus(
    SourceItemInterface::STATUS_IN_STOCK
);

// بياخد مصفوفة — أسرع للتحديث الجماعي
$this->sourceItemsSave->execute([$sourceItem]);

# يكشف الحجوزات المعلّقة الغلط
bin/magento inventory:reservation:list-inconsistencies

# يولّد أوامر التصحيح (من غير تنفيذ)
bin/magento inventory:reservation:create-compensations \
  --raw

# التنفيذ الفعلي — بعد المراجعة
bin/magento inventory:reservation:create-compensations

-- الكميات الفعلية في المصادر
SELECT source_code, quantity, status
FROM inventory_source_item
WHERE sku = 'SKU-001';

-- الحجوزات القائمة
SELECT stock_id, SUM(quantity) AS reserved
FROM inventory_reservation
WHERE sku = 'SKU-001'
GROUP BY stock_id;

-- أوردرات قديمة لسه محجوزة (مؤشر مشكلة)
SELECT o.increment_id, o.status, o.created_at
FROM sales_order o
WHERE o.status IN ('pending', 'processing')
  AND o.created_at < NOW() - INTERVAL 30 DAY;

// الأب مالوش مخزون أصلاً
$qty = $this->getSalableQty->execute(
    $configurableProduct->getSku(),
    $stockId
);
// النتيجة مالهاش معنى

$children = $product->getTypeInstance()
    ->getUsedProducts($product);

$total = 0;

foreach ($children as $child) {
    $total += $this->getSalableQty->execute(
        $child->getSku(),
        $stockId
    );
}

// أو للتوفّر بس — أسرع
$isAvailable = $product->isSalable();