chore: document v1 dto fields

backend/app/http/v1/dto/tenant.go

@@ -3,25 +3,40 @@ package dto
 import "quyun/v2/app/requests"
 
 type TenantListFilter struct {
+	// Pagination 分页参数（page/limit）。
 	requests.Pagination
+	// Keyword 关键词搜索（租户名称）。
 	Keyword *string `query:"keyword"`
-	Sort    *string `query:"sort"`
+	// Sort 排序规则。
+	Sort *string `query:"sort"`
 }
 
 type TenantProfile struct {
-	ID          int64  `json:"id"`
-	Name        string `json:"name"`
-	Avatar      string `json:"avatar"`
-	Cover       string `json:"cover"`
-	Bio         string `json:"bio"`
+	// ID 租户ID。
+	ID int64 `json:"id"`
+	// Name 租户名称。
+	Name string `json:"name"`
+	// Avatar 头像URL。
+	Avatar string `json:"avatar"`
+	// Cover 封面图URL。
+	Cover string `json:"cover"`
+	// Bio 简短简介。
+	Bio string `json:"bio"`
+	// Description 详细描述。
 	Description string `json:"description"`
-	CertType    string `json:"cert_type"` // personal, enterprise
-	Stats       Stats  `json:"stats"`
-	IsFollowing bool   `json:"is_following"`
+	// CertType 认证类型（personal/enterprise）。
+	CertType string `json:"cert_type"`
+	// Stats 统计信息。
+	Stats Stats `json:"stats"`
+	// IsFollowing 当前用户是否关注。
+	IsFollowing bool `json:"is_following"`
 }
 
 type Stats struct {
+	// Followers 粉丝数。
 	Followers int `json:"followers"`
-	Contents  int `json:"contents"`
-	Likes     int `json:"likes"`
+	// Contents 内容数。
+	Contents int `json:"contents"`
+	// Likes 累计点赞数。
+	Likes int `json:"likes"`
 }