131 lines
3.7 KiB
Plaintext
131 lines
3.7 KiB
Plaintext
|
syntax = "v1"
|
|||
|
|
|
|||
|
|
info (
|
|||
|
|
title: "后台用户中心服务"
|
|||
|
|
desc: "后台用户中心服务"
|
|||
|
|
author: "Liangzai"
|
|||
|
|
email: "2440983361@qq.com"
|
|||
|
|
version: "v1"
|
|||
|
|
)
|
|||
|
|
|
|||
|
|
@server (
|
|||
|
|
prefix: api/v1/admin/user
|
|||
|
|
group: admin_user
|
|||
|
|
jwt: JwtAuth
|
|||
|
|
)
|
|||
|
|
service main {
|
|||
|
|
@doc "获取用户列表"
|
|||
|
|
@handler AdminGetUserList
|
|||
|
|
get /list (AdminGetUserListReq) returns (AdminGetUserListResp)
|
|||
|
|
|
|||
|
|
@doc "获取用户详情"
|
|||
|
|
@handler AdminGetUserDetail
|
|||
|
|
get /detail/:id (AdminGetUserDetailReq) returns (AdminGetUserDetailResp)
|
|||
|
|
|
|||
|
|
@doc "创建用户"
|
|||
|
|
@handler AdminCreateUser
|
|||
|
|
post /create (AdminCreateUserReq) returns (AdminCreateUserResp)
|
|||
|
|
|
|||
|
|
@doc "更新用户"
|
|||
|
|
@handler AdminUpdateUser
|
|||
|
|
put /update/:id (AdminUpdateUserReq) returns (AdminUpdateUserResp)
|
|||
|
|
|
|||
|
|
@doc "删除用户"
|
|||
|
|
@handler AdminDeleteUser
|
|||
|
|
delete /delete/:id (AdminDeleteUserReq) returns (AdminDeleteUserResp)
|
|||
|
|
|
|||
|
|
@doc "用户信息"
|
|||
|
|
@handler AdminUserInfo
|
|||
|
|
get /info (AdminUserInfoReq) returns (AdminUserInfoResp)
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
type (
|
|||
|
|
// 列表请求
|
|||
|
|
AdminGetUserListReq {
|
|||
|
|
Page int64 `form:"page,default=1"` // 页码
|
|||
|
|
PageSize int64 `form:"pageSize,default=20"` // 每页数量
|
|||
|
|
Username string `form:"username,optional"` // 用户名
|
|||
|
|
RealName string `form:"real_name,optional"` // 真实姓名
|
|||
|
|
Status int64 `form:"status,optional,default=-1"` // 状态：0-禁用，1-启用
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
// 列表响应
|
|||
|
|
AdminGetUserListResp {
|
|||
|
|
Total int64 `json:"total"` // 总数
|
|||
|
|
Items []AdminUserListItem `json:"items"` // 列表
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
// 列表项
|
|||
|
|
AdminUserListItem {
|
|||
|
|
Id int64 `json:"id"` // 用户ID
|
|||
|
|
Username string `json:"username"` // 用户名
|
|||
|
|
RealName string `json:"real_name"` // 真实姓名
|
|||
|
|
Status int64 `json:"status"` // 状态：0-禁用，1-启用
|
|||
|
|
CreateTime string `json:"create_time"` // 创建时间
|
|||
|
|
RoleIds []int64 `json:"role_ids"` // 关联的角色ID列表
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
// 详情请求
|
|||
|
|
AdminGetUserDetailReq {
|
|||
|
|
Id int64 `path:"id"` // 用户ID
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
// 详情响应
|
|||
|
|
AdminGetUserDetailResp {
|
|||
|
|
Id int64 `json:"id"` // 用户ID
|
|||
|
|
Username string `json:"username"` // 用户名
|
|||
|
|
RealName string `json:"real_name"` // 真实姓名
|
|||
|
|
Status int64 `json:"status"` // 状态：0-禁用，1-启用
|
|||
|
|
CreateTime string `json:"create_time"` // 创建时间
|
|||
|
|
UpdateTime string `json:"update_time"` // 更新时间
|
|||
|
|
RoleIds []int64 `json:"role_ids"` // 关联的角色ID列表
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
// 创建请求
|
|||
|
|
AdminCreateUserReq {
|
|||
|
|
Username string `json:"username"` // 用户名
|
|||
|
|
RealName string `json:"real_name"` // 真实姓名
|
|||
|
|
Status int64 `json:"status,default=1"` // 状态：0-禁用，1-启用
|
|||
|
|
RoleIds []int64 `json:"role_ids"` // 关联的角色ID列表
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
// 创建响应
|
|||
|
|
AdminCreateUserResp {
|
|||
|
|
Id int64 `json:"id"` // 用户ID
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
// 更新请求
|
|||
|
|
AdminUpdateUserReq {
|
|||
|
|
Id int64 `path:"id"` // 用户ID
|
|||
|
|
Username *string `json:"username,optional"` // 用户名
|
|||
|
|
RealName *string `json:"real_name,optional"` // 真实姓名
|
|||
|
|
Status *int64 `json:"status,optional"` // 状态：0-禁用，1-启用
|
|||
|
|
RoleIds []int64 `json:"role_ids,optional"` // 关联的角色ID列表
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
// 更新响应
|
|||
|
|
AdminUpdateUserResp {
|
|||
|
|
Success bool `json:"success"` // 是否成功
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
// 删除请求
|
|||
|
|
AdminDeleteUserReq {
|
|||
|
|
Id int64 `path:"id"` // 用户ID
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
// 删除响应
|
|||
|
|
AdminDeleteUserResp {
|
|||
|
|
Success bool `json:"success"` // 是否成功
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
// 用户信息请求
|
|||
|
|
AdminUserInfoReq {
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
// 用户信息响应
|
|||
|
|
AdminUserInfoResp {
|
|||
|
|
Username string `json:"username"` // 用户名
|
|||
|
|
RealName string `json:"real_name"` // 真实姓名
|
|||
|
|
Roles []string `json:"roles"` // 角色编码列表
|
|||
|
|
}
|
|||
|
|
)
|