feat: 资产解析接口新增实名时间字段

- AssetResolveResponse 新增 real_name_at 字段：card 类型取 first_realname_at，device 类型取绑定卡中最小的实名时间
- BoundCardInfo 新增 real_name_at 字段：各卡自己的 first_realname_at
- RefreshCardDataFromGateway 手动刷新路径补写实名时间：检测到 0→1 变化时同步写入 first_realname_at
- 同步更新 asset-resolve 规格文档

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

internal/model/dto/asset_dto.go

@@ -20,7 +20,8 @@ type AssetResolveResponse struct {
 	CreatedAt           time.Time  `json:"created_at" description:"创建时间"`
 	UpdatedAt           time.Time  `json:"updated_at" description:"更新时间"`
 	// 状态聚合字段
-	RealNameStatus      int     `json:"real_name_status" description:"实名状态：0未实名 1已实名"`
+	RealNameStatus      int        `json:"real_name_status" description:"实名状态：0未实名 1已实名"`
+	RealNameAt          *time.Time `json:"real_name_at" description:"最近一次完成实名的时间，未实名时为 null"`
 	CurrentPackage      string  `json:"current_package" description:"当前套餐名称（无套餐时为空）"`
 	PackageTotalMB      int64   `json:"package_total_mb" description:"当前套餐总虚流量(MB)，已按virtual_ratio换算"`
 	PackageUsedMB       float64 `json:"package_used_mb" description:"当前已用虚流量(MB)，已按virtual_ratio换算"`
@@ -62,13 +63,14 @@ type AssetResolveResponse struct {
 
 // BoundCardInfo 设备绑定的卡信息
 type BoundCardInfo struct {
-	CardID         uint   `json:"card_id" description:"卡ID"`
-	ICCID          string `json:"iccid" description:"ICCID"`
-	MSISDN         string `json:"msisdn,omitempty" description:"手机号"`
-	NetworkStatus  int    `json:"network_status" description:"网络状态：0停机 1开机"`
-	RealNameStatus int    `json:"real_name_status" description:"实名状态：0未实名 1已实名"`
-	SlotPosition   int    `json:"slot_position,omitempty" description:"插槽位置"`
-	IsCurrent      bool   `json:"is_current" description:"是否为当前使用的卡"`
+	CardID         uint       `json:"card_id" description:"卡ID"`
+	ICCID          string     `json:"iccid" description:"ICCID"`
+	MSISDN         string     `json:"msisdn,omitempty" description:"手机号"`
+	NetworkStatus  int        `json:"network_status" description:"网络状态：0停机 1开机"`
+	RealNameStatus int        `json:"real_name_status" description:"实名状态：0未实名 1已实名"`
+	RealNameAt     *time.Time `json:"real_name_at" description:"该卡最近一次完成实名的时间，未实名时为 null"`
+	SlotPosition   int        `json:"slot_position,omitempty" description:"插槽位置"`
+	IsCurrent      bool       `json:"is_current" description:"是否为当前使用的卡"`
 }
 
 // AssetRealtimeStatusResponse 资产实时状态（只读DB/Redis）

internal/service/asset/service.go

@@ -191,10 +191,24 @@ func (s *Service) buildDeviceResolveResponse(ctx context.Context, device *model.
 				MSISDN:         c.MSISDN,
 				NetworkStatus:  c.NetworkStatus,
 				RealNameStatus: c.RealNameStatus,
+				RealNameAt:     c.FirstRealnameAt,
 				SlotPosition:   slotMap[c.ID],
 				IsCurrent:      isCurrentMap[c.ID],
 			})
 		}
+
+		// 聚合设备级 RealNameAt：取所有绑定卡 FirstRealnameAt 中的最小值（跳过 nil）
+		var minRealNameAt *time.Time
+		for _, c := range cards {
+			if c.FirstRealnameAt == nil {
+				continue
+			}
+			if minRealNameAt == nil || c.FirstRealnameAt.Before(*minRealNameAt) {
+				t := *c.FirstRealnameAt
+				minRealNameAt = &t
+			}
+		}
+		resp.RealNameAt = minRealNameAt
 	}
 
 	// 查当前主套餐
@@ -228,6 +242,7 @@ func (s *Service) buildCardResolveResponse(ctx context.Context, card *model.IotC
 		CreatedAt:           card.CreatedAt,
 		UpdatedAt:           card.UpdatedAt,
 		RealNameStatus:      card.RealNameStatus,
+		RealNameAt:          card.FirstRealnameAt,
 		NetworkStatus:       card.NetworkStatus,
 		ICCID:               card.ICCID,
 		CarrierID:           card.CarrierID,

internal/service/iot_card/service.go

@@ -853,6 +853,10 @@ func (s *Service) RefreshCardDataFromGateway(ctx context.Context, iccid string)
 		} else {
 			realNameStatus := parseGatewayRealnameStatus(realnameResp.RealStatus)
 			updates["real_name_status"] = realNameStatus
+			// 检测 0→1 变化：旧状态非已实名且新状态为已实名，补写 first_realname_at
+			if card.RealNameStatus != constants.RealNameStatusVerified && realNameStatus == constants.RealNameStatusVerified {
+				updates["first_realname_at"] = syncTime
+			}
 		}
 
 		// 3. 查询本月流量用量 — 使用增量计算（与轮询 calculateFlowUpdates 逻辑一致）