package cn.iocoder.yudao.module.crm.service.salesTarget;

import cn.iocoder.yudao.framework.common.pojo.PageResult;
import cn.iocoder.yudao.module.crm.controller.admin.salesTarget.vo.CrmSalesTargetChangeStatusReqVO;
import cn.iocoder.yudao.module.crm.controller.admin.salesTarget.vo.CrmSalesTargetPageReqVO;
import cn.iocoder.yudao.module.crm.controller.admin.salesTarget.vo.CrmSalesTargetRespVO;
import cn.iocoder.yudao.module.crm.controller.admin.salesTarget.vo.CrmSalesTargetSaveReqVO;
import cn.iocoder.yudao.module.crm.controller.admin.salesTarget.vo.analysis.CrmSalesTargetAnalysisReqVO;
import jakarta.validation.Valid;

import java.util.List;

/**
 * CRM 销售目标 Service 接口
 *
 * @author 超级管理员
 */
public interface CrmSalesTargetService {

    /**
     * 创建销售目标
     *
     * @param createReqVO 创建信息
     * @return 编号
     */
    Long createSalesTarget(@Valid CrmSalesTargetSaveReqVO createReqVO);

    /**
     * 更新销售目标
     *
     * @param updateReqVO 更新信息
     */
    void updateSalesTarget(@Valid CrmSalesTargetSaveReqVO updateReqVO);

    /**
     * 变更销售目标状态（作废/恢复等）
     *
     * @param reqVO 状态变更信息
     */
    void changeSalesTargetStatus(@Valid CrmSalesTargetChangeStatusReqVO reqVO);

    /**
     * 删除销售目标
     *
     * @param id 编号
     */
    void deleteSalesTarget(Long id);

    /**
     * 获得销售目标（含实际达成）
     *
     * @param id 编号
     * @return 销售目标
     */
    CrmSalesTargetRespVO getSalesTarget(Long id);

    /**
     * 获得销售目标分页（含实际达成）
     *
     * @param pageReqVO 分页查询
     * @return 销售目标分页
     */
    PageResult<CrmSalesTargetRespVO> getSalesTargetPage(CrmSalesTargetPageReqVO pageReqVO);

    /**
     * 获得销售目标列表（全量，用于 Excel 导出）
     *
     * @param reqVO 查询条件
     * @return 销售目标列表
     */
    List<CrmSalesTargetRespVO> getSalesTargetList(CrmSalesTargetPageReqVO reqVO);

    /**
     * 获得销售目标达成分析列表（按周期+维度过滤，含实际达成与达成率）
     *
     * @param reqVO 分析查询
     * @return 达成分析列表
     */
    List<CrmSalesTargetRespVO> getSalesTargetAnalysis(CrmSalesTargetAnalysisReqVO reqVO);

}