// Package admin_system_role 定义角色管理接口（角色及其菜单绑定），路由前缀 /admin。
package admin_system_role

import "github.com/gogf/gf/v2/frame/g"

// RoleItem 角色列表中的一行。
type RoleItem struct {
	Id        uint64   `json:"id"`
	Code      string   `json:"code"`
	Name      string   `json:"name"`
	Status    int      `json:"status"`
	MenuIds   []uint64 `json:"menuIds"` // 已绑定的菜单 id（编辑用）
	CreatedAt string   `json:"createdAt"`
}

// RoleListReq 分页查询角色。
type RoleListReq struct {
	g.Meta  `path:"/system/role/list" method:"post" tags:"Admin/System/Role" summary:"角色列表"`
	Page    int    `json:"page" d:"1" v:"min:1"`
	Size    int    `json:"size" d:"10" v:"min:1|max:100"`
	Keyword string `json:"keyword"` // 匹配角色码或名称
}

// RoleListRes 是 RoleListReq 的响应。
type RoleListRes struct {
	List  []*RoleItem `json:"list"`
	Total int         `json:"total"`
}

// RoleCreateReq 创建角色并绑定菜单。
type RoleCreateReq struct {
	g.Meta  `path:"/system/role/create" method:"post" tags:"Admin/System/Role" summary:"创建角色"`
	Code    string   `json:"code" v:"required"`
	Name    string   `json:"name" v:"required"`
	Status  int      `json:"status"`
	MenuIds []uint64 `json:"menuIds"`
}

// RoleCreateRes 是 RoleCreateReq 的响应。
type RoleCreateRes struct {
	Id uint64 `json:"id"`
}

// RoleUpdateReq 更新角色并重新绑定菜单。
type RoleUpdateReq struct {
	g.Meta  `path:"/system/role/update/{id}" method:"post" tags:"Admin/System/Role" summary:"更新角色"`
	Id      uint64   `json:"id" in:"path" v:"required"`
	Name    string   `json:"name" v:"required"`
	Status  int      `json:"status"`
	MenuIds []uint64 `json:"menuIds"`
}

// RoleUpdateRes 是 RoleUpdateReq 的响应。
type RoleUpdateRes struct{}

// RoleDeleteReq 删除角色（软删除）。
type RoleDeleteReq struct {
	g.Meta `path:"/system/role/delete/{id}" method:"post" tags:"Admin/System/Role" summary:"删除角色"`
	Id     uint64 `json:"id" in:"path" v:"required"`
}

// RoleDeleteRes 是 RoleDeleteReq 的响应。
type RoleDeleteRes struct{}