first commit

2025-08-16 18:46:29 +08:00
commit 5f008b3228
511 changed files with 53667 additions and 0 deletions
--- a/app/main/api/desc/admin/platform_user.api
+++ b/app/main/api/desc/admin/platform_user.api
@@ -0,0 +1,124 @@
+syntax = "v1"
+
+info (
+	title:   "平台用户管理"
+	desc:    "平台用户管理"
+	author:  "Liangzai"
+	email:   "2440983361@qq.com"
+	version: "v1"
+)
+
+// 平台用户管理接口
+@server(
+	prefix: /api/v1/admin/platform_user
+	group: admin_platform_user
+	jwt: JwtAuth
+)
+service main {
+	// 创建平台用户
+	@handler AdminCreatePlatformUser
+	post /create (AdminCreatePlatformUserReq) returns (AdminCreatePlatformUserResp)
+
+	// 更新平台用户
+	@handler AdminUpdatePlatformUser
+	put /update/:id (AdminUpdatePlatformUserReq) returns (AdminUpdatePlatformUserResp)
+
+	// 删除平台用户
+	@handler AdminDeletePlatformUser
+	delete /delete/:id (AdminDeletePlatformUserReq) returns (AdminDeletePlatformUserResp)
+
+	// 获取平台用户分页列表
+	@handler AdminGetPlatformUserList
+	get /list (AdminGetPlatformUserListReq) returns (AdminGetPlatformUserListResp)
+
+	// 获取平台用户详情
+	@handler AdminGetPlatformUserDetail
+	get /detail/:id (AdminGetPlatformUserDetailReq) returns (AdminGetPlatformUserDetailResp)
+}
+
+type (
+	// 分页列表请求
+	AdminGetPlatformUserListReq {
+		Page            int64  `form:"page,default=1"`             // 页码
+		PageSize        int64  `form:"pageSize,default=20"`        // 每页数量
+		Mobile          string `form:"mobile,optional"`            // 手机号
+		Nickname        string `form:"nickname,optional"`          // 昵称
+		Inside          int64  `form:"inside,optional"`            // 是否内部用户 1-是 0-否
+		CreateTimeStart string `form:"create_time_start,optional"` // 创建时间开始
+		CreateTimeEnd   string `form:"create_time_end,optional"`   // 创建时间结束
+		OrderBy         string `form:"order_by,optional"`          // 排序字段
+		OrderType       string `form:"order_type,optional"`        // 排序类型
+	}
+
+	// 分页列表响应
+	AdminGetPlatformUserListResp {
+		Total int64                  `json:"total"` // 总数
+		Items []PlatformUserListItem `json:"items"` // 列表
+	}
+
+	// 列表项
+	PlatformUserListItem {
+		Id         int64  `json:"id"`          // 用户ID
+		Mobile     string `json:"mobile"`      // 手机号
+		Nickname   string `json:"nickname"`    // 昵称
+		Info       string `json:"info"`        // 备注信息
+		Inside     int64  `json:"inside"`      // 是否内部用户 1-是 0-否
+		CreateTime string `json:"create_time"` // 创建时间
+		UpdateTime string `json:"update_time"` // 更新时间
+	}
+
+	// 详情请求
+	AdminGetPlatformUserDetailReq {
+		Id int64 `path:"id"` // 用户ID
+	}
+
+	// 详情响应
+	AdminGetPlatformUserDetailResp {
+		Id         int64  `json:"id"`          // 用户ID
+		Mobile     string `json:"mobile"`      // 手机号
+		Nickname   string `json:"nickname"`    // 昵称
+		Info       string `json:"info"`        // 备注信息
+		Inside     int64  `json:"inside"`      // 是否内部用户 1-是 0-否
+		CreateTime string `json:"create_time"` // 创建时间
+		UpdateTime string `json:"update_time"` // 更新时间
+	}
+
+	// 创建请求
+	AdminCreatePlatformUserReq {
+		Mobile   string `json:"mobile"`   // 手机号
+		Password string `json:"password"` // 密码
+		Nickname string `json:"nickname"` // 昵称
+		Info     string `json:"info"`     // 备注信息
+		Inside   int64  `json:"inside"`   // 是否内部用户 1-是 0-否
+	}
+
+	// 创建响应
+	AdminCreatePlatformUserResp {
+		Id int64 `json:"id"` // 用户ID
+	}
+
+	// 更新请求
+	AdminUpdatePlatformUserReq {
+		Id       int64   `path:"id"`                // 用户ID
+		Mobile   *string `json:"mobile,optional"`   // 手机号
+		Password *string `json:"password,optional"` // 密码
+		Nickname *string `json:"nickname,optional"` // 昵称
+		Info     *string `json:"info,optional"`     // 备注信息
+		Inside   *int64  `json:"inside,optional"`   // 是否内部用户 1-是 0-否
+	}
+
+	// 更新响应
+	AdminUpdatePlatformUserResp {
+		Success bool `json:"success"` // 是否成功
+	}
+
+	// 删除请求
+	AdminDeletePlatformUserReq {
+		Id int64 `path:"id"` // 用户ID
+	}
+
+	// 删除响应
+	AdminDeletePlatformUserResp {
+		Success bool `json:"success"` // 是否成功
+	}
+)