package shop.alien.storeplatform.service;

import com.baomidou.mybatisplus.extension.service.IService;
import shop.alien.entity.store.StorePlatformRoleMenu;

import java.util.List;

/**
 * 角色菜单关联表 服务类
 *
 * @author system
 * @since 2025-01-XX
 */
public interface StorePlatformRoleMenuService extends IService<StorePlatformRoleMenu> {

    /**
     * 根据角色ID查询菜单ID列表
     *
     * @param roleId 角色ID
     * @return 菜单ID列表
     */
    List<Long> getMenuIdsByRoleId(Long roleId);

    /**
     * 根据菜单ID查询角色ID列表
     *
     * @param menuId 菜单ID
     * @return 角色ID列表
     */
    List<Long> getRoleIdsByMenuId(Long menuId);

    /**
     * 为角色分配菜单
     *
     * @param roleId  角色ID
     * @param menuIds 菜单ID列表
     * @return 是否成功
     */
    boolean assignMenus(Long roleId, List<Long> menuIds);

    /**
     * 移除角色的所有菜单
     *
     * @param roleId 角色ID
     * @return 是否成功
     */
    boolean removeAllMenus(Long roleId);

    /**
     * 为角色添加单个菜单
     *
     * @param roleId 角色ID
     * @param menuId 菜单ID
     * @return 是否成功
     */
    boolean addMenu(Long roleId, Long menuId);

    /**
     * 移除角色的单个菜单
     *
     * @param roleId 角色ID
     * @param menuId 菜单ID
     * @return 是否成功
     */
    boolean removeMenu(Long roleId, Long menuId);

    /**
     * 根据角色ID获取权限树形结构
     *
     * @param roleId 角色ID
     * @return 权限树形结构列表
     */
    List<shop.alien.entity.store.vo.RolePermissionVo> getRolePermissionTree(Long roleId);

    /**
     * 根据角色ID获取权限表格数据（按层级展示）
     * 如果角色有三级权限，则显示一级、二级、三级权限
     * 如果只有一级权限，则只显示一级权限
     * 如果只有二级权限，则显示一级和二级权限
     *
     * @param roleId 角色ID
     * @return 权限表格数据列表
     */
    List<shop.alien.entity.store.vo.RolePermissionTableVo> getRolePermissionTable(Long roleId);
}

