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"` // 角色编码列表 } )