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

<?php

namespace App\Module\Mex\Services;

use App\Module\Mex\Logic\MexTransactionLogic;

/**
 * 农贸市场成交记录服务
 * 
 * 提供成交记录相关的对外服务接口
 */
class MexTransactionService
{
    /**
     * 获取交易大厅成交记录
     * 
     * @param int $page 页码
     * @param int $pageSize 每页数量
     * @param int|null $itemId 商品ID筛选
     * @return array 成交记录列表
     */
    public static function getPublicTransactions(int $page = 1, int $pageSize = 20, ?int $itemId = null): array
    {
        return MexTransactionLogic::getPublicTransactions($page, $pageSize, $itemId);
    }

    /**
     * 获取用户成交记录
     * 
     * @param int $userId 用户ID
     * @param int $page 页码
     * @param int $pageSize 每页数量
     * @return array 成交记录列表
     */
    public static function getUserTransactions(int $userId, int $page = 1, int $pageSize = 20): array
    {
        return MexTransactionLogic::getUserTransactions($userId, $page, $pageSize);
    }

    /**
     * 获取商品成交统计
     * 
     * @param int $itemId 商品ID
     * @param int $days 统计天数
     * @return array 统计信息
     */
    public static function getItemTransactionStats(int $itemId, int $days = 7): array
    {
        return MexTransactionLogic::getItemTransactionStats($itemId, $days);
    }

    /**
     * 获取市场成交统计
     * 
     * @param int $days 统计天数
     * @return array 统计信息
     */
    public static function getMarketStats(int $days = 7): array
    {
        return MexTransactionLogic::getMarketStats($days);
    }

    /**
     * 获取商品最新成交价格
     *
     * @param int $itemId 商品ID
     * @return string|null 最新价格
     */
    public static function getLatestPrice(int $itemId): ?string
    {
        return MexTransactionLogic::getLatestPrice($itemId);
    }

    /**
     * 获取最后撮合时间信息
     *
     * @return array 最后撮合时间信息
     */
    public static function getLastMatchTimes(): array
    {
        return MexTransactionLogic::getLastMatchTimes();
    }
}