package shop.alien.storeplatform.service;

import com.baomidou.mybatisplus.core.metadata.IPage;
import shop.alien.entity.store.StoreOperationalStatisticsHistory;
import shop.alien.entity.store.vo.StoreOperationalStatisticsComparisonVo;
import shop.alien.entity.store.vo.StoreOperationalStatisticsVo;

import java.util.List;

/**
 * 商家经营数据统计服务接口
 *
 * @author system
 * @version 1.0
 * @date 2026/01/05
 */
public interface PlatformStoreOperationalStatisticsService {


    /**
     * 获取商家经营统计数据（符合埋点统计数据JSON格式）
     *
     * @param storeId   店铺ID
     * @param startTime 开始时间（格式：yyyy-MM-dd）
     * @param endTime   结束时间（格式：yyyy-MM-dd）
     * @return 经营统计数据
     */
    StoreOperationalStatisticsVo getPlatformStatisticsInTrackFormat(Integer storeId, String startTime, String endTime);

    /**
     * 获取商家经营统计数据对比
     *
     * @param storeId           店铺ID
     * @param currentStartTime  当期开始时间（格式：yyyy-MM-dd）
     * @param currentEndTime    当期结束时间（格式：yyyy-MM-dd）
     * @param previousStartTime 上期开始时间（格式：yyyy-MM-dd）
     * @param previousEndTime   上期结束时间（格式：yyyy-MM-dd）
     * @return 经营统计数据对比
     */
    StoreOperationalStatisticsComparisonVo getPlatformStatisticsComparison(Integer storeId, String currentStartTime, String currentEndTime,
                                                                   String previousStartTime, String previousEndTime);


    /**
     * 根据ID查询历史统计记录详情
     *
     * @param id 历史记录ID
     * @return 历史统计记录详情
     */
    StoreOperationalStatisticsHistory getPlatformHistoryById(Integer id);

    /**
     * 查询历史统计记录列表（分页）
     *
     * @param storeId    店铺ID
     * @param page       页码
     * @param size       每页大小
     * @param createdTime 查询日期（yyyy-MM-dd），可为空；传入时仅返回 query_time 为该日期的记录
     * @return 历史统计记录分页列表
     */
    IPage<StoreOperationalStatisticsHistory> getPlatformHistoryList(Integer storeId, Integer page, Integer size, String createdTime);

    /**
     * 批量删除历史统计记录（逻辑删除）
     *
     * @param ids 历史记录ID列表
     * @return 是否成功
     */
    boolean batchPlatformDeleteHistory(List<Integer> ids);

    /**
     * 根据历史记录ID生成统计数据对比PDF报告并上传到OSS（对比数据从 history 的 statistics_data 解析）
     *
     * @param storeId   店铺ID
     * @param historyId 历史记录ID
     * @return PDF的OSS URL
     */
    String generateStatisticsComparisonPdfByHistoryId(Integer storeId, Integer historyId);
}
