klp-oa/klp-wms/src/main/java/com/klp/service/IWmsApprovalService.java

package com.klp.service;

import com.klp.domain.WmsApproval;
import com.klp.domain.vo.WmsApprovalVo;
import com.klp.domain.bo.WmsApprovalBo;
import com.klp.common.core.page.TableDataInfo;
import com.klp.common.core.domain.PageQuery;

import java.util.Collection;
import java.util.List;
import java.util.Map;

/**
 * 通用审批（支持请假/外出等申请的审批）Service接口
 *
 * @author klp
 * @date 2026-01-20
 */
public interface IWmsApprovalService {

    /**
     * 查询通用审批（支持请假/外出等申请的审批）
     */
    Map<String, Object> queryById(Long approvalId);

    /**
     * 查询通用审批（支持请假/外出等申请的审批）列表
     */
    TableDataInfo<Map<String, Object>> queryPageList(WmsApprovalBo bo, PageQuery pageQuery);

    /**
     * 查询通用审批（支持请假/外出等申请的审批）列表
     */
    List<WmsApprovalVo> queryList(WmsApprovalBo bo);

    /**
     * 新增通用审批（支持请假/外出等申请的审批）
     */
    Boolean insertByBo(WmsApprovalBo bo);

    /**
     * 修改通用审批（支持请假/外出等申请的审批）
     */
    Boolean updateByBo(WmsApprovalBo bo);

    /**
     * 校验并批量删除通用审批（支持请假/外出等申请的审批）信息
     */
    Boolean deleteWithValidByIds(Collection<Long> ids, Boolean isValid);

    /**
     * 审批任务通过
     *
     * @param taskId 任务ID
     * @param approvalOpinion 审批意见
     * @return 操作结果
     */
    Map<String, Object> approveTask(Long taskId, String approvalOpinion);

    /**
     * 审批任务驳回
     *
     * @param taskId 任务ID
     * @param approvalOpinion 审批意见
     * @return 操作结果
     */
    Map<String, Object> rejectTask(Long taskId, String approvalOpinion);

    /**
     * 撤销审批
     *
     * @param approvalId 审批ID
     * @return 操作结果
     */
    Map<String, Object> cancelApproval(Long approvalId);

    /**
     * 按业务ID查询审批信息（用于用印等业务）
     *
     * @param bizId 业务ID
     * @return 审批信息包含任务详情
     */
    Map<String, Object> queryByBizId(Long bizId);
}