feat:餐段购买统计日期

pjcloud-hardware/pjcloud-hardware-api/src/main/java/com/bsd/pjcloud/hard/api/constant/order/HardCanteenReservationDateBasisEnum.java

@@ -0,0 +1,14 @@
+package com.bsd.pjcloud.hard.api.constant.order;
+
+/**
+ * 食堂销售统计中已核销预约的日期归属口径，仅用于查询协议，不持久化到订单表。
+ * 线下购买始终按支付时间统计，不受此枚举影响。
+ */
+public enum HardCanteenReservationDateBasisEnum {
+
+    /** 按实际核销时间统计；未传口径或显式传空时沿用此历史行为。 */
+    VERIFICATION_TIME,
+
+    /** 仅保留已核销订单，按预约用餐日期统计；预约日期为空时不计入。 */
+    APPT_USE_DATE
+}

pjcloud-hardware/pjcloud-hardware-api/src/main/java/com/bsd/pjcloud/hard/api/constant/order/HardSaleSourceEnum.java

@@ -16,7 +16,7 @@ public enum HardSaleSourceEnum {
     /** 订单类型 1 的线下购买，统计时间取订单支付时间。 */
     OFFLINE_PURCHASE("OFFLINE_PURCHASE", "线下购买"),
 
-    /** 订单类型 2 且已完成核销的预约，统计时间取订单核销时间。 */
+    /** 订单类型 2 且已完成核销的预约；默认按核销时间统计，也可由查询口径指定预约用餐日期。 */
     RESERVATION_VERIFIED("RESERVATION_VERIFIED", "预约核销");
 
     /** 统计接口和前端标签页使用的来源编码。 */

pjcloud-hardware/pjcloud-hardware-api/src/main/java/com/bsd/pjcloud/hard/api/dto/order/HardCarDto.java

@@ -2,6 +2,7 @@ package com.bsd.pjcloud.hard.api.dto.order;
 
 import com.bsd.pjcloud.admin.api.vo.base.BaseIsDeepDeptTreeInterface;
 import com.bsd.pjcloud.admin.api.vo.base.BaseIsIncludeTreeInterface;
+import com.bsd.pjcloud.hard.api.constant.order.HardCanteenReservationDateBasisEnum;
 import com.bsd.pjcloud.hard.api.entity.order.HardCarEntity;
 import lombok.Data;
 
@@ -37,9 +38,12 @@ public class HardCarDto extends HardCarEntity implements BaseIsIncludeTreeInterf
     /** 预计使用日期范围。 */
     private LocalDateTime[] apptUseDateTimeList;
 
-    /** 菜品销售统计日期范围，线下按支付时间、预约按核销时间过滤；不落库。 */
+    /** 菜品销售统计日期闭区间，线下按支付时间、已核销预约按 reservationDateBasis 选择的日期过滤，不落库。 */
     private LocalDateTime[] statisticsDateTimeList;
 
+    /** 已核销预约的统计日期归属；默认或空值按核销时间，APPT_USE_DATE 按预约用餐日期，不落库。 */
+    private HardCanteenReservationDateBasisEnum reservationDateBasis = HardCanteenReservationDateBasisEnum.VERIFICATION_TIME;
+
     /** 菜品销售统计来源编码集合，取值来自 HardSaleSourceEnum；为空表示全部来源。 */
     private List<String> saleSourceCodes;
 

pjcloud-hardware/pjcloud-hardware-api/src/main/java/com/bsd/pjcloud/hard/api/dto/order/HardOrderDto.java

@@ -5,6 +5,7 @@ import com.bsd.pjcloud.admin.api.vo.base.BaseUserIdentityQueryInterface;
 import com.bsd.pjcloud.admin.api.dto.user.SysUserStudentDto;
 import com.bsd.pjcloud.admin.api.dto.user.SysUserTeacherDto;
 import com.bsd.pjcloud.common.core.constant.enums.DateRangeTypeEnum;
+import com.bsd.pjcloud.hard.api.constant.order.HardCanteenReservationDateBasisEnum;
 import com.bsd.pjcloud.hard.api.entity.order.HardOrderEntity;
 import lombok.Data;
 
@@ -54,10 +55,13 @@ public class HardOrderDto extends HardOrderEntity implements BaseIsIncludeTreeIn
     private LocalDateTime[] payTimeList;
 
     /**
-     * 食堂销售统计日期范围，线下来源按支付时间、预约来源按核销时间过滤；不落库。
+     * 食堂销售统计日期闭区间；线下按支付时间，已核销预约按 reservationDateBasis 选择的日期过滤，不落库。
      */
     private LocalDateTime[] statisticsDateTimeList;
 
+    /** 已核销预约的统计日期归属；默认或空值按核销时间，APPT_USE_DATE 按预约用餐日期，不落库。 */
+    private HardCanteenReservationDateBasisEnum reservationDateBasis = HardCanteenReservationDateBasisEnum.VERIFICATION_TIME;
+
     /**
      * 食堂销售统计来源编码集合，取值来自 HardSaleSourceEnum；为空表示同时查询两种来源。
      */