syntax = "v1"

import (
	"base.api"
	"user.api"
	"permission.api"
)

type (
	QueryRolesReq {
		PageReq
		SortReq
		Name string `form:"name,optional"`
	}
	CreateRoleReq {
		Name        string `json:"name,optional" validate:"required,gte=2,lte=20" comment:"角色名, 不能超过20个字符"`
		Description string `json:"description,optional" comment:"描述, 不能超过60个字符"`
	}
	UpdateRoleReq {
		PathId
		Name        string `json:"name,optional" validate:"required,gte=2,lte=20" comment:"角色名, 不能超过20个字符"`
		Description string `json:"description,optional" comment:"描述, 不能超过60个字符"`
	}
	SetRolePermissionsReq {
		PathId
		Permissions []int `json:"permissions,optional" validate:"required"`
	}
	AddRoleUsersReq {
		PathId
		Users []int `json:"users,optional" validate:"required"`
	}
	DeleteRoleUserReq {
		PathId
		UserId int `path:"userId"`
	}
	QueryRolesReply {
		PageReply
		Data []RoleReply `json:"data"`
	}
	RoleReply {
		Id          int    `json:"id"`
		Name        string `json:"name" comment:"角色名, 不能超过20个字符"`
		Description string `json:"description" comment:"描述, 不能超过60个字符"`
		CreatedAt   int64  `json:"createdAt" comment:"创建时间"` // 创建时间
		UpdatedAt   int64  `json:"updatedAt" comment:"更新时间"` // 更新时间
	}
)

@server (
	jwt:    Auth
	group:  role
	prefix: /api/v1
)
service hougai-api {
	@doc "查询角色分页列表"
	@handler queryRoles
	get /roles (QueryRolesReq) returns (QueryRolesReply)

	@doc "创建角色"
	@handler createRole
	post /roles (CreateRoleReq) returns (int)

	@doc "编辑角色"
	@handler updateRole
	put /roles/:id (UpdateRoleReq)

	@doc "删除角色"
	@handler deleteRole
	delete /roles/:id (PathId)

	//////////////////////////////////////////////////
	@doc "设置角色权限"
	@handler setRolePermissions
	put /roles/:id/permissions (SetRolePermissionsReq)

	@doc "添加角色用户"
	@handler addRoleUsers
	post /roles/:id/users (AddRoleUsersReq)

	@doc "删除角色用户"
	@handler deleteRoleUser
	delete /roles/:id/users/:userId (DeleteRoleUserReq)
}