chore: add dto field comments

This commit is contained in:
2026-01-09 15:03:19 +08:00
parent 6c1bc35bf5
commit cf92e0bd89
4 changed files with 307 additions and 141 deletions

View File

@@ -3,30 +3,47 @@ package dto
import "quyun/v2/pkg/consts"
type LoginForm struct {
// Username 登录用户名。
Username string `json:"username"`
// Password 登录密码(加密传输)。
Password string `json:"password"`
}
type LoginResponse struct {
// Token 登录后签发的 JWT。
Token string `json:"token"`
User *User `json:"user"`
// User 当前登录用户信息。
User *User `json:"user"`
}
type User struct {
ID int64 `json:"id"`
Phone string `json:"phone"`
Nickname string `json:"nickname"`
Avatar string `json:"avatar"`
Gender consts.Gender `json:"gender"`
Bio string `json:"bio"`
Birthday string `json:"birthday"` // YYYY-MM-DD
Location *Location `json:"location"`
Balance float64 `json:"balance"`
Points int64 `json:"points"`
IsRealNameVerified bool `json:"is_real_name_verified"`
// ID 用户ID。
ID int64 `json:"id"`
// Phone 手机号。
Phone string `json:"phone"`
// Nickname 用户昵称。
Nickname string `json:"nickname"`
// Avatar 头像URL。
Avatar string `json:"avatar"`
// Gender 性别male/female/secret
Gender consts.Gender `json:"gender"`
// Bio 用户简介。
Bio string `json:"bio"`
// Birthday 生日YYYY-MM-DD
Birthday string `json:"birthday"` // YYYY-MM-DD
// Location 所在地(省/市)。
Location *Location `json:"location"`
// Balance 账户余额(元)。
Balance float64 `json:"balance"`
// Points 用户积分。
Points int64 `json:"points"`
// IsRealNameVerified 是否已实名认证。
IsRealNameVerified bool `json:"is_real_name_verified"`
}
type Location struct {
// Province 省份名称。
Province string `json:"province"`
City string `json:"city"`
// City 城市名称。
City string `json:"city"`
}