kknongchang_2506/app/Module/Mex/Services/MexWarehouseService.php

<?php

namespace App\Module\Mex\Services;

use App\Module\Mex\Logic\MexWarehouseLogic;

/**
 * 农贸市场仓库服务
 * 
 * 提供仓库相关的对外服务接口
 */
class MexWarehouseService
{
    /**
     * 获取商品库存信息
     * 
     * @param int $itemId 商品ID
     * @return array|null 库存信息
     */
    public static function getItemStock(int $itemId): ?array
    {
        return MexWarehouseLogic::getItemStock($itemId);
    }

    /**
     * 获取多个商品的库存信息
     * 
     * @param array $itemIds 商品ID数组
     * @return array 库存信息列表
     */
    public static function getItemsStock(array $itemIds): array
    {
        return MexWarehouseLogic::getItemsStock($itemIds);
    }

    /**
     * 检查库存是否充足
     * 
     * @param int $itemId 商品ID
     * @param int $quantity 需要数量
     * @return bool 是否充足
     */
    public static function checkStockSufficient(int $itemId, int $quantity): bool
    {
        return MexWarehouseLogic::checkStockSufficient($itemId, $quantity);
    }

    /**
     * 获取所有有库存的商品
     * 
     * @return array 商品列表
     */
    public static function getAvailableItems(): array
    {
        return MexWarehouseLogic::getAvailableItems();
    }

    /**
     * 获取仓库统计信息
     * 
     * @return array 统计信息
     */
    public static function getWarehouseStats(): array
    {
        return MexWarehouseLogic::getWarehouseStats();
    }
}