chore: document v1 dto fields

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

@@ -1,14 +1,24 @@
 package dto
 
 type UserCouponItem struct {
-	ID             int64  `json:"id"`
-	CouponID       int64  `json:"coupon_id"`
-	Title          string `json:"title"`
-	Description    string `json:"description"`
-	Type           string `json:"type"`
-	Value          int64  `json:"value"`
-	MinOrderAmount int64  `json:"min_order_amount"`
-	StartAt        string `json:"start_at"`
-	EndAt          string `json:"end_at"`
-	Status         string `json:"status"`
+	// ID 用户券ID。
+	ID int64 `json:"id"`
+	// CouponID 券模板ID。
+	CouponID int64 `json:"coupon_id"`
+	// Title 券标题。
+	Title string `json:"title"`
+	// Description 券描述。
+	Description string `json:"description"`
+	// Type 券类型（满减/折扣）。
+	Type string `json:"type"`
+	// Value 券面值（分/百分比）。
+	Value int64 `json:"value"`
+	// MinOrderAmount 使用门槛金额（分）。
+	MinOrderAmount int64 `json:"min_order_amount"`
+	// StartAt 生效时间（RFC3339）。
+	StartAt string `json:"start_at"`
+	// EndAt 过期时间（RFC3339）。
+	EndAt string `json:"end_at"`
+	// Status 当前状态（可用/已用/过期）。
+	Status string `json:"status"`
 }