ai-engineering-init 1.16.2 → 1.16.4

package/.cursor/skills/leniu-report-scenario/references/mealtime.md

@@ -0,0 +1,197 @@
+
+# leniu-tengyun-core 餐次处理规范
+
+## 餐次枚举定义
+
+### AllocMealtimeTypeEnum
+
+餐次类型枚举 `AllocMealtimeTypeEnum` 定义了5种餐次：
+
+| 枚举值 | key | 显示名称 | 说明 |
+|--------|-----|----------|------|
+| MEALTIME_BREAKFAST | 1 | 早餐 | 早餐 |
+| MEALTIME_LUNCH | 2 | 午餐 | 午餐 |
+| MEALTIME_AFTERNOON_TEA | 3 | 下午茶 | 下午茶 |
+| MEALTIME_DINNER | 4 | 晚餐 | 晚餐 |
+| MEALTIME_MIDNIGHT_SNACK | 5 | 夜宵 | 夜宵 |
+
+### 常用方法
+
+```java
+// 根据key获取枚举
+AllocMealtimeTypeEnum typeEnum = AllocMealtimeTypeEnum.getTypeEnum(1);
+
+// 根据key获取显示名称
+String desc = AllocMealtimeTypeEnum.getValueByKey(1); // 返回 "早餐"
+
+// 获取所有餐次key列表
+List<Integer> allTypes = AllocMealtimeTypeEnum.allTypeList(); // [1, 2, 3, 4, 5]
+
+// 获取正餐类型列表
+List<Integer> normalTypes = AllocMealtimeTypeEnum.normalTypeList(); // [1, 2, 4]
+```
+
+### 餐次分类
+
+- **正餐**：早餐(1)、午餐(2)、晚餐(4)
+- **非正餐**：下午茶(3)、夜宵(5)
+
+## 查询参数中的餐次处理
+
+### Param类定义
+
+在报表查询Param类中添加餐次筛选字段：
+
+```java
+@ApiModelProperty(value = "餐次集合")
+private List<Integer> mealtimeTypes;
+```
+
+### 完整示例
+
+```java
+@Data
+@AllArgsConstructor
+@NoArgsConstructor
+@EqualsAndHashCode(callSuper = true)
+@ApiModel(value = "XXX查询入参")
+public class XxxParam extends ReportBaseParam {
+
+    @ApiModelProperty(value = "餐次集合")
+    private List<Integer> mealtimeTypes;
+
+    // 其他查询字段...
+}
+```
+
+## 返回VO中的餐次处理
+
+### VO字段定义
+
+在报表返回VO类中定义餐次字段：
+
+```java
+@Data
+@Accessors(chain = true)
+@ApiModel(value = "XXX报表")
+public class XxxVO {
+
+    @ExcelProperty(value = "餐次", order = 5, converter = MealtimeTypeConverter.class)
+    @ApiModelProperty(value = "餐次")
+    private Integer mealtimeType;
+
+    // 其他字段...
+}
+```
+
+### 必要的导入
+
+```java
+import com.alibaba.excel.annotation.ExcelProperty;
+import net.xnzn.core.common.export.converter.MealtimeTypeConverter;
+```
+
+### 字段说明
+
+- `mealtimeType`: 存储餐次的整数key值（1-5）
+- `@ExcelProperty`: 配置EasyExcel导出，使用`MealtimeTypeConverter`进行转换
+- `converter = MealtimeTypeConverter.class`: 自动将整数转换为可读的餐次名称
+
+## MyBatis XML中的餐次查询
+
+### 基本IN查询
+
+```xml
+<!-- 餐次筛选 -->
+<if test="mealtimeTypes != null and mealtimeTypes.size() > 0">
+    AND mealtime_type IN
+    <foreach collection="mealtimeTypes" item="type" open="(" separator="," close=")">
+        #{type}
+    </foreach>
+</if>
+```
+
+### 正餐筛选
+
+```xml
+<!-- 仅查询正餐（早餐、午餐、晚餐） -->
+AND mealtime_type IN (1, 2, 4)
+```
+
+### 完整示例
+
+```xml
+<select id="pageXxx" resultType="net.xnzn.core.xxx.vo.XxxVO">
+    SELECT
+        id,
+        order_date,
+        mealtime_type,
+        cust_name,
+        real_amount
+    FROM order_table
+    WHERE del_flag = 2
+    <if test="startDate != null">
+        AND order_date >= #{startDate}
+    </if>
+    <if test="endDate != null">
+        AND order_date &lt;= #{endDate}
+    </if>
+    <if test="mealtimeTypes != null and mealtimeTypes.size() > 0">
+        AND mealtime_type IN
+        <foreach collection="mealtimeTypes" item="type" open="(" separator="," close=")">
+            #{type}
+        </foreach>
+    </if>
+    <if test="canteenId != null">
+        AND canteen_id = #{canteenId}
+    </if>
+    ORDER BY order_date DESC
+</select>
+```
+
+## 常见使用场景
+
+### 场景1：查询指定餐次的订单
+
+```java
+// Param定义
+@ApiModelProperty(value = "餐次集合")
+private List<Integer> mealtimeTypes;
+
+// Service调用
+List<Integer> mealtimeTypes = Arrays.asList(1, 2); // 查询早餐和午餐
+param.setMealtimeTypes(mealtimeTypes);
+```
+
+### 场景2：仅查询正餐
+
+```java
+// 方式1：直接在XML中硬编码
+AND mealtime_type IN (1, 2, 4)
+
+// 方式2：使用枚举工具类
+param.setMealtimeTypes(AllocMealtimeTypeEnum.normalTypeList());
+```
+
+### 场景3：导出时餐次列显示中文名称
+
+```java
+// VO定义
+@ExcelProperty(value = "餐次", order = 5, converter = MealtimeTypeConverter.class)
+@ApiModelProperty(value = "餐次")
+private Integer mealtimeType;
+
+// 导出时自动转换：1 -> "早餐"，2 -> "午餐" 等
+```
+
+## 注意事项
+
+1. **字段命名**：统一使用 `mealtimeType` (驼峰) 或 `mealtime_type` (下划线)
+2. **类型**：数据库和Java代码中均使用 `Integer` 类型
+3. **转换器**：导出时必须使用 `MealtimeTypeConverter` 进行转换
+4. **国际化的影响**：显示名称根据项目配置可能使用中文或国际化key
+5. **正餐判断**：需要区分正餐时使用 `AllocMealtimeTypeEnum.normalTypeList()` 方法
+
+## 参考文档
+
+详见：[leniu-tengyun-core 源码](/Users/xujiajun/Developer/gongsi_proj/core/leniu-tengyun-core)

package/.cursor/skills/leniu-report-scenario/references/query-param.md

@@ -0,0 +1,274 @@
+
+# leniu-tengyun-core 报表查询入参规范
+
+## 项目特征
+
+| 特征 | 说明 |
+|------|------|
+| **包名前缀** | `net.xnzn.core.*` |
+| **JDK 版本** | 21 |
+| **请求封装** | `LeRequest<T>` |
+| **分页参数** | `PageDTO` |
+| **基类** | `ReportBaseParam` |
+| **校验框架** | Jakarta Validation |
+
+## 核心结构
+
+### 1. Controller层接收入参
+
+```java
+import com.pig4cloud.pigx.common.core.util.LeRequest;
+
+@PostMapping("/page")
+public ReportBaseTotalVO<XxxVO> pageXxxSummary(@RequestBody LeRequest<XxxParam> request) {
+    XxxParam param = request.getContent();
+    return xxxService.pageSummary(param);
+}
+```
+
+### 2. Param类基类继承
+
+报表查询Param类**必须继承** `ReportBaseParam`：
+
+```java
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import io.swagger.annotations.ApiModel;
+import io.swagger.annotations.ApiModelProperty;
+import net.xnzn.core.common.page.PageDTO;
+import net.xnzn.core.common.param.ReportBaseParam;
+
+import java.time.LocalDate;
+import java.util.List;
+
+@Data
+@EqualsAndHashCode(callSuper = true)
+@ApiModel(value = "XXX查询入参")
+public class XxxParam extends ReportBaseParam {
+
+    @ApiModelProperty("关键字")
+    private String keyword;
+
+    @ApiModelProperty("状态")
+    private Integer status;
+}
+```
+
+### 3. ReportBaseParam 提供的通用字段
+
+| 字段名 | 类型 | 说明 |
+|--------|------|------|
+| `page` | `PageDTO` | 分页参数 |
+| `startDate` | `LocalDate` | 开始时间 |
+| `endDate` | `LocalDate` | 结束时间 |
+| `exportCols` | `List<String>` | 需要导出的列 |
+| `sumType` | `Integer` | 汇总类型 |
+| `sumDimension` | `Integer` | 统计维度 |
+
+## 常用查询字段模式
+
+### 时间范围查询
+
+```java
+@Data
+@EqualsAndHashCode(callSuper = true)
+@ApiModel("订单报表查询参数")
+public class OrderReportParam extends ReportBaseParam {
+
+    // 基类已有 startDate, endDate
+
+    @ApiModelProperty("开始时间（精确到秒）")
+    private LocalDateTime startTime;
+
+    @ApiModelProperty("结束时间（精确到秒）")
+    private LocalDateTime endTime;
+}
+```
+
+### 组织筛选
+
+```java
+@Data
+@EqualsAndHashCode(callSuper = true)
+@ApiModel("组织报表查询参数")
+public class OrgReportParam extends ReportBaseParam {
+
+    @ApiModelProperty("组织ID")
+    private Long orgId;
+
+    @ApiModelProperty("组织ID列表")
+    private List<Long> orgIds;
+
+    @ApiModelProperty("食堂ID")
+    private Long canteenId;
+
+    @ApiModelProperty("食堂ID列表")
+    private List<Long> canteenIds;
+}
+```
+
+### 餐次筛选
+
+```java
+@Data
+@EqualsAndHashCode(callSuper = true)
+@ApiModel("餐次报表查询参数")
+public class MealtimeReportParam extends ReportBaseParam {
+
+    @ApiModelProperty("餐次类型列表")
+    private List<Integer> mealtimeTypes;
+
+    @ApiModelProperty("是否只查正餐")
+    private Boolean onlyMainMeal;
+}
+```
+
+### 金额范围
+
+```java
+@Data
+@EqualsAndHashCode(callSuper = true)
+@ApiModel("金额报表查询参数")
+public class AmountReportParam extends ReportBaseParam {
+
+    @ApiModelProperty("最小金额（分）")
+    private Long minAmount;
+
+    @ApiModelProperty("最大金额（分）")
+    private Long maxAmount;
+}
+```
+
+## PageDTO 结构
+
+```java
+@Data
+@ApiModel("分页参数")
+public class PageDTO {
+
+    @ApiModelProperty("当前页码")
+    private Integer current = 1;
+
+    @ApiModelProperty("每页条数")
+    private Integer size = 10;
+
+    @ApiModelProperty("是否查询总数")
+    private Boolean ifCount = true;
+
+    @ApiModelProperty("页数为0时的处理")
+    private Boolean ifPageSizeZero = false;
+}
+```
+
+## 完整示例
+
+```java
+@Data
+@EqualsAndHashCode(callSuper = true)
+@ApiModel("销售报表查询参数")
+public class SalesReportParam extends ReportBaseParam {
+
+    @ApiModelProperty(value = "关键字")
+    private String keyword;
+
+    @ApiModelProperty(value = "组织ID列表")
+    private List<Long> orgIds;
+
+    @ApiModelProperty(value = "食堂ID列表")
+    private List<Long> canteenIds;
+
+    @ApiModelProperty(value = "餐次类型列表")
+    private List<Integer> mealtimeTypes;
+
+    @ApiModelProperty(value = "支付方式列表")
+    private List<Integer> payTypes;
+
+    @ApiModelProperty(value = "最小金额（分）")
+    private Long minAmount;
+
+    @ApiModelProperty(value = "最大金额（分）")
+    private Long maxAmount;
+
+    @ApiModelProperty(value = "是否查询合计行")
+    private Boolean ifQueryTotal = true;
+}
+```
+
+## 两层继承结构（实际生产代码模式）
+
+报表 Param 存在两层继承结构，以订单分析报表为例：
+
+```
+ReportAnalysisParam（大类基类：订单分析类报表通用字段）
+    └── ReportAnalysisTurnoverParam（具体报表 Param，加业务字段）
+```
+
+### ReportAnalysisParam（中间基类）
+
+```java
+import lombok.Data;
+import net.xnzn.core.common.page.PageDTO;
+
+import java.time.LocalDate;
+import java.util.List;
+
+@Data
+public class ReportAnalysisParam {
+
+    /** 分页参数 */
+    private PageDTO page;
+
+    /** 开始日期 */
+    private LocalDate startDate;
+
+    /** 结束日期 */
+    private LocalDate endDate;
+
+    /** 日期维度：1=按月 2=按日 */
+    private Integer dateType;
+
+    /** 食堂摊位ID列表（多选） */
+    private List<Long> canteenStallIds;
+}
+```
+
+### ReportAnalysisTurnoverParam（具体 Param，继承中间基类）
+
+```java
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+
+import java.util.List;
+
+@Data
+@EqualsAndHashCode(callSuper = true)
+public class ReportAnalysisTurnoverParam extends ReportAnalysisParam {
+
+    /** 餐次类型（单选） */
+    private Integer mealtimeType;
+
+    /** 餐次类型列表（多选） */
+    private List<Integer> mealtimeTypeList;
+
+    /** 排序类型：1=按金额降序（默认） */
+    private Integer sortType = 1;
+
+    /** 食堂ID（单选） */
+    private Long canteenId;
+
+    /** 摊位ID（单选） */
+    private Long stallId;
+}
+```
+
+**选择继承层级的判断依据**：
+- 若报表是"订单分析"大类报表 → 继承 `ReportAnalysisParam`（含 `dateType`）
+- 若是通用报表 → 直接继承 `ReportBaseParam`（含 `page/startDate/endDate/exportCols`）
+
+## 注意事项
+
+- 报表Param类必须继承 `ReportBaseParam` 或其子类（如 `ReportAnalysisParam`）
+- 时间字段使用 `LocalDate` 或 `LocalDateTime`
+- `dateType` 字段含义：1=按月汇总，2=按日汇总
+- 金额查询参数类型与业务域保持一致：钱包/账户用 `Long`（分），订单用 `BigDecimal`（分）；见 leniu-java-amount-handling
+- 导出时通过 `exportCols` 控制导出列

package/.cursor/skills/leniu-report-scenario/references/standard-customization.md

@@ -0,0 +1,112 @@
+
+# leniu 标准版定制报表开发指南
+
+> 详细字段说明见 `references/table-fields.md`，经营分析详情见 `references/analysis-module.md`
+
+## 版本识别（必读）
+
+**本 skill 仅适用于标准版（core-report 独立模块）**。
+
+| 判断方式 | 标准版（本指南） | v5.29 版本 |
+|---------|--------------|-----------|
+| 目录结构 | `core-report/` 独立模块 | `sys-canteen/` 内嵌 |
+| 退款存储 | 独立 `report_refund` 表（**正数**） | 合并入 `report_order_info`（`consumeType=2`，**负数**） |
+| 第二阶段 | `fix()` 按日重算 | `batchConsume()` 增量累加 |
+| consumeType | **无此字段** | 1=消费，2=退款 |
+
+> v5.29 报表请使用 `leniu-report-customization`。钱包/交易类型枚举同 v5.29，参见该 skill。
+
+
+## 二、核心基础表概要
+
+### 2.1 report_order_info（仅存正向订单，无 consumeType）
+
+关键字段：`orderId`(主键), `canteenId/stallId`, `mealtimeType`, `orderType`, `payableAmount/realAmount/refundAmount`(分), `accPayAmount/outPayAmount`, `payTime/orderDate`, `orderRefundState`(1未退/2全退/3部分退), `status`(0未消费/1已消费), `nuClearMode`, `psnType`, `ageType/holidayType`
+
+### 2.2 report_order_detail（菜品明细）
+
+关键字段：`detailId`, `orderId`, `goodsDishesId/goodsDishesName`, `price/totalAmount/realAmount`(分), `quantity`, `salesMode`(1按份/2称重), `detailState`(1正常/2全退/3部分退), `goodsRefundNum`, `refundAmount`, `detailType`
+
+### 2.3 report_refund / report_refund_detail（标准版特有，退款为正数）
+
+**report_refund**：`orderRefundId`(主键), `orderId`(原订单), `realRefundAmount`(**正数**), `applyType`(1退单/2纠错), `checkTime`
+
+**report_refund_detail**：`orderRefundId`, `detailId`, `realQuantity`, `realRefundAmount`(**正数**)
+
+### 2.4 其他基础表
+
+- **report_order_pay**：`orderId`, `payType/payChannel`, `payAmount/refundAmount`
+- **report_order_discount**：`orderId`, `changeAmount`, `changeType`(1上浮/2优惠), `changeDetailType`
+- **report_order_info_snapshot**：订单交易快照
+
+
+## 四、账户流水报表
+
+### 4.1 report_account_flow（流水主表）
+
+核心字段：`flowId`, `custId/orgId`, `payTime`, `flowType`(AccTradeTypeEnum), `flowRealAmount/flowAmount`, `manageCost`, `accTotalBal/accAllBal`, `status`
+
+### 4.2 report_account_summary（用户账户日结表）
+
+联合主键：`statisticDate` + `custId`。期末余额 = 期初 + 充值 - 撤销充值 + 补贴 - 撤销补贴 + 红包 + 赠送 - 消费 - 补扣 + 退款 - 提现 - 清空 - 管理费
+
+### 4.3 AccountConsumeService 实现
+
+| ORDER | 类 | 汇总表 |
+|-------|---|-------|
+| 1/2 | Flow/FlowDetail | 基础表 |
+| 13 | AccountSummary | 日结 |
+| 14 | AccountOperator | 操作员 |
+| 15-17 | ConsumeSummary/Org/Type | 消费维度 |
+| 18 | WalletConsume | 钱包 |
+| 19 | SumRechargeMer | 商户充值 |
+
+
+## 六、汇总模型速查
+
+| 表 | 维度 | 金额 |
+|----|------|------|
+| report_sum_mealtime | date/canteen/stall/org/age/mealtime/psn/machine/source | custNum/consumeNum/realAmount/refundAmount |
+| report_sum_pay | date/mealtime/canteen/stall/org/age/payChannel/payType | payNum/realAmount/refundAmount |
+| report_sum_dishes | date/area/canteen/stall/reportOrderType/mealtime/cook/device/dishes/salesMode/detailType | quantity/realAmount |
+| report_sum_pay_mer | tenantId/date/payChannel/payType | custNum/payNum/realAmount/refundAmount |
+
+
+## 八、公共模块
+
+- **报表错误日志**（report_error_log）：`reportErrorType`(1账户/2订单), `reportErrorState`(1已创建/2已处理)。定时任务 `@XxlJob("reportExceptionHandle")` 自动修复。
+- **金额范围设置**：`POST /report/alloc/amount-scope/save`
+- **数据修复**：`POST /summary/fix/order|account`（限31天，Redisson 锁 120 分钟）
+
+### 核心枚举
+
+| 枚举 | 值 |
+|------|---|
+| ReportClassifyEnum | 1组织/2类别/3食堂/4设备/5收入/6渠道/7餐次 |
+| ReportPayTypeEnum | 1微信/2支付宝/3系统账户/9现金/20其他 |
+
+
+## 十、开发检查清单
+
+### 建表
+- [ ] 分组维度 + 金额汇总 + 审计字段（crby/crtime/upby/uptime/del_flag），无 tenant_id
+
+### 实现
+- [ ] 实现 `ReportOrderConsumeService`，设 `getOrder()`
+- [ ] `fix()` 先删后插（**标准版核心模式**），`consume()` 留空
+
+### 退款（标准版特有）
+- [ ] 退款在独立 `report_refund` 表（**正数金额**）
+- [ ] 净消费 = `real_amount - IFNULL(refund_amount, 0)`
+- [ ] **不要使用 consumeType 字段**
+
+### 查询
+- [ ] ReportBaseTotalVO + CompletableFuture 并行 + MgrUserAuthPO 权限
+- [ ] GROUP BY / ORDER BY 表达式与 SELECT 完全一致（only_full_group_by）
+
+
+## 注意
+
+- 标准版退款为独立表（正数金额），**不要使用 consumeType 字段**
+- 标准版第二阶段用 `fix()` 按日重算，**不要使用 batchConsume() 增量模式**
+- CRUD 用 `leniu-crud-development`，MyBatis 用 `leniu-java-mybatis`，入参用 `leniu-java-report-query-param`，合计行用 `leniu-java-total-line`，餐次用 `leniu-mealtime`

package/.cursor/skills/leniu-report-scenario/references/standard-table-fields.md

@@ -0,0 +1,113 @@
+# 标准版报表基础表完整字段说明
+
+## report_order_info（报表订单主表，仅正向订单）
+
+> 标准版中此表**仅存正向订单**，退款数据在独立的 `report_refund` 表中。无 `consumeType` 字段。
+
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| `orderId` | Long | 主键（雪花 ID） |
+| `machineSn` | String | 设备 SN |
+| `orgId` | Long | 组织 ID |
+| `custId` | Long | 人员 ID |
+| `nuClearMode` | Integer | 核身方式（1刷卡/2刷脸/3扫码） |
+| `sourceType` | Integer | 来源类型 |
+| `ifOnline` | Integer | 是否在线（1是/2否） |
+| `canteenId/canteenName` | Long/String | 食堂 |
+| `stallId/stallName` | Long/String | 档口 |
+| `mealtimeType` | Integer | 餐次（1早/2午/3下午茶/4晚/5夜宵） |
+| `psnType` | Integer | 人员类别 |
+| `payableAmount` | BigDecimal | 应付金额（分） |
+| `discountsAmount` | BigDecimal | 优惠金额（分，取负数） |
+| `deliveryAmount` | BigDecimal | 配送费（分） |
+| `packingAmount` | BigDecimal | 包装费（分） |
+| `realAmount` | BigDecimal | 实付金额（分） |
+| `accPayAmount` | BigDecimal | 账户支付金额（分） |
+| `outPayAmount` | BigDecimal | 外部支付金额（分） |
+| `refundAmount` | BigDecimal | 累计退款金额（分） |
+| `orderTime` | LocalDateTime | 下单时间 |
+| `orderDate` | LocalDate | 就餐日期 |
+| `orderType` | Integer | 订单类型（1当餐/2预订/3报餐/4扫码/5餐桌/6自助/11商城/12超市/21补扣/22外部） |
+| `orderRefundState` | Integer | 退款状态（1未退/2已退/3部分退） |
+| `payTime` | LocalDateTime | 支付时间 |
+| `payType` | Integer | 支付方式 |
+| `payChannel` | Integer | 支付渠道 |
+| `ageType` | Integer | 年龄段 |
+| `holidayType` | Integer | 节假日类型 |
+| `status` | Integer | 消费状态（0未消费/1已消费） |
+
+## report_order_detail（订单菜品明细表）
+
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| `detailId` | Long | 明细主键 |
+| `orderId` | Long | 关联订单 ID |
+| `goodsDishesId` | Long | 菜品 ID |
+| `goodsDishesName` | String | 菜品名称 |
+| `salePrice` | BigDecimal | 售卖价格（分） |
+| `prefPrice` | BigDecimal | 优惠价格（分） |
+| `price` | BigDecimal | 最终价格（分） |
+| `weightUnit` | BigDecimal | 每份重量（g） |
+| `quantity` | Integer | 数量/重量 |
+| `salesMode` | Integer | 销售方式（1按份/2称重） |
+| `detailType` | Integer | 类别（1菜品/2套餐/3商品/4按键/5补扣/6报餐） |
+| `totalAmount` | BigDecimal | 总金额（分） |
+| `realAmount` | BigDecimal | 实付金额（分） |
+| `detailState` | Integer | 状态（1正常/2已退菜/3部分退菜） |
+| `goodsRefundNum` | Integer | 已退数量 |
+| `refundAmount` | BigDecimal | 退款金额（分） |
+
+## report_refund（退款主表，标准版特有）
+
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| `orderRefundId` | Long | 退款单主键 |
+| `orderId` | Long | 原始订单 ID |
+| `realRefundAmount` | BigDecimal | 退款金额（**正数**） |
+| `applyTime` | LocalDateTime | 申请时间 |
+| `applyType` | Integer | 申请类型（1退单/2纠错） |
+| `checkTime` | LocalDateTime | 审核时间 |
+
+## report_refund_detail（退款明细表，标准版特有）
+
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| `orderRefundId` | Long | 退款单 ID |
+| `detailId` | Long | 菜品详情 ID |
+| `realQuantity` | Integer | 退单数量 |
+| `realRefundAmount` | BigDecimal | 退款金额（**正数**） |
+
+## report_account_flow（账户流水主表）
+
+核心字段：`flowId`(主键), `custId`, `orgId`, `payTime`, `flowType`(AccTradeTypeEnum), `flowRealAmount`, `flowAmount`, `manageCost`, `accTotalBal`(可用余额), `accAllBal`(含冻结), `rechargeSource`, `payChannel/payType`, `status`(0未消费/1已消费)
+
+附加字段：`rechargeOperate`(1单人/2批量/3导入/4赠送), `withdrawSource`(1小程序/2web/3openapi/4注销), `operateSource`(1手动清空/2批量/3定时/4注销)
+
+## report_account_flow_detail（流水钱包明细）
+
+字段：`flowId`, `walletId`(1个人/2补贴/4红包), `amount`(转出取负值), `walletBal`, `flowType`, `frozenBalance`, `allWalletBal`
+
+## report_account_summary（用户账户日结表）
+
+联合主键：`statisticDate` + `custId`
+
+**期末余额公式**：
+```
+endAmount = beginAmount
+    + rechargeAmount - rechargeRevokeAmount
+    + subsidyAmount - subsidyRevokeAmount
+    + luckAmount + giftAmount
+    - consumeAmount - consumeRepairAmount
+    + consumeRefundAmount
+    - withdrawAmount - clearAmount - manageCostAmount
+```
+
+附加维度：充值渠道详分（微信/支付宝/现金/银行/第三方）、提现渠道详分、各钱包余额及冻结金额
+
+## report_order_pay（订单支付表）
+
+字段：`orderId`, `payType`, `payChannel`, `outTradeNo`, `payAmount`, `refundAmount`, `payableAmount`
+
+## report_order_discount（订单优惠表）
+
+字段：`orderId`, `changeAmount`, `changeType`(1上浮/2优惠), `changeDetailType`(1上浮/11菜品优惠/12打折/13累计减免/14固定减免)