// ================================================================================
// Code generated and maintained by GoFrame CLI tool. DO NOT EDIT.
// You can delete these comments if you wish manually maintain this interface file.
// ================================================================================

package service

import (
	"context"
	"easygoadmin/api/v1"
)

// 按模块独立拆分（源：gf gen service 产物手工重组）。
// logic 方法签名变更时需同步维护本文件（手维护，勿整体运行 gf gen service）。

// IRole 角色服务接口
type IRole interface {
	// Page 角色分页
	// 分页结果包含关联用户数
	Page(ctx context.Context, req *v1.RolePageReq) (res *v1.RolePageRes, err error)
	// List 角色全量列表
	List(ctx context.Context, req *v1.RoleListReq) (res v1.RoleListRes, err error)
	// Detail 角色详情
	Detail(ctx context.Context, req *v1.RoleDetailReq) (res *v1.RoleDetailRes, err error)
	// Add 新增角色
	// 角色编码唯一
	Add(ctx context.Context, req *v1.RoleAddReq) (res *v1.IdRes, err error)
	// Update 修改角色
	// 角色编码不允许变更
	Update(ctx context.Context, req *v1.RoleUpdateReq) (res *v1.RoleUpdateRes, err error)
	// Delete 删除角色
	// 存在关联用户时禁止删除
	Delete(ctx context.Context, req *v1.RoleDeleteReq) (res *v1.RoleDeleteRes, err error)
	// BatchDelete 批量删除角色
	BatchDelete(ctx context.Context, req *v1.RoleBatchDeleteReq) (res *v1.RoleBatchDeleteRes, err error)
	// MenuList 角色菜单勾选列表
	// 返回平铺列表并附带勾选状态
	MenuList(ctx context.Context, req *v1.RoleMenuListReq) (res v1.RoleMenuListRes, err error)
	// SavePermission 保存角色菜单权限
	// 全量替换角色菜单关联，并失效相关用户的身份缓存
	SavePermission(ctx context.Context, req *v1.RoleSavePermissionReq) (res *v1.RoleSavePermissionRes, err error)
}

// localRole 角色服务实现实例
var localRole IRole

// Role 获取角色服务实例
func Role() IRole {
	if localRole == nil {
		panic("implement not found for interface IRole, forgot register?")
	}
	return localRole
}

// RegisterRole 注册角色服务实现
func RegisterRole(i IRole) {
	localRole = i
}