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

import cn.iocoder.yudao.framework.common.pojo.PageResult;
import cn.iocoder.yudao.module.crm.controller.admin.invoice.vo.invoice.CrmInvoicePageReqVO;
import cn.iocoder.yudao.module.crm.controller.admin.invoice.vo.invoice.CrmInvoiceSaveReqVO;
import cn.iocoder.yudao.module.crm.dal.dataobject.invoice.CrmInvoiceDO;
import jakarta.validation.Valid;

import java.math.BigDecimal;
import java.util.Collection;
import java.util.List;
import java.util.Map;
import java.util.Set;

import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertMap;

/**
 * CRM 开票 Service 接口
 *
 * @author 超级管理员
 */
public interface CrmInvoiceService {

    /**
     * 创建开票
     *
     * @param createReqVO 创建信息
     * @return 编号
     */
    Long createInvoice(@Valid CrmInvoiceSaveReqVO createReqVO);

    /**
     * 更新开票
     *
     * @param updateReqVO 更新信息
     */
    void updateInvoice(@Valid CrmInvoiceSaveReqVO updateReqVO);

    /**
     * 删除开票
     *
     * @param id 编号
     */
    void deleteInvoice(Long id);

    /**
     * 提交开票审批（草稿 / 审核不通过 → 审批中）
     *
     * 审批人由「系统管理 - 审批配置」按业务类型统一配置（业务编码 crm_invoice_approve），
     * 提交时无需指定；未启用审批或未配置有效审批人时抛出业务异常。
     *
     * @param id 开票编号
     */
    void submitInvoice(Long id);

    /**
     * 获得开票审批的审批人编号集合
     *
     * 供前端判断当前登录用户是否应展示「审核」按钮；未配置时返回空集合。
     *
     * @return 审批人用户编号集合
     */
    Set<Long> getInvoiceApproverUserIds();

    /**
     * 审核开票（审批中 → 审核通过 / 审核不通过）
     *
     * 仅业务编码 crm_invoice_approve 配置的审批人可操作（多人时或签）；审核不通过时必须填写不通过原因。
     *
     * @param id           开票编号
     * @param pass         是否通过：true=审核通过 / false=审核不通过
     * @param reviewRemark 审核意见（不通过时即不通过原因，必填）
     */
    void auditInvoice(Long id, Boolean pass, String reviewRemark);

    /**
     * 获得开票
     *
     * @param id 编号
     * @return 开票
     */
    CrmInvoiceDO getInvoice(Long id);

    /**
     * 获得开票列表
     *
     * @param ids 编号
     * @return 开票列表
     */
    List<CrmInvoiceDO> getInvoiceList(Collection<Long> ids);

    /**
     * 获得开票 Map
     *
     * @param ids 编号
     * @return 开票 Map
     */
    default Map<Long, CrmInvoiceDO> getInvoiceMap(Collection<Long> ids) {
        return convertMap(getInvoiceList(ids), CrmInvoiceDO::getId);
    }

    /**
     * 获得开票分页
     *
     * 数据权限：基于 {@link CrmInvoiceDO} 读取
     *
     * @param pageReqVO 分页查询
     * @param userId    用户编号
     * @return 开票分页
     */
    PageResult<CrmInvoiceDO> getInvoicePage(CrmInvoicePageReqVO pageReqVO, Long userId);

    /**
     * 获得开票分页，基于指定客户
     *
     * @param pageReqVO 分页查询
     * @return 开票分页
     */
    PageResult<CrmInvoiceDO> getInvoicePageByCustomerId(CrmInvoicePageReqVO pageReqVO);

    /**
     * 获得待审核开票数量
     *
     * @param userId 用户编号
     * @return 待审批数量
     */
    Long getAuditInvoiceCount(Long userId);

    /**
     * 根据合同编号查询开票列表
     *
     * @param contractId   合同编号
     * @param auditStatuses 审批状态集合
     * @return 开票列表
     */
    List<CrmInvoiceDO> getInvoiceListByContractIdAndStatus(Long contractId, Collection<Integer> auditStatuses);

    /**
     * 获得合同已开票金额 Map（审批通过 + 审批中，与开票防超校验口径一致）
     *
     * @param contractIds 合同编号
     * @return 开票金额 Map
     */
    Map<Long, BigDecimal> getInvoicePriceMapByContractId(Collection<Long> contractIds);

    /**
     * 根据合同编号查询开票数量
     *
     * @param contractId 合同编号
     * @return 开票数量
     */
    Long getInvoiceCountByContractId(Long contractId);

}