package com.qf.backend.service;

import java.util.List;

import com.baomidou.mybatisplus.extension.service.IService;
import com.qf.backend.dto.Result;
import com.qf.backend.entity.User.Roles;

/**
 * 角色服务接口
 */
public interface RolesService extends IService<Roles> {

    /**
     * 根据角色名称查询角色
     * @param roleName 角色名称
     * @return 角色信息
     */
    Result<Roles> getRoleByName(String roleName);

    /**
     * 创建角色
     * @param roles 角色信息
     * @return 是否成功
     */
    Result<Boolean> createRole(Roles roles);

    /**
     * 更新角色信息
     * @param roles 角色信息
     * @return 是否成功
     */
    Result<Boolean> updateRole(Roles roles);

    /**
     * 删除角色
     * @param id 角色ID
     * @return 是否成功
     */
    Result<Boolean> deleteRole(Long id);

    /**
     * 查询所有角色
     * @return 角色列表
     */
    Result<List<Roles>> listAllRoles();

    /**
     * 根据角色ID查询角色
     * @param id 角色ID
     * @return 角色信息
     */
    Result<Roles> getRoleById(Long id);

    /**
     * 批量删除角色
     * @param ids 角色ID列表
     * @return 是否成功
     */
    Result<Boolean> batchDeleteRoles(List<Long> ids);

    /**
     * 根据用户ID查询其拥有的角色列表
     * @param userId 用户ID
     * @return 角色列表
     */
    Result<List<Roles>> listRolesByUserId(Long userId);
}