@Summary 创建菜单 @Description 获取JSON @Tags 菜单 @Accept application/x-www-form-urlencoded @Product application/x-www-form-urlencoded @Param menuName formData string true "menuName" @Param Path formData string false "Path" @Param Action formData string true "Action" @Param Permission formData string true "Permission" @Param ParentId formData string true "ParentId" @Param IsDel formData string true "IsDel" @Success 200 {string} string "{"code": 200, "message": "添加成功"}" @Success 200 {string} string "{"code": -1, "message": "添加失败"}" @Router /menu [post] @Security Bearer.

CreateRole godoc @Summary 创建角色 @Description 根据一个RoleName创建角色，RoleName 要求不能重复 @Tags role @ID role-create @Param role body formRole.CreateRoleRequest true "remark 可空" @Success 200 {object} formRole.CreateRoleResponse @Failure 500 {object} app.ErrResponse @Failure 400 {object} app.ErrResponse @Accept application/json @Produce json @Router /role [post] @Security BearerAuth.

@Summary 删除菜单 @Description 删除数据 @Tags 菜单 @Param id path int true "id" @Success 200 {string} string "{"code": 200, "message": "删除成功"}" @Success 200 {string} string "{"code": -1, "message": "删除失败"}" @Router /api/v1/menu/{id} [delete].

DeleteRole godoc @Summary 删除角色 @Description 删除角色，幂等操作 @Tags role @ID role-delete @Param role_id path string true "角色唯一id" @Success 200 {object} formRole.DeleteRoleResponse @Failure 500 {object} app.ErrResponse @Failure 400 {object} app.ErrResponse @Accept application/json @Produce json @Router /role/{role_id} [delete] @Security BearerAuth.

@Summary 删除用户菜单数据 @Description 删除数据 @Tags 角色菜单 @Param id path string true "id" @Param menu_id query string false "menu_id" @Success 200 {string} string "{"code": 200, "message": "删除成功"}" @Success 200 {string} string "{"code": -1, "message": "删除失败"}" @Router /api/v1/rolemenu/{id} [delete].

@Summary 获取菜单 @Description 根据id获取菜单信息 @Tags 菜单 @Param menuName query string false "menuName" @Success 200 {string} string "{"code": 200, "data": [...]}" @Success 200 {string} string "{"code": -1, "message": "抱歉未找到相关信息"}" @Router /api/v1/menu [get] @Security Bearer.

@Summary Menu列表数据 @Description 获取JSON @Tags 菜单 @Param menuName query string false "menuName" @Success 200 {string} string "{"code": 200, "data": [...]}" @Success 200 {string} string "{"code": -1, "message": "抱歉未找到相关信息"}" @Router /api/v1/menulist [get] @Security Bearer.

@Summary 获取菜单树 @Description 获取JSON @Tags 菜单 @Accept application/x-www-form-urlencoded @Product application/x-www-form-urlencoded @Success 200 {string} string "{"code": 200, "message": "添加成功"}" @Success 200 {string} string "{"code": -1, "message": "添加失败"}" @Router /api/v1/menuTreeselect [get] @Security Bearer.

GetRole godoc @Summary 查询角色 @Description 根据角色id查询角色信息 @Tags role @ID role-get @Param role_id path string true "角色id" @Success 200 {object} formRole.GetRoleResponse @Failure 500 {object} app.ErrResponse @Failure 400 {object} app.ErrResponse @Produce json @Router /role/{role_id} [get] @Security BearerAuth.

@Summary RoleMenu列表数据 @Description 获取JSON @Tags 角色菜单 @Param RoleId query string false "RoleId" @Success 200 {string} string "{"code": 200, "data": [...]}" @Success 200 {string} string "{"code": -1, "message": "抱歉未找到相关信息"}" @Router /api/v1/rolemenu [get] @Security Bearer.

ListRole godoc @Summary 查询角色列表 @Description 根据offset和limit查询角色列表 @Tags role @ID role-list @Param offset query int true "偏移" @Param limit query int true "限制" @Success 200 {object} formRole.ListRoleResponse @Failure 500 {object} app.ErrResponse @Failure 400 {object} app.ErrResponse @Produce json @Router /role [get] @Security BearerAuth.

@Summary 修改菜单 @Description 获取JSON @Tags 菜单 @Accept application/x-www-form-urlencoded @Product application/x-www-form-urlencoded @Param id path int true "id" @Param data body system.Menu true "body" @Success 200 {string} string "{"code": 200, "message": "修改成功"}" @Success 200 {string} string "{"code": -1, "message": "修改失败"}" @Router /api/v1/menu/{id} [put] @Security Bearer.

UpdateRole godoc @Summary 更新角色 @Description 更新角色信息 @Tags role @ID role-update @Param role body formRole.UpdateRoleRequest true "角色id" @Success 200 {object} formRole.UpdateRoleResponse @Failure 500 {object} app.ErrResponse @Failure 400 {object} app.ErrResponse @Accept application/json @Produce json @Router /role [put] @Security BearerAuth.