package org.xyzh.system.mapper.user;

import java.util.List;

import org.apache.ibatis.annotations.Mapper;
import org.apache.ibatis.annotations.Param;
import org.xyzh.api.system.vo.UserDeptRoleVO;
import org.xyzh.common.core.page.PageParam;
import org.xyzh.common.dto.sys.TbSysUserRoleDTO;

import com.baomidou.mybatisplus.core.mapper.BaseMapper;

/**
 * @description    系统用户角色关系Mapper接口
 * @filename    TbSysUserRoleMapper.java
 * @author    yslg
 * @copyright yslg
 * @since 2025-11-07
 */
@Mapper
public interface TbSysUserRoleMapper extends BaseMapper<TbSysUserRoleDTO> {

    /**
     * @description    插入系统用户角色关系
     * @param    userRoleDTO    系统用户角色关系DTO
     * @return    int    插入结果
     * @author    yslg
     * @since 2025-11-07
     */
    int insertUserRole(TbSysUserRoleDTO userRoleDTO);

    /**
     * @description    更新系统用户角色关系
     * @param    userRoleDTO    系统用户角色关系DTO
     * @return    int    更新结果
     * @author    yslg
     * @since 2025-11-07
     */
    int updateUserRole(TbSysUserRoleDTO userRoleDTO);

    /**
     * @description    删除系统用户角色关系
     * @param    userRoleDTO    系统用户角色关系DTO
     * @return    int    删除结果
     * @author    yslg
     * @since 2025-11-07
     */
    int deleteUserRole(TbSysUserRoleDTO userRoleDTO);

    /**
     * @description    根据用户ID查询系统用户角色关系
     * @param    userId    用户ID
     * @return    List<UserDeptRoleVO>    用户部门角色VO列表
     * @author    yslg
     * @since 2025-11-07
     */
    List<UserDeptRoleVO> getUserRoleByUserId(String userId);

    /**
     * @description    根据条件查询系统用户角色关系列表
     * @param    filter    系统用户角色关系DTO
     * @return    List<UserDeptRoleVO>    用户部门角色VO列表
     * @author    yslg
     * @since 2025-11-07
     */
    List<UserDeptRoleVO> getUserRoleByFilter(@Param("filter") TbSysUserRoleDTO filter);

    /**
     * @description    根据条件查询系统用户角色关系分页列表
     * @param    filter    系统用户角色关系DTO
     * @param    pageParam    分页参数
     * @return    List<UserDeptRoleVO>    用户部门角色VO列表
     * @author    yslg
     * @since 2025-11-07
     */
    List<UserDeptRoleVO> getUserRolePageByFilter(@Param("filter") TbSysUserRoleDTO filter, @Param("pageParam") PageParam pageParam);
    
    /**
     * @description    根据条件查询系统用户角色关系数量
     * @param    filter    系统用户角色关系DTO
     * @return    int    系统用户角色关系数量
     * @author    yslg
     * @since 2025-11-07
     */
    int getUserRoleCount(TbSysUserRoleDTO filter);
}

