11

pjcloud-hardware/pjcloud-hardware-api/src/main/java/com/bsd/pjcloud/hard/api/vo/order/HardCanteenUserApptDishStatisticsVo.java

@@ -7,7 +7,9 @@ import java.util.ArrayList;
 import java.util.List;
 
 /**
- * 用户预约按餐段和菜品快照聚合的统计数据。
+ * 用户预约按餐段、商品 ID 和下单菜品名称快照聚合的统计数据。
+ *
+ * <p>商品 ID 相同但名称快照不同的历史订单会拆分展示，避免商品 ID 被菜谱复用后串入错误名称。</p>
  */
 @Data
 @Schema(description = "食堂用户预约菜品统计")
@@ -21,7 +23,7 @@ public class HardCanteenUserApptDishStatisticsVo {
     @Schema(description = "菜品名称")
     private String productName;
 
-    /** 当前菜品统计项实际涉及的商品 ID；正常数据仅有一个，历史商品 ID 为空时不写入集合。 */
+    /** 当前名称快照统计项实际涉及的商品 ID；正常数据仅有一个，历史商品 ID 为空时不写入集合。 */
     @Schema(description = "商品ID集合")
     private List<Long> productIds = new ArrayList<>();
 

pjcloud-hardware/pjcloud-hardware-api/src/main/java/com/bsd/pjcloud/hard/api/vo/order/HardCanteenUserApptStatisticsSummaryVo.java

@@ -47,7 +47,7 @@ public class HardCanteenUserApptStatisticsSummaryVo {
     @Schema(description = "餐段统计")
     private List<HardCanteenUserApptMealStatisticsVo> meals = new ArrayList<>();
 
-    /** 按餐段和商品 ID 聚合的菜品份数；历史商品 ID 缺失时按菜品名称兜底。 */
+    /** 按餐段、商品 ID 和下单名称快照聚合的菜品份数；历史商品 ID 缺失时按菜品名称兜底。 */
     @Schema(description = "菜品统计")
     private List<HardCanteenUserApptDishStatisticsVo> dishes = new ArrayList<>();
 }