feat:钱包的流水增加"备注字段"

fix:合并设备管理的统计模块

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

@@ -56,6 +56,11 @@ public class HardOrderDto extends HardOrderEntity implements BaseIsIncludeTreeIn
      */
     private List<String> saleSourceCodes;
 
+    /**
+     * 商品名称模糊查询条件，仅供购物车商品统计 SQL 筛选使用，不对应订单表持久化字段。
+     */
+    private String productName;
+
     private LocalDateTime[] refundTimeList;
 
     /** 预计使用日期范围。 */

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

@@ -3,23 +3,27 @@ package com.bsd.pjcloud.hard.api.vo.order;
 import lombok.Data;
 
 /**
- * 食堂预约菜品导出聚合记录。
+ * 食堂菜品销售三级导出的聚合记录。
  *
- * <p>同一模型承载商户部门聚合和商品聚合两种查询结果，商品聚合时额外填充商品字段；金额统一使用分。</p>
+ * <p>同一模型承载日期餐段、商户部门和商品三种聚合查询结果，商品聚合时额外填充商品字段；
+ * 统计时间已按销售来源统一转换为业务发生日期，金额统一使用分。</p>
  */
 @Data
 public class HardCanteenProductApptExportRecord {
 
-    /** 预约使用日期，格式为 yyyy-MM-dd。 */
-    private String apptDate;
+    /** 业务发生日期，格式为 yyyy-MM-dd；线下取支付日期，预约取核销日期。 */
+    private String statisticsDate;
 
     /** 用餐时间段协议编码。 */
     private String hourType;
 
+    /** 销售来源协议编码；为空表示当前筛选范围内的跨来源合计。 */
+    private String saleSource;
+
     /** 食堂商户主键。 */
     private Long merchantId;
 
-    /** 预约用户所属部门主键。 */
+    /** 购买用户所属部门主键。 */
     private Long userDeptId;
 
     /** 商品主键；商户部门聚合记录为空。 */
@@ -28,15 +32,15 @@ public class HardCanteenProductApptExportRecord {
     /** 订单快照中的商品名称；商户部门聚合记录为空。 */
     private String productName;
 
-    /** 去重预约人数。 */
+    /** 当前统计层级内去重后的交易人数。 */
     private Long payUserCount;
 
-    /** 去重预约次数。 */
+    /** 当前统计层级内去重后的订单数量。 */
     private Long timeCount;
 
-    /** 预约商品总数量。 */
+    /** 有效商品总数量，预约来源已扣减退款完成数量。 */
     private Long payCount;
 
-    /** 预约商品总价，单位为分。 */
+    /** 有效商品总价，单位为分；预约来源已扣减退款完成金额。 */
     private Long totalPrice;
 }

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

@@ -9,32 +9,36 @@ import java.math.BigDecimal;
 import java.time.LocalDate;
 
 /**
- * 食堂预约菜品统计自定义导出行。
+ * 食堂菜品销售统计自定义导出行。
  *
- * <p>一组日期和餐段按汇总行、商户部门行、商品明细行组织；商品统计在同一商户部门块内按名称合并套餐展开后的明细，
- * 不同层级只填写所属列，配合自定义合并处理器形成树形报表。</p>
+ * <p>一个日期、餐段和来源口径按汇总行、商户部门行、商品明细行组织；来源口径包含筛选范围合计及各销售来源。
+ * 商品统计在同一商户部门块内按名称合并套餐展开后的明细，不同层级只填写所属列，配合自定义合并处理器形成树形报表。</p>
  */
 @Data
 public class HardCanteenProductApptExcelVo {
 
-    /** 日期餐段汇总中的预约日期。 */
-    @ExcelProperty({"日期餐段汇总", "预约时间"})
+    /** 日期餐段汇总中的业务发生日期。 */
+    @ExcelProperty({"日期餐段汇总", "统计日期"})
     private LocalDate summaryDate;
 
     /** 日期餐段汇总中的餐段编码或字典名称。 */
-    @ExcelProperty({"日期餐段汇总", "预约时间段"})
+    @ExcelProperty({"日期餐段汇总", "餐段"})
     private String summaryHourType;
 
-    /** 日期餐段汇总中的去重预约人数。 */
-    @ExcelProperty({"日期餐段汇总", "预约人数"})
+    /** 日期餐段汇总的来源口径，取值为筛选范围合计、线下购买或预约核销。 */
+    @ExcelProperty({"日期餐段汇总", "来源口径"})
+    private String summarySaleSourceName;
+
+    /** 日期餐段汇总中的去重交易人数。 */
+    @ExcelProperty({"日期餐段汇总", "交易人数"})
     private Long summaryPayUserCount;
 
-    /** 日期餐段汇总中的预约次数。 */
-    @ExcelProperty({"日期餐段汇总", "预约次数"})
+    /** 日期餐段汇总中的交易次数。 */
+    @ExcelProperty({"日期餐段汇总", "交易次数"})
     private Long summaryTimeCount;
 
     /** 日期餐段汇总中的商品总数量。 */
-    @ExcelProperty({"日期餐段汇总", "预约商品数量"})
+    @ExcelProperty({"日期餐段汇总", "商品数量"})
     private Long summaryPayCount;
 
     /** 日期餐段汇总中的总价，单位为元。 */
@@ -50,24 +54,24 @@ public class HardCanteenProductApptExcelVo {
     @ExcelProperty({"商户部门统计", "部门"})
     private String departmentName;
 
-    /** 商户部门统计中的预约日期。 */
-    @ExcelProperty({"商户部门统计", "预约时间"})
+    /** 商户部门统计中的业务发生日期。 */
+    @ExcelProperty({"商户部门统计", "统计日期"})
     private LocalDate merchantDate;
 
     /** 商户部门统计中的餐段名称。 */
-    @ExcelProperty({"商户部门统计", "预约时间段"})
+    @ExcelProperty({"商户部门统计", "餐段"})
     private String merchantHourType;
 
-    /** 商户部门统计中的去重预约人数。 */
-    @ExcelProperty({"商户部门统计", "预约人数"})
+    /** 商户部门统计中的去重交易人数。 */
+    @ExcelProperty({"商户部门统计", "交易人数"})
     private Long merchantPayUserCount;
 
-    /** 商户部门统计中的预约次数。 */
-    @ExcelProperty({"商户部门统计", "预约次数"})
+    /** 商户部门统计中的交易次数。 */
+    @ExcelProperty({"商户部门统计", "交易次数"})
     private Long merchantTimeCount;
 
-    /** 商户部门统计中的商品总数量。 */
-    @ExcelProperty({"商户部门统计", "预约商品数量"})
+    /** 商户部门统计中的有效商品总数量。 */
+    @ExcelProperty({"商户部门统计", "商品数量"})
     private Long merchantPayCount;
 
     /** 商户部门统计中的总价，单位为元。 */
@@ -92,7 +96,7 @@ public class HardCanteenProductApptExcelVo {
     @ExcelProperty({"商品统计", "商品名称"})
     private String statisticProductName;
 
-    /** 商品统计中的商品总数量，按退款扣减及套餐展开后的有效明细累计。 */
+    /** 商品统计中的商品总数量，预约按退款扣减，套餐按组成商品展开后的有效明细累计。 */
     @ExcelProperty({"商品统计", "商品总数量"})
     private Long statisticProductCount;
 
@@ -101,7 +105,7 @@ public class HardCanteenProductApptExcelVo {
     @NumberFormat("#,##0.00")
     private BigDecimal statisticProductTotalPrice;
 
-    /** 导出行层级，仅供合并处理器识别，不写入 Excel。 */
+    /** 导出行层级，仅供合并处理器和测试识别，不写入 Excel。 */
     @ExcelIgnore
     private String rowLevel;
 }