ai-engineering-init 1.16.3 → 1.16.4

package/.claude/skills/{leniu-java-amount-handling/SKILL.md → leniu-report-scenario/references/amount-handling.md}

@@ -1,16 +1,3 @@
----
-name: leniu-java-amount-handling
-description: |
-  leniu-tengyun-core 项目金额处理规范。金融系统中金额以分（Long 类型）存储，展示时转换为元。
-
-  触发场景：
-  - VO/Entity 类含金额字段（amountFen/amountYuan）
-  - MyBatis XML 查询含金额字段
-  - Excel 导出含金额列，需分转元
-  - 报表合计查询含金额汇总
-
-  触发词：金额处理、分转元、元转分、Long金额、money、fen、BigDecimal金额、金额字段
----
 
 # leniu-tengyun-core 金额处理规范
 

package/.claude/skills/{leniu-java-export/SKILL.md → leniu-report-scenario/references/export.md}

@@ -1,20 +1,3 @@
----
-name: leniu-java-export
-description: |
-  leniu-tengyun-core / leniu-yunshitang 项目数据导出规范。当实现数据导出功能时使用此skill，包括Excel异步导出和分页导出方案。
-
-  触发场景：
-  - 实现Excel数据导出（exportApi.startExcelExportTaskByPage）
-  - 实现异步导出（数据量大时）
-  - 实现分页导出（防内存溢出）
-  - 导出API接口设计（@PostMapping("/export")）
-
-  适用项目：
-  - 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
-
-  触发词：导出、Excel导出、异步导出、分页导出、@ExcelProperty、exportApi、数据导出
----
 
 # leniu-tengyun-core 数据导出规范
 

package/{.cursor/skills/leniu-mealtime/SKILL.md → .claude/skills/leniu-report-scenario/references/mealtime.md}

@@ -1,21 +1,3 @@
----
-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 餐次处理规范
 

package/{.codex/skills/leniu-java-report-query-param/SKILL.md → .claude/skills/leniu-report-scenario/references/query-param.md}

@@ -1,20 +1,3 @@
----
-name: leniu-java-report-query-param
-description: |
-  leniu-tengyun-core / leniu-yunshitang 项目报表查询入参规范。当创建报表Controller接口的查询入参Param类时使用此skill。
-
-  触发场景：
-  - 创建报表查询入参Param类（分页、时间范围、组织筛选）
-  - 设计报表接口的基类继承结构
-  - 配置导出列开关（exportColumns）
-  - 报表查询参数标准化
-
-  适用项目：
-  - 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
-
-  触发词：报表查询入参、Param类、分页参数、时间范围查询、ReportBaseParam、exportCols
----
 
 # leniu-tengyun-core 报表查询入参规范
 

package/.claude/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/{.codex/skills/leniu-java-total-line/SKILL.md → .claude/skills/leniu-report-scenario/references/total-line.md}

@@ -1,20 +1,3 @@
----
-name: leniu-java-total-line
-description: |
-  leniu-tengyun-core / leniu-yunshitang 项目合计行查询规范。当实现报表分页查询需要合计行功能时使用此skill。
-
-  触发场景：
-  - 实现报表分页查询合计行（Service层合计查询）
-  - 编写Mapper XML合计SQL（只返回数值字段）
-  - Controller层合计行数据组装
-  - 合计查询开关控制
-
-  适用项目：
-  - 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
-
-  触发词：合计行、totalLine、报表合计、SUM合计、ReportBaseTotalVO、合计查询
----
 
 # leniu-tengyun-core 合计行(Total Line)规范
 

package/.codex/skills/leniu-report-scenario/references/amount-handling.md

@@ -0,0 +1,448 @@
+
+# leniu-tengyun-core 金额处理规范
+
+## 两种金额存储模式
+
+项目中存在两种金额存储模式，根据业务模块选择：
+
+### 模式 A：Long（分）→ BigDecimal（元）[钱包/账户模块]
+
+适用于余额、充值、补贴等精度要求高的模块：
+
+- **数据库**：存储为 Long（分）
+- **Entity**：使用 Long 类型
+- **VO**：使用 BigDecimal 类型（MyBatis 自动转换分→元）
+- **Excel 导出**：使用 `CustomNumberConverter` 转换器
+
+### 模式 B：BigDecimal（分）[订单/报表模块]
+
+适用于订单金额、报表汇总等复杂计算模块：
+
+- **数据库**：存储为 BigDecimal（值为分，如 10000 = 100.00元）
+- **Entity**：直接使用 BigDecimal 类型（以分为单位）
+- **VO**：同样使用 BigDecimal（字段注释需标注单位）
+- **SQL SUM**：直接 `SUM(amount)`，不需要 /100
+
+> 参考：`OrderInfo.payableAmount`（BigDecimal，以分为单位）
+
+## 金额类型速查
+
+| 类型 | 用途 | 示例 |
+|------|------|------|
+| `Long` | 钱包/账户存储（分） | `private Long orderAmount; // 10000 = 100.00元` |
+| `BigDecimal` | 订单/报表存储（分） | `private BigDecimal payableAmount; // 10000 = 100.00元` |
+| `BigDecimal` | VO 展示（元，模式A） | `private BigDecimal amount; // 100.00` |
+
+## Entity（模式A：Long存储）
+
+```java
+import com.baomidou.mybatisplus.annotation.*;
+import io.swagger.annotations.ApiModel;
+import io.swagger.annotations.ApiModelProperty;
+import lombok.Data;
+
+@Data
+@TableName(value = "wallet_table", autoResultMap = true)
+public class WalletEntity {
+
+    @TableId
+    @ApiModelProperty(value = "钱包ID")
+    private Long id;
+
+    @ApiModelProperty(value = "余额（分）")
+    private Long balance;
+
+    @ApiModelProperty(value = "充值金额（分）")
+    private Long rechargeAmount;
+}
+```
+
+**要点**：
+- Entity 使用 `Long` 类型存储金额（分）
+- 字段注释明确标注"（分）"
+
+## Entity（模式B：BigDecimal存储，适用订单模块）
+
+```java
+@Data
+@TableName("order_info")
+public class OrderInfo {
+
+    @ApiModelProperty(value = "应付金额（分）")
+    private BigDecimal payableAmount;
+
+    @ApiModelProperty(value = "实付金额（分）")
+    private BigDecimal realAmount;
+
+    @ApiModelProperty(value = "优惠金额（分）")
+    private BigDecimal discountsAmount;
+}
+```
+
+**要点**：
+- 字段类型为 BigDecimal，但值以分为单位存储
+- 不需要 MyBatis 类型转换
+
+## VO（响应层）
+
+```java
+import com.alibaba.excel.annotation.ExcelProperty;
+import io.swagger.annotations.ApiModel;
+import io.swagger.annotations.ApiModelProperty;
+import lombok.Data;
+import lombok.experimental.Accessors;
+import net.xnzn.core.common.export.converter.CustomNumberConverter;
+
+import java.math.BigDecimal;
+
+@Data
+@Accessors(chain = true)
+@ApiModel("订单信息")
+public class OrderVO {
+
+    @ApiModelProperty("订单ID")
+    private Long id;
+
+    @ApiModelProperty("订单金额（元）")
+    @ExcelProperty(value = "订单金额（元）", converter = CustomNumberConverter.class)
+    private BigDecimal orderAmount;
+
+    @ApiModelProperty("优惠金额（元）")
+    @ExcelProperty(value = "优惠金额（元）", converter = CustomNumberConverter.class)
+    private BigDecimal discountAmount;
+
+    @ApiModelProperty("实付金额（元）")
+    @ExcelProperty(value = "实付金额（元）", converter = CustomNumberConverter.class)
+    private BigDecimal payAmount;
+}
+```
+
+**要点**：
+- VO 使用 `BigDecimal` 类型（元）
+- Excel 导出必须使用 `converter = CustomNumberConverter.class`
+- MyBatis 会自动将 Long 分转换为 BigDecimal 元
+
+## MyBatis XML 查询
+
+### 列表查询
+
+```xml
+<select id="listOrders" resultType="OrderVO">
+    SELECT
+        order_id,
+        order_amount,      -- ❌ 不要 /100.0
+        discount_amount,    -- ❌ 不要 /100.0
+        pay_amount          -- ❌ 不要 /100.0
+    FROM order_table
+    <where>...</where>
+    ORDER BY crtime DESC
+</select>
+```
+
+### 合计查询
+
+```xml
+<select id="getOrderTotal" resultType="OrderVO">
+    SELECT
+        SUM(order_amount) AS order_amount,    -- ❌ 不要 /100.0
+        SUM(discount_amount) AS discount_amount,-- ❌ 不要 /100.0
+        SUM(pay_amount) AS pay_amount       -- ❌ 不要 /100.0
+    FROM order_table
+    <where>...</where>
+</select>
+```
+
+**重要**：
+- 永远不要在 SQL 中使用 `/100.0`
+- 合计查询只返回数值字段，不返回非数值字段（如日期、名称）
+
+## 金额工具类
+
+### AmountUtil（分转元）
+
+```java
+import java.math.BigDecimal;
+import java.math.RoundingMode;
+
+/**
+ * 分与元金额转换
+ */
+public class AmountUtil {
+
+    /**
+     * 分转元（String）
+     */
+    public static String fen2YuanStr(Integer fen) {
+        if (fen == null) {
+            return "0.00";
+        }
+        BigDecimal amountFen = new BigDecimal(fen);
+        BigDecimal amountYuan = amountFen.divide(new BigDecimal("100"), 2, RoundingMode.HALF_UP);
+        return amountYuan.toPlainString();
+    }
+
+    /**
+     * 分转元（String 重载）
+     */
+    public static String fen2YuanStr(String fen) {
+        if (fen == null || fen.isEmpty()) {
+            return "0.00";
+        }
+        BigDecimal amountFen = new BigDecimal(fen);
+        BigDecimal amountYuan = amountFen.divide(new BigDecimal("100"), 2, RoundingMode.HALF_UP);
+        return amountYuan.toPlainString();
+    }
+
+    /**
+     * 分转元（BigDecimal）
+     */
+    public static BigDecimal fen2Yuan(Integer fen) {
+        if (fen == null) {
+            return BigDecimal.ZERO;
+        }
+        BigDecimal amountFen = new BigDecimal(fen);
+        return amountFen.divide(new BigDecimal("100"), 2, RoundingMode.HALF_UP);
+    }
+
+    /**
+     * 分转元（Long）
+     */
+    public static BigDecimal fen2Yuan(Long fen) {
+        if (fen == null) {
+            return BigDecimal.ZERO;
+        }
+        BigDecimal amountFen = new BigDecimal(fen);
+        return amountFen.divide(new BigDecimal("100"), 2, RoundingMode.HALF_UP);
+    }
+
+    /**
+     * 元转分
+     */
+    public static Integer yuan2Fen(String yuan) {
+        if (yuan == null || yuan.isEmpty()) {
+            return 0;
+        }
+        BigDecimal balance = new BigDecimal(yuan);
+        return Integer.parseInt(balance.multiply(new BigDecimal("100"))
+                                         .setScale(0, RoundingMode.HALF_UP)
+                                         .toPlainString());
+    }
+
+    /**
+     * 元转分（BigDecimal）
+     */
+    public static Integer yuan2Fen(BigDecimal yuan) {
+        if (yuan == null) {
+            return 0;
+        }
+        return yuan.multiply(new BigDecimal("100"))
+                  .setScale(0, RoundingMode.HALF_UP)
+                  .intValue();
+    }
+}
+```
+
+### 使用示例
+
+```java
+// 分转元
+Integer fenAmount = 10000;  // 10000分
+BigDecimal yuanAmount = AmountUtil.fen2Yuan(fenAmount);  // 100.00元
+
+// 元转分
+BigDecimal yuan = new BigDecimal("99.99");
+Integer fenAmount = AmountUtil.yuan2Fen(yuan);  // 9999分
+```
+
+## 常见场景
+
+### 场景1：订单报表 VO
+
+```java
+@Data
+@Accessors(chain = true)
+@ApiModel("订单报表")
+public class OrderReportVO {
+
+    @ExcelProperty(value = "月度", order = 1)
+    @ApiModelProperty("月度")
+    private String dateMonth;
+
+    @ExcelProperty(value = "订单总额（元）", order = 2, converter = CustomNumberConverter.class)
+    @ApiModelProperty("订单总额（元）")
+    private BigDecimal totalAmount;
+
+    @ExcelProperty(value = "订单数量", order = 3)
+    @ApiModelProperty("订单数量")
+    private Integer totalCount;
+
+    @ExcelProperty(value = "平均金额（元）", order = 4, converter = CustomNumberConverter.class)
+    @ApiModelProperty("平均金额（元）")
+    private BigDecimal avgAmount;
+}
+```
+
+### 场景2：工资汇总 VO
+
+```java
+@Data
+@Accessors(chain = true)
+@ApiModel("工资汇总")
+public class SalarySummaryVO {
+
+    @ExcelProperty(value = "月度", order = 1)
+    @ApiModelProperty("月度")
+    private String dateMonth;
+
+    @ExcelProperty(value = "基本工资（元）", order = 2, converter = CustomNumberConverter.class)
+    @ApiModelProperty("基本工资（元）")
+    private BigDecimal basicSalary;
+
+    @ExcelProperty(value = "绩效工资（元）", order = 3, converter = CustomNumberConverter.class)
+    @ApiModelProperty("绩效工资（元）")
+    private BigDecimal performanceSalary;
+
+    @ExcelProperty(value = "应发工资（元）", order = 4, converter = CustomNumberConverter.class)
+    @ApiModelProperty("应发工资（元）")
+    private BigDecimal totalSalary;
+}
+```
+
+### 场景3：合计行 SQL
+
+```xml
+<!-- 列表查询 -->
+<select id="pageSalary" resultType="SalarySummaryVO">
+    SELECT
+        date_month,
+        staff_count,
+        basic_salary,
+        performance_salary,
+        total_salary
+    FROM salary_summary
+    <where>...</where>
+    ORDER BY date_month DESC
+</select>
+
+<!-- 合计查询：只返回数值字段 -->
+<select id="getSalaryTotal" resultType="SalarySummaryVO">
+    SELECT
+        SUM(staff_count) AS staff_count,
+        SUM(basic_salary) AS basic_salary,
+        SUM(performance_salary) AS performance_salary,
+        SUM(total_salary) AS total_salary
+    FROM salary_summary
+    <where>...</where>
+</select>
+```
+
+### 场景4：平均值计算
+
+```xml
+<!-- 平均值计算（除零处理） -->
+CASE
+    WHEN SUM(staff_count) = 0 THEN 0
+    ELSE SUM(total_salary) / SUM(staff_count)
+END AS avgSalary
+
+<!-- 按维度平均 -->
+CASE
+    WHEN SUM(staff_count) = 0 THEN 0
+    ELSE SUM(total_salary) / COUNT(DISTINCT tenant_id)
+END AS avgSalary
+```
+
+## 数据流
+
+```
+数据库（Long/分） → MyBatis → VO（BigDecimal/元） → 前端（自动 /100）
+                                               ↓
+                                          Excel（converter /100）
+```
+
+## Excel 导出
+
+### 转换器
+
+```java
+@ExcelProperty(value = "订单金额（元）", converter = CustomNumberConverter.class)
+private BigDecimal orderAmount;
+```
+
+### 必要的导入
+
+```java
+import com.alibaba.excel.annotation.ExcelProperty;
+import net.xnzn.core.common.export.converter.CustomNumberConverter;
+```
+
+## 常见错误
+
+### 错误1：在 SQL 中使用 /100.0
+
+```xml
+<!-- ❌ 错误：在 SQL 中除以 100 -->
+SELECT
+    order_amount / 100.0 AS order_amount
+FROM order_table
+
+<!-- ✅ 正确：不进行除法，MyBatis 自动转换 -->
+SELECT
+    order_amount AS order_amount
+FROM order_table
+```
+
+### 错误2：钱包模块 Entity 使用 BigDecimal（模式A适用）
+
+```java
+// ❌ 错误：钱包/账户模块 Entity 使用 BigDecimal（应用 Long）
+@Data
+public class WalletEntity {
+    @ApiModelProperty("余额（元）")
+    private BigDecimal balance;
+}
+
+// ✅ 正确：钱包/账户模块 Entity 使用 Long（分）
+@Data
+public class WalletEntity {
+    @ApiModelProperty("余额（分）")
+    private Long balance;
+}
+```
+
+> **注意**：订单模块（OrderInfo）使用 BigDecimal 存储金额（以分为单位），这是模式B，属于正确用法，不是错误。
+
+### 错误3：VO 不使用转换器
+
+```java
+// ❌ 错误：Excel 导出不使用转换器
+@ExcelProperty(value = "订单金额（元）")
+private BigDecimal orderAmount;
+
+// ✅ 正确：使用 CustomNumberConverter
+@ExcelProperty(value = "订单金额（元）", converter = CustomNumberConverter.class)
+private BigDecimal orderAmount;
+```
+
+### 错误4：合计查询返回非数值字段
+
+```xml
+<!-- ❌ 错误：合计查询返回非数值字段 -->
+<select id="getOrderTotal" resultType="OrderVO">
+    SELECT
+        SUM(order_amount) AS order_amount,
+        order_date           -- ❌ 非数值字段
+    FROM order_table
+</select>
+
+<!-- ✅ 正确：只返回数值字段 -->
+<select id="getOrderTotal" resultType="OrderVO">
+    SELECT
+        SUM(order_amount) AS order_amount
+    FROM order_table
+</select>
+```
+
+## 参考文档
+
+详见：[leniu-tengyun-core 源码](/Users/xujiajun/Developer/gongsi_proj/core/leniu-tengyun-core)

package/.codex/skills/{leniu-java-export/SKILL.md → leniu-report-scenario/references/export.md}

@@ -1,20 +1,3 @@
----
-name: leniu-java-export
-description: |
-  leniu-tengyun-core / leniu-yunshitang 项目数据导出规范。当实现数据导出功能时使用此skill，包括Excel异步导出和分页导出方案。
-
-  触发场景：
-  - 实现Excel数据导出（exportApi.startExcelExportTaskByPage）
-  - 实现异步导出（数据量大时）
-  - 实现分页导出（防内存溢出）
-  - 导出API接口设计（@PostMapping("/export")）
-
-  适用项目：
-  - 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
-
-  触发词：导出、Excel导出、异步导出、分页导出、@ExcelProperty、exportApi、数据导出
----
 
 # leniu-tengyun-core 数据导出规范