leniu-dev 2.0.0 → 2.0.1

package/.cursor/skills/leniu-mealtime/SKILL.md

@@ -0,0 +1,215 @@
+---
+name: leniu-mealtime
+description: |
+  leniu-tengyun-core 项目餐次处理规范。当编写涉及餐次（早餐/午餐/下午茶/晚餐/夜宵）的报表或查询代码时使用。
+
+  触发场景：
+  - 在 Param 查询参数类中添加餐次筛选字段（mealtimeTypes）
+  - 在 VO 返回类中定义餐次字段和 MealtimeTypeConverter 转换器
+  - 编写 MyBatis XML 中的餐次 IN 查询条件
+  - 处理餐次枚举转换（AllocMealtimeTypeEnum）
+  - 区分正餐（早/午/晚）与非正餐（下午茶/夜宵）
+
+  适用项目：
+  - leniu-tengyun-core：/Users/xujiajun/Developer/gongsi_proj/leniu-api/leniu-tengyun-core
+  - leniu-yunshitang：/Users/xujiajun/Developer/gongsi_proj/leniu-api/leniu-tengyun/leniu-yunshitang
+
+  触发词：餐次、mealtime、mealtimeType、早餐、午餐、晚餐、下午茶、夜宵、AllocMealtimeTypeEnum
+---
+
+# 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-customization/SKILL.md

@@ -0,0 +1,415 @@
+---
+name: leniu-report-customization
+description: |
+  leniu-tengyun-core 项目（v5.29）定制报表开发指南。基于 report_order_info / report_order_detail / report_account_flow 等报表基础表实现汇总报表。
+
+  触发场景：
+  - 基于订单数据实现定制汇总报表
+  - 基于账户流水实现定制汇总报表
+  - 处理报表中的退款数据（正向/逆向/部分退）
+  - 实现报表的 MQ 消费逻辑和 fix 初始化逻辑
+  - 报表金额计算（消费金额减退款）
+
+  触发词：定制报表、汇总报表、report_order_info、report_order_detail、report_account_flow、退款汇总、消费金额统计、订单报表、流水报表
+---
+
+# leniu 定制报表开发指南
+
+> 详细字段说明见 `references/table-fields.md`
+
+## 概述
+
+定制报表基于**报表基础表**（由 MQ 消息写入）进行二次汇总：
+1. **订单类**：`report_order_info` + `report_order_detail`（消费/退款数据）
+2. **账户流水类**：`report_account_flow` + `report_account_flow_detail`（钱包变动数据）
+
+---
+
+## 一、报表系统架构
+
+### 1.1 两阶段消费模型
+
+```
+MQ 消息到达（下单/退款）
+    ↓
+第一阶段（order < 10，同步写基础表）
+    ├── ORDER=1  ReportOrderInfoService     → report_order_info
+    ├── ORDER=3  ReportOrderDetailService   → report_order_detail
+    └── ORDER=5  ReportRefundService        → report_refund / report_refund_detail
+    ↓
+第二阶段（order >= 10，批量写汇总表，由 Redis 计数触发）
+    ├── ORDER=11 ReportSumCanteenService    → report_sum_canteen（食堂汇总）
+    └── ORDER=3x ReportSumDishesService     → 菜品销售汇总
+```
+
+### 1.2 MQ 消息类型
+
+| 消息 | Topic/Tag | 监听器 |
+|------|-----------|--------|
+| 下单 | `order / order-v3-placed` | `ReportOrderMQListener` |
+| 退款 | `order / order-v3-refunded` | `ReportOrderRefundMQListener` |
+
+### 1.3 触发汇总消费的机制
+
+Redis 计数器 `ORDER_REPORT_COUNT_KEY:{merchantId}`，每来一条 MQ 消息递减，达到阈值时异步触发 `consumeOrderReport()`，从 `report_order_info` 中查出 `status=0`（未消费）的数据，批量调用所有 `order >= 10` 的 Service 的 `batchConsume()`。
+
+---
+
+## 二、核心基础表概要
+
+### 2.1 report_order_info（报表订单主表）
+
+> v5.29 后，正向下单和逆向退款**都存在这张表中**，通过 `consumeType` 区分。
+
+关键字段：`orderId`(主键), `relationOrderId`(退款指向原始订单), `consumeType`(**1=消费,2=退款**), `orderRefundState`(1未退/2全退/3部分退), `realAmount`/`refundAmount`/`walletAmount`/`subsidyAmount`(金额，分), `payTime`, `orderDate`, `mealtimeType`, `orderType`, `canteenId/stallId`, `status`(0未消费/1已消费)
+
+### 2.2 report_order_detail（菜品明细表）
+
+关键字段：`detailId`, `orderId`, `goodsDishesId/goodsDishesName`, `price/totalAmount/realAmount`(分), `quantity`, `detailState`(**1正常/2已退菜/3部分退菜**), `goodsRefundNum`, `refundAmount`, `detailType`(1菜品/2套餐/3商品/4按键/5补扣/6报餐)
+
+### 2.3 report_account_flow（账户流水主表）
+
+关键字段：`flowId`, `custId`, `flowType`(AccTradeTypeEnum), `flowRealAmount/flowAmount`, `accTotalBal/accAllBal`, `payTime`, `status`(0未消费/1已消费)
+
+> `custName`、`mobile` 使用 SM4 加密存储。
+
+### 2.4 report_account_flow_detail（流水钱包明细）
+
+关键字段：`flowId`, `walletId`(AccWalletIdEnum), `amount`(转出取负值), `walletBal`, `frozenBalance`
+
+---
+
+## 三、退款数据处理（核心重点）
+
+### 3.1 退款数据在 report_order_info 中的表现
+
+```
+正向订单：orderId=订单ID, consumeType=1, orderRefundState=1
+退款记录：orderId=退款单ID, consumeType=2, relationOrderId=原始订单ID
+          金额字段全部为负数（realRefundAmount、walletAmount、subsidyAmount 都乘以 -1）
+          payTime = 退款审核时间（checkTime）
+```
+
+### 3.2 净消费金额计算（3种方式）
+
+**方式一：直接 SUM（推荐）** - 退款金额已为负数
+
+```sql
+SELECT SUM(real_amount) AS netAmount,
+       SUM(wallet_amount) AS netWalletAmount
+FROM report_order_info WHERE pay_time BETWEEN #{startTime} AND #{endTime}
+```
+
+**方式二：分别统计消费和退款**
+
+```sql
+-- 消费总额（consumeType=1）/ 退款总额（consumeType=2，取ABS）
+-- 净额 = 消费总额 - 退款总额
+```
+
+**方式三：排除全退订单**
+
+```sql
+SELECT SUM(real_amount - IFNULL(refund_amount, 0)) AS netAmount
+FROM report_order_info
+WHERE consume_type = 1 AND order_refund_state IN (1, 3)
+```
+
+### 3.3 菜品级别退款
+
+```
+detailState=1（正常）/ 2（全退）/ 3（部分退）
+菜品净销量 = quantity - IFNULL(goods_refund_num, 0)
+菜品净金额 = total_amount - IFNULL(refund_amount, 0)
+```
+
+---
+
+## 四、钱包与交易类型枚举
+
+### 4.1 AccWalletIdEnum
+
+| key | 枚举 | 含义 |
+|-----|------|------|
+| 1 | WALLET | 个人钱包 |
+| 2 | SUBSIDY | 补贴钱包 |
+| 4 | LUCK_MONEY | 红包 |
+
+### 4.2 AccTradeTypeEnum
+
+| key | 枚举 | 金额方向 |
+|-----|------|---------|
+| 10/11 | RECHARGE/RECHARGE_GIFT | 正 |
+| 12/40/50 | 撤销赠送/撤销充值/撤销补贴 | **负** |
+| 20 | SUBSIDY 补贴 | 正 |
+| 30 | WITHDRAW 提现 | **负** |
+| 60/80/100 | 转出/冻结/补贴清空 | **负** |
+| 70/90 | 转入/解冻 | 正 |
+| 110/120 | CONSUME/CONSUME_REPAIR | **负** |
+| 130 | CONSUME_REFUND 退款 | 正 |
+| 131/132 | 账户预扣/预扣退款 | **负**/正 |
+| 140/141/142 | 红包/撤销红包/红包清空 | 正/**负**/**负** |
+
+### 4.3 账户流水常用过滤
+
+```java
+// 净消费额：消费为负，退款为正 → SUM 即为净消费额（负值）
+WHERE wallet_id = #{walletId} AND flow_type IN (110, 130)
+```
+
+---
+
+## 五、汇总表开发标准模式
+
+### 5.1 实现 ReportOrderConsumeService 接口
+
+```java
+@Service @Slf4j
+public class ReportSumXxxService implements ReportOrderConsumeService {
+    @Override public int getOrder() { return 15; } // <10基础, 10-29汇总, 30+菜品
+
+    @Override public void consume(OrderChangePO payload, ReportOrderInfoDTO baseInfo) {
+        // 汇总表通常留空
+    }
+
+    @Override public void batchConsume(List<ReportOrderConsumeDTO> list) {
+        // 分组 → 查存量 → 累加/新建（见下方模板）
+    }
+
+    @Override public void fix(ReportBaseParam param) {
+        // 先删后插，从基础表重新聚合
+    }
+}
+```
+
+### 5.2 batchConsume 模板
+
+```java
+@Override
+public void batchConsume(List<ReportOrderConsumeDTO> list) {
+    Map<String, List<ReportOrderConsumeDTO>> grouped = list.stream()
+        .collect(Collectors.groupingBy(e ->
+            e.getStatisticDate() + "_" + e.getCanteenId() + "_" + e.getStallId()));
+
+    List<ReportSumXxx> insertList = new ArrayList<>(), updateList = new ArrayList<>();
+
+    for (var entry : grouped.entrySet()) {
+        ReportOrderConsumeDTO first = entry.getValue().get(0);
+        ReportSumXxx existing = mapper.selectOne(Wrappers.<ReportSumXxx>lambdaQuery()
+            .eq(ReportSumXxx::getStatisticDate, first.getStatisticDate())
+            .eq(ReportSumXxx::getCanteenId, first.getCanteenId())
+            .eq(ReportSumXxx::getStallId, first.getStallId()));
+
+        if (existing == null) {
+            ReportSumXxx record = new ReportSumXxx();
+            record.setId(Id.next());
+            // 设置维度 + 累加金额
+            insertList.add(record);
+        } else {
+            // existing.setXxxAmount(existing.getXxxAmount().add(delta));
+            updateList.add(existing);
+        }
+    }
+    if (CollUtil.isNotEmpty(insertList)) { /* 批量插入 */ }
+    if (CollUtil.isNotEmpty(updateList)) { /* 批量更新 */ }
+}
+```
+
+### 5.3 fix 方法 + SQL 模板
+
+```java
+@Override
+public void fix(ReportBaseParam param) {
+    mapper.delete(Wrappers.<ReportSumXxx>lambdaQuery()
+        .between(ReportSumXxx::getStatisticDate,
+            param.getStartTime().toLocalDate(), param.getEndTime().toLocalDate()));
+    mapper.initFix(null, param.getStartTime(), param.getEndTime());
+}
+```
+
+```xml
+<insert id="initFix">
+    INSERT INTO report_sum_xxx (id, statistic_date, canteen_id, canteen_name,
+        order_count, consume_amount, refund_amount, net_amount)
+    SELECT #{id}, DATE(pay_time), canteen_id, canteen_name,
+        COUNT(*),
+        SUM(CASE WHEN consume_type = 1 THEN real_amount ELSE 0 END),
+        SUM(CASE WHEN consume_type = 2 THEN ABS(real_refund_amount) ELSE 0 END),
+        SUM(real_amount) + SUM(IFNULL(real_refund_amount, 0))
+    FROM report_order_info
+    WHERE pay_time BETWEEN #{startTime} AND #{endTime}
+    GROUP BY DATE(pay_time), canteen_id, canteen_name
+</insert>
+```
+
+---
+
+## 六、数据权限集成
+
+- Service 注入 `MgrAuthV2Api` 和 `ReportDataPermissionService`
+- 查询/导出方法首行调用 `mgrAuthApi.getUserAuthPO()` + `reportDataPermissionService.getDataPermission(authPO)`
+- Mapper 签名携带 `@Param("authPO")` 和 `@Param("dataPermission")`
+- XML `baseWhere` 末尾引入 `<include refid="net.xnzn.core.report.statistics.common.mapper.ReportDataPermissionMapper.dataPermission"/>`
+
+---
+
+## 七、查询接口标准模式（三并行 CompletableFuture）
+
+```java
+public PageVO<XxxVO> pageSummary(XxxParam param) {
+    CompletableFuture<Long> countF = CompletableFuture.supplyAsync(() -> mapper.selectCount(param));
+    CompletableFuture<List<XxxVO>> listF = CompletableFuture.supplyAsync(() -> mapper.selectPageList(param));
+    CompletableFuture<XxxTotalVO> totalF = CompletableFuture.supplyAsync(() -> mapper.selectTotal(param));
+    CompletableFuture.allOf(countF, listF, totalF).join();
+
+    PageVO<XxxVO> pageVO = new PageVO<>();
+    pageVO.setTotal(countF.join());
+    pageVO.setList(listF.join());
+    pageVO.setTotalLine(totalF.join());
+    return pageVO;
+}
+```
+
+---
+
+## 八、账户流水汇总报表
+
+实现 `ReportAccountConsumeService` 接口（类似 ReportOrderConsumeService），数据源为 `report_account_flow`。
+
+```sql
+-- 按钱包类型统计消费/退款
+SELECT d.wallet_id,
+    SUM(CASE WHEN d.flow_type = 110 THEN ABS(d.amount) ELSE 0 END) AS consume_amount,
+    SUM(CASE WHEN d.flow_type = 130 THEN d.amount ELSE 0 END) AS refund_amount
+FROM report_account_flow f
+JOIN report_account_flow_detail d ON f.flow_id = d.flow_id
+WHERE f.pay_time BETWEEN #{startTime} AND #{endTime}
+GROUP BY d.wallet_id
+```
+
+流水退款：`flowType=110` amount 为负，`flowType=130` amount 为正，直接 SUM 即净额。
+
+---
+
+## 九、MySQL only_full_group_by 规范（必须遵守）
+
+> 生产环境 MySQL 开启了 `sql_mode=only_full_group_by`，所有报表 SQL 必须满足此规则，否则报 `BadSqlGrammarException`。
+
+### 核心规则
+
+**SELECT 中所有非聚合字段，必须出现在 GROUP BY 中，且表达式必须完全一致。**
+
+### 常见错误：GROUP BY 表达式与 SELECT 不一致
+
+```sql
+-- ❌ 错误：SELECT 用 DATE_FORMAT，GROUP BY 用 DATE
+SELECT
+    DATE_FORMAT(atr.trade_time, '%Y-%m-%d') AS statisticDate,
+    SUM(atr.amount) AS totalAmount
+FROM acc_trade atr
+GROUP BY DATE(atr.trade_time)          -- ❌ 表达式不同，触发 only_full_group_by 报错
+ORDER BY DATE(atr.trade_time) ASC
+
+-- ✅ 正确：GROUP BY 与 SELECT 使用完全相同的表达式
+SELECT
+    DATE_FORMAT(atr.trade_time, '%Y-%m-%d') AS statisticDate,
+    SUM(atr.amount) AS totalAmount
+FROM acc_trade atr
+GROUP BY DATE_FORMAT(atr.trade_time, '%Y-%m-%d')   -- ✅ 与 SELECT 一致
+ORDER BY DATE_FORMAT(atr.trade_time, '%Y-%m-%d') ASC
+```
+
+### 常见错误：SELECT 包含非聚合字段未加入 GROUP BY
+
+```sql
+-- ❌ 错误：canteen_name 未在 GROUP BY 中
+SELECT
+    DATE(pay_time) AS orderDate,
+    canteen_name,                          -- ❌ 非聚合字段，未在 GROUP BY
+    SUM(real_amount) AS netAmount
+FROM report_order_info
+GROUP BY DATE(pay_time), canteen_id
+
+-- ✅ 正确：所有非聚合字段都加入 GROUP BY
+SELECT
+    DATE(pay_time) AS orderDate,
+    canteen_name,
+    SUM(real_amount) AS netAmount
+FROM report_order_info
+GROUP BY DATE(pay_time), canteen_id, canteen_name  -- ✅ 包含 canteen_name
+```
+
+### fix SQL 中的正确写法
+
+```xml
+<insert id="initFix">
+    INSERT INTO report_sum_xxx (id, statistic_date, canteen_id, canteen_name,
+        order_count, consume_amount, net_amount)
+    SELECT
+        #{id},
+        DATE(pay_time),              -- SELECT 用 DATE(pay_time)
+        canteen_id,
+        canteen_name,
+        COUNT(*),
+        SUM(CASE WHEN consume_type = 1 THEN real_amount ELSE 0 END),
+        SUM(real_amount)
+    FROM report_order_info
+    WHERE pay_time BETWEEN #{startTime} AND #{endTime}
+    GROUP BY DATE(pay_time), canteen_id, canteen_name  -- ✅ 与 SELECT 完全一致
+</insert>
+```
+
+### 开发检查项
+
+- [ ] SELECT 每个非聚合字段，在 GROUP BY 中都有对应
+- [ ] GROUP BY 的表达式与 SELECT 中的**完全一致**（`DATE_FORMAT(x, 'Y-m-d')` ≠ `DATE(x)`）
+- [ ] ORDER BY 也使用相同表达式（保持一致）
+
+---
+
+## 十、开发检查清单
+
+### 建表
+- [ ] 分组维度字段 + 金额汇总字段 + 审计字段（crby/crtime/upby/uptime/del_flag），无 tenant_id
+
+### 实现
+- [ ] 实现 `ReportOrderConsumeService`（或 Account 版本），设置 `getOrder()`
+- [ ] `batchConsume()` — 分组 → 查存量 → 累加/新建
+- [ ] `fix()` — 先删后插，从基础表重新聚合
+
+### 退款处理
+- [ ] 选择退款计算方式（直接 SUM 负数 / 分别统计 / 排除全退）
+- [ ] 菜品退款关注 `detailState` 和 `goodsRefundNum`
+
+### 查询接口
+- [ ] 分页 + 合计行（PageVO + TotalVO）+ 三并行 CompletableFuture
+
+### SQL 合规（only_full_group_by）
+- [ ] SELECT 非聚合字段全部在 GROUP BY 中
+- [ ] GROUP BY 表达式与 SELECT 完全一致
+
+---
+
+## 十一、关键代码位置
+
+| 类型 | 路径 |
+|------|------|
+| 下单 MQ 监听器 | `sys-canteen/.../report/statistics/config/mq/ReportOrderMQListener.java` |
+| 退款 MQ 监听器 | `sys-canteen/.../report/statistics/config/mq/ReportOrderRefundMQListener.java` |
+| 汇总消费调度 | `sys-canteen/.../report/statistics/config/mq/service/ReportConsumerService.java` |
+| ConsumeService 接口 | `sys-canteen/.../report/statistics/config/mq/ReportOrderConsumeService.java` |
+| 食堂汇总参考实现 | `sys-canteen/.../report/statistics/order/summary/service/ReportSumCanteenService.java` |
+| Fix Controller | `sys-canteen/.../report/statistics/order/fix/controller/ReportFixController.java` |
+| ReportOrderInfo 实体 | `sys-canteen/.../report/statistics/order/basic/model/ReportOrderInfo.java` |
+| AccTradeTypeEnum | `sys-canteen/.../account/v3/constants/AccTradeTypeEnum.java` |
+| AccWalletIdEnum | `sys-canteen/.../account/v3/constants/AccWalletIdEnum.java` |
+
+---
+
+## 注意
+
+- CRUD 开发（非报表）请使用 `leniu-crud-development`
+- MyBatis XML 编写规范请使用 `leniu-java-mybatis`
+- 报表入参设计请使用 `leniu-java-report-query-param`
+- 合计行实现请使用 `leniu-java-total-line`
+- 餐次过滤请使用 `leniu-mealtime`