xiaoyi
2026-11-04 883f5e73fbe7458fd760dbe8560dd5d8757e04cd
yudao-module-aftersales/src/main/java/cn/iocoder/yudao/module/aftersales/service/compensation/AfterSaleCompensationService.java
@@ -1,13 +1,11 @@
package cn.iocoder.yudao.module.aftersales.service.compensation;
import cn.iocoder.yudao.framework.common.pojo.PageResult;
import cn.iocoder.yudao.module.aftersales.controller.admin.compensation.vo.AfterSaleCompensationAuditReqVO;
import cn.iocoder.yudao.module.aftersales.controller.admin.compensation.vo.AfterSaleCompensationPageReqVO;
import cn.iocoder.yudao.module.aftersales.controller.admin.compensation.vo.AfterSaleCompensationSaveReqVO;
import cn.iocoder.yudao.module.aftersales.dal.dataobject.compensation.AfterSaleCompensationDO;
import java.util.List;
import java.util.Map;
import java.util.Set;
/**
 * 售后赔付/服务补偿单 Service 接口
@@ -25,23 +23,39 @@
    PageResult<AfterSaleCompensationDO> getCompensationPage(AfterSaleCompensationPageReqVO pageReqVO);
    /**
     * 提交赔付单审批
     * 提交赔付单审批(未提交 / 审核不通过 → 审批中)
     *
     * 审批人由「系统管理 - 审批配置」按业务类型 compensation_approve 统一指定,提交时不选人。
     *
     * @param id 赔付单编号
     */
    void submitCompensation(Long id, String processDefinitionKey, Long userId);
    void submitCompensation(Long id);
    /**
     * 审批赔付单(通过/驳回)
     * 获得赔付单审批人编号集合,供前端判断是否展示审核按钮
     *
     * @return 审批人用户编号集合
     */
    void auditCompensation(AfterSaleCompensationAuditReqVO auditReqVO);
    Set<Long> getCompensationApproverUserIds();
    /**
     * 更新赔付单审批状态(BPM 监听回调)
     * 审核赔付单(审批中 → 审核通过 / 审核不通过)
     *
     * @param id           赔付单编号
     * @param pass         是否通过
     * @param reviewRemark 审核意见,审核不通过时必填
     */
    void updateCompensationAuditStatus(Long id, Integer bpmResult);
    void auditCompensation(Long id, Boolean pass, String reviewRemark);
    /**
     * 获得赔付单审批流程定义列表
     * 根据 BPM 审批结果回写赔付单审批状态
     *
     * 由 BPM 流程结束事件驱动,使赔付单审批统一在「协同办公 - 我的流程」中流转。
     *
     * @param id        赔付单编号
     * @param bpmStatus BPM 任务状态,见 {@link cn.iocoder.yudao.module.bpm.enums.task.BpmTaskStatusEnum}
     * @param reason    审批意见
     */
    List<Map<String, Object>> getCompensationApproveProcessDefinitionList();
    void updateCompensationAuditStatus(Long id, Integer bpmStatus, String reason);
}