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

<?php

namespace App\Module\Mex\Services;

use App\Module\Mex\Logic\MexAdminLogic;
use App\Module\Mex\Enums\AdminOperationType;

/**
 * 农贸市场管理员服务
 * 
 * 提供管理员操作相关的对外服务接口
 */
class MexAdminService
{
    /**
     * 物品注入（增加市场供应）
     * 
     * @param int $adminUserId 管理员用户ID
     * @param int $itemId 商品ID
     * @param int $quantity 数量
     * @param string $price 价格
     * @param string|null $remark 备注
     * @return array 操作结果
     */
    public static function injectItem(int $adminUserId, int $itemId, int $quantity, string $price, ?string $remark = null): array
    {
        return MexAdminLogic::injectItem($adminUserId, $itemId, $quantity, $price, $remark);
    }

    /**
     * 物品回收（减少市场库存）
     * 
     * @param int $adminUserId 管理员用户ID
     * @param int $itemId 商品ID
     * @param int $quantity 数量
     * @param string $price 价格
     * @param string|null $remark 备注
     * @return array 操作结果
     */
    public static function recycleItem(int $adminUserId, int $itemId, int $quantity, string $price, ?string $remark = null): array
    {
        return MexAdminLogic::recycleItem($adminUserId, $itemId, $quantity, $price, $remark);
    }

    /**
     * 获取管理员操作记录
     * 
     * @param int $page 页码
     * @param int $pageSize 每页数量
     * @param int|null $adminUserId 管理员用户ID筛选
     * @param AdminOperationType|null $operationType 操作类型筛选
     * @return array 操作记录列表
     */
    public static function getAdminOperations(int $page = 1, int $pageSize = 20, ?int $adminUserId = null, ?AdminOperationType $operationType = null): array
    {
        return MexAdminLogic::getAdminOperations($page, $pageSize, $adminUserId, $operationType);
    }

    /**
     * 获取管理员操作统计
     * 
     * @param int $days 统计天数
     * @return array 统计信息
     */
    public static function getAdminOperationStats(int $days = 7): array
    {
        return MexAdminLogic::getAdminOperationStats($days);
    }
}