package com.seer.teach.user.admin.service;

import com.seer.teach.common.PageListBean;
import com.seer.teach.user.admin.request.AuthorityBatchUpdate;
import com.seer.teach.user.admin.response.AdminUserInfoResp;
import com.seer.teach.user.admin.response.AuthorityRespData;
import com.seer.teach.user.admin.request.AddAuthority;
import com.seer.teach.user.admin.request.UpdateAuthority;

import java.util.List;

/**
 * <p>
 * 权限服务接口，定义了权限相关的操作方法
 * </p>
 *
 * @author Captain
 * @since 2024-01-19
 */
public interface AdminAuthorityService {

    /**
     * 获取系统中定义的所有权限信息
     *
     * @return 返回系统所有权限的响应数据列表
     */
    List<AuthorityRespData> getSystemAllAuthority();

    /**
     * 添加新的系统权限
     *
     * @param params 添加权限请求参数
     */
    void addSystemAuthority(AddAuthority params);

    /**
     * 根据权限ID删除对应的权限
     *
     * @param id 权限唯一标识
     */
    void deleteAuthorityById(Integer id);

    /**
     * 更新已有的系统权限信息
     *
     * @param params 更新权限请求参数
     */
    void updateAuthority(UpdateAuthority params);


    /**
     * 分页查询权限列表
     *
     * @param page          当前页码
     * @param size          每页记录数
     * @param authorityName 权限名称（可为空）
     * @return 返回分页权限列表的响应数据
     */
    PageListBean<AuthorityRespData> getAuthorityPage(Integer page, Integer size, String authorityName);

    /**
     * 获取用户权限列表
     *
     * @param loginUserId 用户登录ID
     * @return 返回用户权限列表的响应数据
     */
    AdminUserInfoResp info(int loginUserId,String module);

    /**
     * 批量更新权限信息
     *
     * @param batchUpdateParams 权限批量更新参数
     * @return 返回更新结果
     */
    boolean batchUpdateAuthority(AuthorityBatchUpdate batchUpdateParams);

    /**
     * 切换权限显示状态
     *
     * @param id     权限ID
     * @param isShow 是否显示
     * @return 返回切换结果
     */
    boolean toggleShowAuthority(Integer id, Integer isShow);
}
