package shop.alien.store.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 StoreOperationalStatisticsService {

    /**
     * 获取商家经营统计数据
     *
     * @param storeId   店铺ID
     * @param startTime 开始时间（格式：yyyy-MM-dd）
     * @param endTime   结束时间（格式：yyyy-MM-dd）
     * @return 经营统计数据
     */
    StoreOperationalStatisticsVo getStatistics(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 getStatisticsComparison(Integer storeId, String currentStartTime, String currentEndTime,
                                                                    String previousStartTime, String previousEndTime);

    /**
     * 查询历史统计记录列表（分页）
     *
     * @param storeId 店铺ID
     * @param page    页码
     * @param size    每页大小
     * @return 历史统计记录分页列表
     */
    IPage<StoreOperationalStatisticsHistory> getHistoryList(Integer storeId, Integer page, Integer size);

    /**
     * 删除历史统计记录（逻辑删除）
     *
     * @param id 历史记录ID
     * @return 是否成功
     */
    boolean deleteHistory(Integer id);

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

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

    /**
     * 更新历史统计记录的PDF URL
     *
     * @param historyId 历史记录ID
     * @param pdfUrl    PDF文件URL
     * @return 是否成功
     */
    boolean updateHistoryPdfUrl(Integer historyId, String pdfUrl);

    /**
     * 更新历史统计记录的AI分析结果
     *
     * @param historyId             历史记录ID
     * @param aiAnalysisCompleted   AI分析是否完成, 0:未完成, 1:已完成
     * @param summary               总结
     * @param optimizationSuggestions 优化建议
     * @return 是否成功
     */
    boolean updateHistoryAiAnalysis(Integer historyId, Integer aiAnalysisCompleted, String summary, String optimizationSuggestions);

    /**
     * 生成统计数据对比PDF报告并上传到OSS
     *
     * @param storeId           店铺ID
     * @param currentStartTime  当期开始时间（格式：yyyy-MM-dd）
     * @param currentEndTime    当期结束时间（格式：yyyy-MM-dd）
     * @param previousStartTime 上期开始时间（格式：yyyy-MM-dd）
     * @param previousEndTime   上期结束时间（格式：yyyy-MM-dd）
     * @return PDF的OSS URL
     */
    String generateStatisticsComparisonPdf(Integer storeId, String currentStartTime, String currentEndTime,
                                           String previousStartTime, String previousEndTime);
}
