first commit

2025-06-19 17:12:48 +08:00
commit 1edbd79e4c
506 changed files with 52853 additions and 0 deletions
--- a/app/main/api/desc/admin/admin_user.api
+++ b/app/main/api/desc/admin/admin_user.api
@@ -0,0 +1,131 @@
+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"`     // 角色编码列表
+	}
+)