package com.bonus.material.approval.mapper;

import com.bonus.material.approval.domain.ApprovalInstance;
import org.apache.ibatis.annotations.Mapper;
import org.apache.ibatis.annotations.Param;

import java.util.List;

/**
 * 审批实例Mapper
 * 
 * @author bonus
 * @date 2024-11-18
 */
@Mapper
public interface ApprovalInstanceMapper {

    /**
     * 查询审批实例列表
     * 
     * @param instance 查询条件
     * @return 实例列表
     */
    List<ApprovalInstance> selectInstanceList(ApprovalInstance instance);

    /**
     * 根据ID查询审批实例
     * 
     * @param id 实例ID
     * @return 实例信息
     */
    ApprovalInstance selectInstanceById(Long id);

    /**
     * 根据实例编号查询审批实例
     * 
     * @param instanceCode 实例编号
     * @return 实例信息
     */
    ApprovalInstance selectInstanceByCode(@Param("instanceCode") String instanceCode);

    /**
     * 根据业务类型和业务ID查询审批实例
     * 
     * @param businessType 业务类型
     * @param businessId 业务ID
     * @return 实例信息
     */
    ApprovalInstance selectInstanceByBusiness(@Param("businessType") String businessType, 
                                               @Param("businessId") String businessId);

    /**
     * 查询我的待办审批列表
     * 
     * @param userId 用户ID
     * @param roleIds 角色ID列表
     * @return 待办列表
     */
    List<ApprovalInstance> selectMyTodoList(@Param("userId") Long userId, 
                                             @Param("roleIds") List<Long> roleIds);

    /**
     * 查询我的已办审批列表
     * 
     * @param userId 用户ID
     * @return 已办列表
     */
    List<ApprovalInstance> selectMyDoneList(@Param("userId") Long userId);

    /**
     * 新增审批实例
     * 
     * @param instance 实例信息
     * @return 影响行数
     */
    int insertInstance(ApprovalInstance instance);

    /**
     * 修改审批实例
     * 
     * @param instance 实例信息
     * @return 影响行数
     */
    int updateInstance(ApprovalInstance instance);

    /**
     * 更新实例状态
     * 
     * @param id 实例ID
     * @param status 状态
     * @return 影响行数
     */
    int updateInstanceStatus(@Param("id") Long id, @Param("status") String status);

    /**
     * 更新当前节点
     * 
     * @param id 实例ID
     * @param nodeId 节点ID
     * @param nodeOrder 节点顺序
     * @return 影响行数
     */
    int updateCurrentNode(@Param("id") Long id, 
                          @Param("nodeId") Long nodeId, 
                          @Param("nodeOrder") Integer nodeOrder);

    /**
     * 删除审批实例
     * 
     * @param id 实例ID
     * @return 影响行数
     */
    int deleteInstanceById(Long id);
}

