refactor: 单据审核改为审批配置状态机（新增:audit接口/审核人字段/DB变更脚本）

liu

3 天以前 7d2ee3cef2e0d68ba6400bc5957640d2771bbf4c

 yudao-module-erp/src/main/java/cn/iocoder/yudao/module/erp/service/purchase/ErpPurchaseRequestService.java

@@ -9,11 +9,10 @@

import java.util.Collection;
import java.util.List;
import java.util.Set;

/**
 * ERP 采购申请 Service 接口
 *
 * @author 芋道源码
 */
public interface ErpPurchaseRequestService {

@@ -21,11 +20,9 @@
     * 创建采购申请
     *
     * @param createReqVO 创建信息
     * @param userId      用户编号（申请人）
     * @param deptId      部门编号（申请部门）
     * @return 编号
     */
    Long createPurchaseRequest(@Valid ErpPurchaseRequestSaveReqVO createReqVO, Long userId, Long deptId);
    Long createPurchaseRequest(@Valid ErpPurchaseRequestSaveReqVO createReqVO);

    /**
     * 更新采购申请
@@ -58,61 +55,64 @@
    PageResult<ErpPurchaseRequestDO> getPurchaseRequestPage(ErpPurchaseRequestPageReqVO pageReqVO);

    /**
     * 获得采购申请明细列表
     * 获得采购申请项列表
     *
     * @param requestId 采购申请编号
     * @return 采购申请明细列表
     * @return 采购申请项列表
     */
    List<ErpPurchaseRequestItemDO> getPurchaseRequestItemListByRequestId(Long requestId);

    /**
     * 获得采购申请明细列表
     * 获得采购申请项 List
     *
     * @param requestIds 采购申请编号数组
     * @return 采购申请明细列表
     * @return 采购申请项 List
     */
    List<ErpPurchaseRequestItemDO> getPurchaseRequestItemListByRequestIds(Collection<Long> requestIds);

    /**
     * 提交采购申请审批
     *
     * @param id                   编号
     * @param processDefinitionKey 流程定义 Key（用户选择）
     * @param userId               用户编号
     * 仅【未提交】或【审核不通过】状态可提交；审批人由「系统管理 - 审批配置」统一指定，
     * 提交后进入【审批中】，并清空上一轮审核结果。
     *
     * @param id 编号
     */
    void submitPurchaseRequest(Long id, String processDefinitionKey, Long userId);
    void submitPurchaseRequest(Long id);

    /**
     * 更新采购申请审批状态
     * 获取采购申请的审批人编号集合（或签：任一人审核即可）
     *
     * @param id        编号
     * @param bpmResult BPM 审批结果
     * @return 审批人用户编号
     */
    void updatePurchaseRequestAuditStatus(Long id, Integer bpmResult);
    Set<Long> getPurchaseRequestApproverUserIds();

    /**
     * 根据采购申请生成采购订单
     * 审核采购申请（通过 / 不通过）
     *
     * @param id         采购申请编号
     * 仅配置内的审批人可执行；审核不通过时必须填写原因，退回后可修改并重新提交。
     *
     * @param id 编号
     * @param pass 是否审核通过
     * @param reviewRemark 审核意见
     */
    void auditPurchaseRequest(Long id, Boolean pass, String reviewRemark);

    /**
     * 生成采购订单
     *
     * @param id 采购申请编号
     * @param supplierId 供应商编号
     * @param userId     用户编号
     * @return 采购订单编号
     */
    Long generatePurchaseOrder(Long id, Long supplierId, Long userId);
    Long generatePurchaseOrder(Long id, Long supplierId);

    /**
     * 获取采购申请审批流程列表
     * 根据编号列表获取采购申请列表
     *
     * @return 流程定义列表
     * @param ids 编号列表
     * @return 采购申请列表
     */
    List<java.util.Map<String, Object>> getPurchaseRequestApproveProcessDefinitionList();
    List<ErpPurchaseRequestDO> getPurchaseRequestList(List<Long> ids);

    /**
     * 更新采购申请的入库状态
     *
     * @param id       采购申请编号
     * @param inStatus 入库状态
     */
    void updatePurchaseRequestInStatus(Long id, Integer inStatus);

}
}