docs(api): 同步 API 文档与实际实现一致

README.md:
- 开发环境端口 8080 → 8085
- 统一响应格式添加 trace_id 字段
- 成功消息 "ok" → "success",创建 "created"

frontend/auth.md(全面更新):
- 注册响应:201 状态码 + message="created" + expires_in=7200
- 所有响应示例:添加 trace_id 和 time 字段
- user 对象:添加 gender 字段
- 退出登录:更新为无状态 JWT 说明(非 Redis)
- 刷新 Token:添加 user 字段到响应
- profile:添加 phone + created_at 字段
- 错误码:统一使用 HTTP 状态码说明表

代码同步:
- dto.UserInfo: 添加 Phone + CreatedAt 字段
- auth_service.buildUserInfo: 填充新字段

Made-with: Cursor
This commit is contained in:
bujinyuan
2026-02-28 16:48:17 +08:00
parent d975adaf2a
commit 5a65716d10
4 changed files with 157 additions and 48 deletions

View File

@@ -25,13 +25,15 @@ type LoginResponse struct {
// UserInfo 用户基本信息(用于响应返回,不含敏感字段)
type UserInfo struct {
ID int64 `json:"id"` // 用户 ID
Username string `json:"username"` // 用户名
Email string `json:"email"` // 邮箱
Nickname string `json:"nickname"` // 昵称
Avatar string `json:"avatar"` // 头像 URL
Gender int `json:"gender"` // 性别0=未知, 1=男, 2=女
Roles []string `json:"roles"` // 角色代码列表
ID int64 `json:"id"` // 用户 ID
Username string `json:"username"` // 用户名
Email string `json:"email"` // 邮箱
Nickname string `json:"nickname"` // 昵称
Avatar string `json:"avatar"` // 头像 URL
Gender int `json:"gender"` // 性别0=未知, 1=男, 2=女
Phone string `json:"phone,omitempty"` // 手机号(可能为空)
Roles []string `json:"roles"` // 角色代码列表
CreatedAt string `json:"created_at,omitempty"` // 注册时间格式yyyy-MM-dd HH:mm:ss
}
// RefreshTokenRequest 刷新 Token 请求参数