package com.ruoyi.web.modules.screen.mallstats;

import com.ruoyi.web.modules.screen.domain.vo.MallStatsOverviewVo;

/**
 * 调用农资商城 {@code /api/open/stats/overview} 聚合接口。
 */
public interface MallStatsOpenApiClient
{
    /**
     * 拉取商城统计 overview；未启用、配置缺失或调用失败时返回 {@code null}（不抛异常）。
     *
     * @param statYear 统计年，对应商城 Open API 查询参数 {@code statYear}
     */
    MallStatsOverviewVo fetchOverview(int statYear);
}
