leniu-dev 2.0.0 → 2.0.1

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

@@ -0,0 +1,93 @@
+# 报表基础表完整字段说明
+
+## report_order_info（报表订单主表）
+
+> v5.29 后，正向下单和逆向退款**都存在这张表中**，通过 `consumeType` 区分。
+
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| `orderId` | Long | 主键。正向=订单ID，退款=退款单ID |
+| `relationOrderId` | Long | 关联订单ID（退款记录指向原始订单） |
+| `consumeType` | Integer | **1=消费，2=退款** |
+| `orderRefundState` | Integer | **1=未退单，2=已退单（全退），3=部分退单** |
+| `payableAmount` | BigDecimal | 应付金额（分） |
+| `realAmount` | BigDecimal | 实付金额（分） |
+| `refundAmount` | BigDecimal | 累计退款金额（分） |
+| `realRefundAmount` | BigDecimal | 实际退款金额（分，退款记录为负数） |
+| `walletAmount` | BigDecimal | 个人钱包支付金额（分） |
+| `subsidyAmount` | BigDecimal | 补贴钱包支付金额（分） |
+| `redEnvelopeAmount` | BigDecimal | 红包支付金额（分） |
+| `accPayAmount` | BigDecimal | 账户支付金额（分） |
+| `outPayAmount` | BigDecimal | 外部支付金额（分） |
+| `payTime` | LocalDateTime | 支付时间（退款=审核时间） |
+| `orderTime` | LocalDateTime | 下单时间 |
+| `orderDate` | LocalDate | 就餐日期 |
+| `status` | Integer | 消费状态：0=未消费，1=已消费 |
+| `mealtimeType` | Integer | 餐次类型 |
+| `orderType` | Integer | 订单类型（1当餐/2预订/3报餐/4扫码/5餐桌/6自助/11商城/12超市/21补扣/22外部） |
+| `canteenId/canteenName` | Long/String | 食堂 |
+| `stallId/stallName` | Long/String | 档口 |
+| `areaId/areaName` | Long/String | 区域 |
+| `custId/custName/custNum` | - | 用户信息 |
+| `orgId/orgFullId/orgName/orgFullName` | - | 组织信息 |
+| `payType` | Integer | 支付方式 |
+| `payChannel` | Integer | 支付渠道 |
+| `nuClearMode` | Integer | 核身方式（1刷卡/2刷脸/3扫码） |
+| `sourceType` | Integer | 来源类型 |
+| `ifOnline` | Integer | 是否在线订单（1是/2否） |
+| `psnType/psnTypeName` | Integer/String | 用户类别 |
+| `personType` | Integer | 人员归类（1职工/2患者/3陪护/4其他，医院版） |
+
+## report_order_detail（报表订单菜品明细表）
+
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| `detailId` | Long | 明细主键 |
+| `orderId` | Long | 关联订单ID |
+| `goodsDishesId/goodsDishesName` | Long/String | 菜品信息 |
+| `salePrice` | BigDecimal | 售卖价格（分） |
+| `prefPrice` | BigDecimal | 优惠价格（分） |
+| `price` | BigDecimal | 计算价格（分，最终价格） |
+| `quantity` | Integer | 数量/重量 |
+| `totalAmount` | BigDecimal | 订单详情总金额（分） |
+| `realAmount` | BigDecimal | 实际付款金额（分） |
+| `detailState` | Integer | **1=正常，2=已退菜（全退），3=部分退菜** |
+| `goodsRefundNum` | Integer | 商品已退数量 |
+| `refundAmount` | BigDecimal | 商品退款金额（分） |
+| `detailType` | Integer | 明细类别（1菜品/2套餐/3商品/4按键/5补扣/6报餐） |
+| `costPrice` | BigDecimal | 成本价格 |
+
+## report_account_flow（账户变动流水主表）
+
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| `flowId` | Long | 主键（雪花ID） |
+| `custId` | Long | 人员ID |
+| `flowType` | Integer | 交易类型（AccTradeTypeEnum） |
+| `flowRealAmount` | BigDecimal | 实际交易金额 |
+| `flowAmount` | BigDecimal | 交易金额 |
+| `accTotalBal` | BigDecimal | 所有钱包可用余额之和（不含冻结） |
+| `accAllBal` | BigDecimal | 所有钱包总余额（含冻结） |
+| `payTime` | LocalDateTime | 支付时间 |
+| `ordTime` | LocalDateTime | 订单时间 |
+| `status` | Integer | 消费状态：0=未消费，1=已消费 |
+| `manageCost` | BigDecimal | 管理费 |
+| `rechargeSource` | Integer | 充值来源 |
+| `payChannel` | Integer | 支付渠道 |
+| `payType` | Integer | 支付方式 |
+
+> 注意：`custName`、`mobile`、`mobileSuffix` 使用 SM4 加密存储。
+
+## report_account_flow_detail（账户流水钱包明细表）
+
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| `id` | Long | 自增主键 |
+| `flowId` | Long | 关联主流水 |
+| `walletId` | Long | 钱包类型（AccWalletIdEnum） |
+| `flowType` | Integer | 交易类型 |
+| `amount` | BigDecimal | 本钱包支付金额（转出类型取负值） |
+| `walletBal` | BigDecimal | 本钱包可用余额 |
+| `allWalletBal` | BigDecimal | 本钱包总余额（含冻结） |
+| `frozenBalance` | BigDecimal | 冻结余额 |
+| `payTime` | LocalDateTime | 支付时间 |

package/.cursor/skills/leniu-report-standard-customization/SKILL.md

@@ -0,0 +1,391 @@
+---
+name: leniu-report-standard-customization
+description: |
+  leniu-tengyun-core 标准版（core-report 模块）定制报表开发指南。基于独立 report_order_info / report_refund / report_account_flow 等报表基础表实现汇总报表。
+
+  触发场景：
+  - 在标准版（core-report 模块）中开发定制汇总报表
+  - 基于标准版退款表（report_refund）处理退款统计
+  - 开发账户流水报表（日结/操作员/钱包消费/消费汇总）
+  - 开发经营分析报表（营业额/用户/菜品/评价/充值/设备分析）
+  - 开发商户维度的消费/充值汇总报表
+
+  触发词：标准版报表、core-report、report_refund、report_refund_detail、经营分析、营业额分析、用户活跃度、菜品排行、操作员统计、账户日结、钱包消费汇总、商户消费汇总、ReportOrderConsumeService、ReportAccountConsumeService
+---
+
+# 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。
+
+---
+
+## 一、报表系统架构
+
+### 1.1 模块结构
+
+```
+core-report/.../statistics/
+├── config/mq/          # MQ 监听器 + 消费调度 + 线程池
+├── order/              # 订单报表（basic/summary/fix/analysis）
+├── account/            # 账户流水报表
+├── merchant/           # 商户维度报表
+├── common/             # 错误日志/定时任务
+└── param/vo/constants/ # 公共类
+```
+
+### 1.2 三大 MQ 监听器
+
+| 监听器 | Topic/Tag |
+|-------|-----------|
+| `ReportOrderMQListener` | `order / order-v3-placed` |
+| `ReportOrderRefundMQListener` | `order / order-v3-refunded` |
+| `ReportAccountMQListener` | `acc / acc-trade-report-queue` |
+
+### 1.3 两阶段消费模型
+
+```
+第一阶段（ORDER < 10，同步写基础表）
+    ├── ORDER=1  ReportOrderInfoService        → report_order_info
+    ├── ORDER=2  ReportOrderDiscountService     → report_order_discount
+    ├── ORDER=3  ReportOrderDetailService       → report_order_detail
+    ├── ORDER=4  ReportOrderPayService          → report_order_pay
+    ├── ORDER=5  ReportRefundService            → report_refund
+    ├── ORDER=6  ReportRefundDetailService      → report_refund_detail
+    └── ORDER=11 ReportOrderInfoSnapshotService → report_order_info_snapshot
+
+第二阶段（ORDER >= 10，fix 按日重算汇总表，由 Redis 计数触发）
+    ├── ORDER=13 ReportSumMealtimeService       → 分餐次汇总
+    ├── ORDER=16 ReportSumPayService            → 支付渠道汇总
+    ├── ORDER=17 ReportSumPayMerService         → 商户支付汇总
+    ├── ORDER=18 ReportSumDishesService         → 菜品销售汇总
+    ├── ORDER=50 ReportAnalysisCustService      → 用户分析
+    └── ORDER=51 ReportAnalysisDishesSaleService→ 菜品销售分析
+```
+
+### 1.4 第二阶段核心逻辑（fix 重算模式）
+
+```java
+// ReportConsumerService.consumeOrderReport()
+void consumeOrderReport() {
+    for (TenantInfo tenant : allTenants) {
+        Executors.doInTenant(tenant.getId(), () -> {
+            RLock lock = RedisUtil.getLock(REPORT_ORDER_LOCK);
+            lock.lock(120, TimeUnit.MINUTES);
+            try {
+                List<ReportNotConsumeDTO> list = reportOrderInfoService.queryNotConsumeData();
+                // 菜品：按 orderDate 分组调 fix
+                // 其他：按 statisticDate 分组，依次调所有 ORDER>=10 的 fix()
+                reportOrderInfoService.updateOrderMsg(list); // 标记已消费
+            } finally { lock.unlock(); }
+        });
+    }
+}
+```
+
+**触发机制**：Redis 计数器每条消息递减，达阈值（默认100）触发 + XxlJob 定时兜底。
+
+---
+
+## 二、核心基础表概要
+
+### 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**：订单交易快照
+
+---
+
+## 三、退款数据处理（核心重点）
+
+### 3.1 存储模型
+
+```
+正向订单 → report_order_info（realAmount 为正）
+退款记录 → report_refund（realRefundAmount 为正）+ report_refund_detail
+同时更新 → report_order_info.orderRefundState + refundAmount
+```
+
+### 3.2 净消费金额计算（3种方式）
+
+**方式一：主表 refundAmount 减退（推荐）**
+```sql
+SELECT SUM(real_amount - IFNULL(refund_amount, 0)) AS netAmount
+FROM report_order_info WHERE pay_time BETWEEN #{start} AND #{end}
+```
+
+**方式二：排除全退**
+```sql
+WHERE order_refund_state IN (1, 3)
+```
+
+**方式三：关联 report_refund**
+```sql
+SELECT o.canteen_id, SUM(o.real_amount) AS consume, IFNULL(SUM(r.real_refund_amount), 0) AS refund
+FROM report_order_info o LEFT JOIN report_refund r ON o.order_id = r.order_id
+GROUP BY o.canteen_id
+```
+
+### 3.3 菜品级别退款
+
+```sql
+SELECT goods_dishes_name,
+    SUM(quantity - IFNULL(goods_refund_num, 0)) AS netQuantity,
+    SUM(total_amount - IFNULL(refund_amount, 0)) AS netAmount
+FROM report_order_detail WHERE detail_state IN (1, 3) GROUP BY goods_dishes_name
+```
+
+---
+
+## 四、账户流水报表
+
+### 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 | 商户充值 |
+
+---
+
+## 五、汇总表开发标准模式
+
+### 5.1 接口与实现
+
+```java
+@Service @Slf4j
+public class ReportSumXxxService implements ReportOrderConsumeService {
+    @Override public int getOrder() { return 15; } // 10-29普通，30+菜品，50+分析
+
+    @Override public void consume(OrderChangePO payload, ReportOrderInfoDTO baseInfo) {
+        // 标准版：留空，由 fix() 统一处理
+    }
+
+    @Override public void fix(ReportBaseParam param) {
+        LocalDateTime start = param.getStartPayTime(), end = param.getEndPayTime();
+        mapper.delete(Wrappers.<ReportSumXxx>lambdaQuery()
+            .between(ReportSumXxx::getStatisticDate, start.toLocalDate(), end.toLocalDate()));
+        mapper.initFix(start, end);
+    }
+}
+```
+
+### 5.2 fix SQL 模板
+
+```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(a.pay_time), a.canteen_id, a.canteen_name,
+        COUNT(*), SUM(a.real_amount),
+        SUM(IFNULL(a.refund_amount, 0)),
+        SUM(a.real_amount - IFNULL(a.refund_amount, 0))
+    FROM report_order_info a
+    WHERE a.pay_time BETWEEN #{startTime} AND #{endTime}
+    GROUP BY DATE(a.pay_time), a.canteen_id, a.canteen_name
+</insert>
+```
+
+### 5.3 查询接口（并行 + 权限）
+
+```java
+public ReportBaseTotalVO<XxxVO> pageSummary(XxxParam param) {
+    MgrUserAuthPO authPO = MgrUserAuthApi.getUserAuthPO();
+    CompletableFuture<List<XxxVO>> listF = supplyAsync(() -> mapper.listSummary(param, authPO));
+    CompletableFuture<XxxVO> totalF = supplyAsync(() -> mapper.getSummaryTotal(param, authPO));
+    CompletableFuture.allOf(listF, totalF).join();
+    return new ReportBaseTotalVO<>(PageVO.of(listF.join(), param.getPage()), totalF.join());
+}
+```
+
+权限 SQL：
+```xml
+<if test="'-1'.toString() != authPO.roleType.toString()">
+    AND EXISTS (SELECT null FROM mgr_role_org it1
+        WHERE a.org_id = it1.org_id AND it1.role_id = #{authPO.roleId})
+</if>
+```
+
+---
+
+## 六、汇总模型速查
+
+| 表 | 维度 | 金额 |
+|----|------|------|
+| 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 |
+
+---
+
+## 七、经营分析模块
+
+| 分析 | Service | 路由前缀 |
+|-----|---------|---------|
+| 营业额 | ReportAnalysisTurnoverService | `/summary/analysis/turnover/` |
+| 用户 | ReportAnalysisCustService (ORDER=50) | `/summary/analysis/cust/` |
+| 菜品 | ReportAnalysisDishesSaleService (ORDER=51) | `/summary/analysis/dishes/` |
+| 满意度 | ReportAnalysisEvaluateService | `/summary/analysis/evaluate/` |
+| 充值 | ReportAnalysisTurnoverService | `/summary/analysis/recharge/` |
+| 设备 | ReportAnalysisTurnoverService | `/summary/analysis/device/` |
+
+---
+
+## 八、公共模块
+
+- **报表错误日志**（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其他 |
+
+---
+
+## 九、MySQL only_full_group_by 规范（必须遵守）
+
+> MySQL 默认开启 `sql_mode=ONLY_FULL_GROUP_BY`，SELECT 中所有非聚合列必须出现在 GROUP BY 中，且 GROUP BY 表达式必须与 SELECT 表达式**完全一致**。
+
+### 核心规则
+
+**SELECT 的表达式 == GROUP BY 的表达式**（字符级别完全一致）
+
+### ❌ 错误示例（GROUP BY 与 SELECT 不一致）
+
+```xml
+<!-- 报错：Expression #1 of SELECT list is not in GROUP BY clause -->
+SELECT
+    DATE_FORMAT(roi.consume_time, '%Y-%m-%d') AS statisticDate,
+    SUM(roi.real_amount)                       AS totalAmount
+FROM report_order_info roi
+GROUP BY DATE(roi.consume_time)   <!-- ❌ DATE() ≠ DATE_FORMAT(..., '%Y-%m-%d') -->
+ORDER BY DATE(roi.consume_time)
+```
+
+### ✅ 正确示例（GROUP BY 与 SELECT 完全一致）
+
+```xml
+SELECT
+    DATE_FORMAT(roi.consume_time, '%Y-%m-%d') AS statisticDate,
+    SUM(roi.real_amount)                       AS totalAmount
+FROM report_order_info roi
+GROUP BY DATE_FORMAT(roi.consume_time, '%Y-%m-%d')   <!-- ✅ 与 SELECT 完全一致 -->
+ORDER BY DATE_FORMAT(roi.consume_time, '%Y-%m-%d')   <!-- ✅ ORDER BY 也保持一致 -->
+```
+
+### ❌ 错误示例（SELECT 含非聚合列未加入 GROUP BY）
+
+```xml
+SELECT
+    roi.canteen_id,
+    roi.canteen_name,                         <!-- ❌ 非聚合列未在 GROUP BY 中 -->
+    SUM(roi.real_amount) AS totalAmount
+FROM report_order_info roi
+GROUP BY roi.canteen_id
+```
+
+### ✅ 正确示例（所有非聚合列都在 GROUP BY 中）
+
+```xml
+SELECT
+    roi.canteen_id,
+    roi.canteen_name,
+    SUM(roi.real_amount) AS totalAmount
+FROM report_order_info roi
+GROUP BY roi.canteen_id, roi.canteen_name     <!-- ✅ 所有非聚合列都在 GROUP BY -->
+```
+
+### 检查清单
+
+- [ ] SELECT 中按日期分组时使用 `DATE_FORMAT(col, '%Y-%m-%d')`，**不要用 `DATE()`**
+- [ ] GROUP BY 表达式与 SELECT 中对应列**逐字相同**（复制粘贴而非重写）
+- [ ] ORDER BY 中同样使用与 GROUP BY 一致的表达式
+- [ ] SELECT 中所有非聚合列（无 SUM/COUNT/AVG/MAX/MIN 包裹）都出现在 GROUP BY 中
+
+---
+
+## 十、开发检查清单
+
+### 建表
+- [ ] 分组维度 + 金额汇总 + 审计字段（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）
+
+---
+
+## 十一、关键代码位置
+
+> 路径前缀均为 `core-report/.../statistics/`
+
+| 类型 | 路径 |
+|------|------|
+| MQ 监听器 | `config/mq/ReportOrderMQListener.java` / `ReportAccountMQListener.java` |
+| 消费调度 | `config/mq/service/ReportConsumerService.java` |
+| 订单基础表 | `order/basic/model/ReportOrderInfo.java` / `ReportRefund.java` |
+| 汇总 Service | `order/summary/service/ReportSumMealtimeService.java` / `ReportSumPayService.java` |
+| 分析 Service | `order/analysis/service/ReportAnalysisTurnoverService.java` |
+| 账户 Service | `account/service/ReportAccountSummaryService.java` |
+| Fix | `order/fix/controller/ReportFixController.java` |
+
+---
+
+## 注意
+
+- 标准版退款为独立表（正数金额），**不要使用 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-standard-customization/references/analysis-module.md

@@ -0,0 +1,64 @@
+# 经营分析模块详情
+
+## 分析类型总览
+
+| 分析类型 | Service | 接口数 | 路由前缀 |
+|---------|---------|-------|---------|
+| 营业额 | ReportAnalysisTurnoverService | 6 | `/summary/analysis/turnover/` |
+| 用户 | ReportAnalysisCustService (ORDER=50) | 8 | `/summary/analysis/cust/` |
+| 菜品 | ReportAnalysisDishesSaleService (ORDER=51) | 10 | `/summary/analysis/dishes/` |
+| 满意度 | ReportAnalysisEvaluateService | 2 | `/summary/analysis/evaluate/` |
+| 充值 | ReportAnalysisTurnoverService | 4 | `/summary/analysis/recharge/` |
+| 设备 | ReportAnalysisTurnoverService | 2 | `/summary/analysis/device/` |
+
+## 用户活跃度分析
+
+### 分段枚举
+
+- `AnalysisConsumeTimesEnum`：消费次数分段（1-10/10-20/20-30/30-40/40-50/>=50）
+- `AnalysisConsumeAmountEnum`：消费金额分段（<200/200-400/400-600/600-800/800-1000/>=1000元）
+- `AnalysisConsumeSlienceEnum`：沉默时长分段
+
+### 活跃度 VO
+
+```java
+// ReportAnalysisActiveVO
+activeNumber/activePercent   // 活跃用户（有消费记录）
+keepNumber/keepPercent       // 保留用户（持续消费）
+lossNumber/lossPercent       // 流失用户（不再消费）
+newNumber/newPercent         // 新增用户（首次消费）
+```
+
+## 公共参数类
+
+```java
+// ReportBaseParam（所有查询参数基类）
+PageDTO page;
+LocalDate startDate/endDate;
+LocalDate startOrderDate/endOrderDate;
+Integer sumType;           // 汇总类型（1按时段/2按日期）
+Integer sumDimension;      // 汇总维度
+List<Integer> ageTypes;
+List<Integer> holidayTypeList;
+List<String> exportCols;
+LocalDateTime startPayTime/endPayTime;
+
+// ReportNotConsumeDTO（未消费数据）
+String statisticDate;   // 统计日期（支付日期）
+String orderDate;       // 就餐日期（菜品统计专用）
+Long relationId;
+
+// 支付信息编码: "支付方式-支付渠道-支付金额" 如 "1-1-1200;2-4-1200"
+// 优惠信息编码: "变动类型,详情类型,金额" 如 "1,1,100;2,11,200"
+```
+
+## API 路由总览
+
+| 模块 | 前缀 | 核心接口 |
+|------|------|---------|
+| 营业收入明细 | `/summary/basic/` | flow/page, cust/page, remote/detail/page, remote/summary/page |
+| 订单汇总 | `/summary/order/` | organization/pay/type/classify/mealtime/dishes |
+| 账户流水 | `/summary/account/` | flow/cust/psn/organization/operator/consume/recharge/wallet/data |
+| 经营分析 | `/summary/analysis/` | turnover(6)/cust(8)/dishes(10)/recharge(4)/device(2)/evaluate(2) |
+| 数据修复 | `/summary/fix/` | order, account (限31天) |
+| 商户 | `/report/merchant/summary/` | consume, recharge |

package/.cursor/skills/leniu-report-standard-customization/references/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固定减免)