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

liu

3 天以前 7d2ee3cef2e0d68ba6400bc5957640d2771bbf4c

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

¶Ô±ÈÐÂÎļþ
@@ -0,0 +1,118 @@
package cn.iocoder.yudao.module.erp.service.purchase;

import cn.iocoder.yudao.framework.common.pojo.PageResult;
import cn.iocoder.yudao.module.erp.controller.admin.purchase.vo.request.ErpPurchaseRequestPageReqVO;
import cn.iocoder.yudao.module.erp.controller.admin.purchase.vo.request.ErpPurchaseRequestSaveReqVO;
import cn.iocoder.yudao.module.erp.dal.dataobject.purchase.ErpPurchaseRequestDO;
import cn.iocoder.yudao.module.erp.dal.dataobject.purchase.ErpPurchaseRequestItemDO;
import jakarta.validation.Valid;

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

/**
 * ERP é‡‡è´­ç”³è¯· Service æŽ¥å£
 */
public interface ErpPurchaseRequestService {

    /**
     * åˆ›å»ºé‡‡è´­ç”³è¯·
     *
     * @param createReqVO åˆ›å»ºä¿¡æ¯
     * @return ç¼–号
     */
    Long createPurchaseRequest(@Valid ErpPurchaseRequestSaveReqVO createReqVO);

    /**
     * æ›´æ–°é‡‡è´­ç”³è¯·
     *
     * @param updateReqVO æ›´æ–°ä¿¡æ¯
     */
    void updatePurchaseRequest(@Valid ErpPurchaseRequestSaveReqVO updateReqVO);

    /**
     * åˆ é™¤é‡‡è´­ç”³è¯·
     *
     * @param ids ç¼–号数组
     */
    void deletePurchaseRequest(List<Long> ids);

    /**
     * èŽ·å¾—采购申请
     *
     * @param id ç¼–号
     * @return é‡‡è´­ç”³è¯·
     */
    ErpPurchaseRequestDO getPurchaseRequest(Long id);

    /**
     * èŽ·å¾—采购申请分页
     *
     * @param pageReqVO åˆ†é¡µæŸ¥è¯¢
     * @return é‡‡è´­ç”³è¯·åˆ†é¡µ
     */
    PageResult<ErpPurchaseRequestDO> getPurchaseRequestPage(ErpPurchaseRequestPageReqVO pageReqVO);

    /**
     * èŽ·å¾—采购申请项列表
     *
     * @param requestId é‡‡è´­ç”³è¯·ç¼–号
     * @return é‡‡è´­ç”³è¯·é¡¹åˆ—表
     */
    List<ErpPurchaseRequestItemDO> getPurchaseRequestItemListByRequestId(Long requestId);

    /**
     * èŽ·å¾—采购申请项 List
     *
     * @param requestIds é‡‡è´­ç”³è¯·ç¼–号数组
     * @return é‡‡è´­ç”³è¯·é¡¹ List
     */
    List<ErpPurchaseRequestItemDO> getPurchaseRequestItemListByRequestIds(Collection<Long> requestIds);

    /**
     * æäº¤é‡‡è´­ç”³è¯·å®¡æ‰¹
     *
     * ä»…【未提交】或【审核不通过】状态可提交；审批人由「系统管理 - å®¡æ‰¹é…ç½®ã€ç»Ÿä¸€æŒ‡å®šï¼Œ
     * æäº¤åŽè¿›å…¥ã€å®¡æ‰¹ä¸­ã€‘，并清空上一轮审核结果。
     *
     * @param id ç¼–号
     */
    void submitPurchaseRequest(Long id);

    /**
     * èŽ·å–采购申请的审批人编号集合（或签：任一人审核即可）
     *
     * @return å®¡æ‰¹äººç”¨æˆ·ç¼–号
     */
    Set<Long> getPurchaseRequestApproverUserIds();

    /**
     * å®¡æ ¸é‡‡è´­ç”³è¯·ï¼ˆé€šè¿‡ / ä¸é€šè¿‡ï¼‰
     *
     * ä»…配置内的审批人可执行；审核不通过时必须填写原因，退回后可修改并重新提交。
     *
     * @param id ç¼–号
     * @param pass æ˜¯å¦å®¡æ ¸é€šè¿‡
     * @param reviewRemark å®¡æ ¸æ„è§
     */
    void auditPurchaseRequest(Long id, Boolean pass, String reviewRemark);

    /**
     * ç”Ÿæˆé‡‡è´­è®¢å•
     *
     * @param id é‡‡è´­ç”³è¯·ç¼–号
     * @param supplierId ä¾›åº”商编号
     * @return é‡‡è´­è®¢å•ç¼–号
     */
    Long generatePurchaseOrder(Long id, Long supplierId);

    /**
     * æ ¹æ®ç¼–号列表获取采购申请列表
     *
     * @param ids ç¼–号列表
     * @return é‡‡è´­ç”³è¯·åˆ—表
     */
    List<ErpPurchaseRequestDO> getPurchaseRequestList(List<Long> ids);

}