feat(recommend): 新增推荐请求 DTO RecommendCardDTO/RecommendRequest

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

mango-common/src/main/java/com/mangoo/rating/recommend/request/recommend/RecommendCardDTO.java

@@ -0,0 +1,40 @@
+package com.mangoo.rating.recommend.request.recommend;
+
+import io.swagger.annotations.ApiModel;
+import io.swagger.annotations.ApiModelProperty;
+import lombok.Data;
+
+import javax.validation.constraints.NotBlank;
+
+/**
+ * 单卡推荐入参（识别特征 + 透传字段）
+ *
+ * @author gengjintao
+ * @date 2026/06/24
+ */
+@Data
+@ApiModel("单卡推荐入参")
+public class RecommendCardDTO {
+
+    @ApiModelProperty(value = "前端临时卡标识（用于回指订单归属，仅透传不入库）", required = true)
+    @NotBlank(message = "clientCardId 不能为空")
+    private String clientCardId;
+
+    @ApiModelProperty(value = "球员")
+    private String player;
+
+    @ApiModelProperty(value = "年份")
+    private String year;
+
+    @ApiModelProperty(value = "系列")
+    private String series;
+
+    @ApiModelProperty(value = "卡种")
+    private String cardSet;
+
+    @ApiModelProperty(value = "正面图URL（仅透传回显）")
+    private String frontImageUrl;
+
+    @ApiModelProperty(value = "反面图URL（仅透传回显）")
+    private String backImageUrl;
+}

mango-common/src/main/java/com/mangoo/rating/recommend/request/recommend/RecommendRequest.java

@@ -0,0 +1,25 @@
+package com.mangoo.rating.recommend.request.recommend;
+
+import io.swagger.annotations.ApiModel;
+import io.swagger.annotations.ApiModelProperty;
+import lombok.Data;
+
+import javax.validation.Valid;
+import javax.validation.constraints.NotEmpty;
+import java.util.List;
+
+/**
+ * 评级时效推荐请求体（批量卡）
+ *
+ * @author gengjintao
+ * @date 2026/06/24
+ */
+@Data
+@ApiModel("评级时效推荐请求体")
+public class RecommendRequest {
+
+    @ApiModelProperty(value = "卡列表", required = true)
+    @NotEmpty(message = "卡列表不能为空")
+    @Valid
+    private List<RecommendCardDTO> cards;
+}