ccdi/docs/plans/2026-03-02-lsfx-update-plan.md

流水分析接口更新实施计划

For Claude: REQUIRED SUB-SKILL: Use superpowers:executing-plans to implement this plan task-by-task.

目标: 按照新版接口文档完全重构流水分析模块，更新接口2、3、4、7，删除接口5、6

架构: 基于Spring Boot 3的REST API客户端模块，使用RestTemplate进行HTTP调用，Lombok简化DTO定义

技术栈: Spring Boot 3.5.8, Java 17, Lombok, RestTemplate, SpringDoc OpenAPI

前置条件:

• 项目已存在 ccdi-lsfx 模块
• 现有7个接口的DTO和Client已实现
• 需要参考新版文档：doc/对接流水分析/兰溪-流水分析对接-新版.md

---

任务概览

任务	说明	文件数
Task 1	更新配置文件	1
Task 2	删除废弃DTO类	3
Task 3	重构接口2（上传文件）Response	1
Task 4	重构接口3（拉取行内流水）Request和Response	2
Task 5	重构接口4（检查解析状态）Response	1
Task 6	重构接口7（获取流水）Request和Response	2
Task 7	更新Client客户端	1
Task 8	更新TestController	1
Task 9	编译验证和测试	-

---

Task 1: 更新配置文件

文件:

• 修改: ruoyi-admin/src/main/resources/application-dev.yml:105-130

步骤 1: 删除接口5和接口6的配置项

定位到 lsfx.api.endpoints 部分，删除以下两行：

      generate-report: /watson/api/project/confirmStageUploadLogs
      check-report-status: /watson/api/project/upload/getallpendings

步骤 2: 更新接口7的路径

修改 get-bank-statement 配置：

      # 旧路径：get-bank-statement: /watson/api/project/upload/getBankStatement
      get-bank-statement: /watson/api/project/getBSByLogId  # 新路径

步骤 3: 验证配置

完整的endpoints配置应该是：

    endpoints:
      get-token: /account/common/getToken
      upload-file: /watson/api/project/remoteUploadSplitFile
      fetch-inner-flow: /watson/api/project/getJZFileOrZjrcuFile
      check-parse-status: /watson/api/project/upload/getpendings
      get-bank-statement: /watson/api/project/getBSByLogId

步骤 4: 提交配置更新

git add ruoyi-admin/src/main/resources/application-dev.yml
git commit -m "config(lsfx): 删除接口5、6配置，更新接口7路径"

---

Task 2: 删除废弃DTO类

文件:

• 删除: ccdi-lsfx/src/main/java/com/ruoyi/lsfx/domain/request/GenerateReportRequest.java
• 删除: ccdi-lsfx/src/main/java/com/ruoyi/lsfx/domain/response/GenerateReportResponse.java
• 删除: ccdi-lsfx/src/main/java/com/ruoyi/lsfx/domain/response/CheckReportStatusResponse.java

步骤 1: 删除GenerateReportRequest.java

rm ccdi-lsfx/src/main/java/com/ruoyi/lsfx/domain/request/GenerateReportRequest.java

步骤 2: 删除GenerateReportResponse.java

rm ccdi-lsfx/src/main/java/com/ruoyi/lsfx/domain/response/GenerateReportResponse.java

步骤 3: 删除CheckReportStatusResponse.java

rm ccdi-lsfx/src/main/java/com/ruoyi/lsfx/domain/response/CheckReportStatusResponse.java

步骤 4: 提交删除操作

git add -A ccdi-lsfx/src/main/java/com/ruoyi/lsfx/domain/
git commit -m "refactor(lsfx): 删除接口5（生成报告）和接口6（检查报告状态）的DTO类"

---

Task 3: 重构接口2（上传文件）Response DTO

文件:

• 重写: ccdi-lsfx/src/main/java/com/ruoyi/lsfx/domain/response/UploadFileResponse.java

步骤 1: 完全重写UploadFileResponse.java

用以下完整代码替换整个文件：

package com.ruoyi.lsfx.domain.response;

import lombok.Data;
import java.util.List;
import java.util.Map;

/**
 * 上传文件响应（完整版，匹配新文档2.5节）
 */
@Data
public class UploadFileResponse {

    /** 返回码 */
    private String code;

    /** 状态 */
    private String status;

    /** 成功标识 */
    private Boolean successResponse;

    /** 响应数据 */
    private UploadData data;

    @Data
    public static class UploadData {
        /** 账号映射信息（key为logId） */
        private Map<String, List<AccountInfo>> accountsOfLog;

        /** 上传日志列表 */
        private List<UploadLogItem> uploadLogList;

        /** 上传状态 */
        private Integer uploadStatus;
    }

    @Data
    public static class AccountInfo {
        /** 所属银行 */
        private String bank;

        /** 账号名称 */
        private String accountName;

        /** 账号 */
        private String accountNo;

        /** 币种 */
        private String currency;
    }

    @Data
    public static class UploadLogItem {
        /** 账号列表 */
        private List<String> accountNoList;

        /** 银行名称 */
        private String bankName;

        /** 数据类型信息 [格式, 分隔符] */
        private List<String> dataTypeInfo;

        /** 下载文件名 */
        private String downloadFileName;

        /** 企业名称列表 */
        private List<String> enterpriseNameList;

        /** 文件包ID */
        private String filePackageId;

        /** 文件大小（字节） */
        private Long fileSize;

        /** 上传用户ID */
        private Integer fileUploadBy;

        /** 上传用户名 */
        private String fileUploadByUserName;

        /** 上传时间 */
        private String fileUploadTime;

        /** 企业ID */
        private Integer leId;

        /** 文件ID（重要） */
        private Integer logId;

        /** 日志元数据 */
        private String logMeta;

        /** 日志类型 */
        private String logType;

        /** 登录企业ID */
        private Integer loginLeId;

        /** 真实银行名称 */
        private String realBankName;

        /** 行数 */
        private Integer rows;

        /** 来源 */
        private String source;

        /** 状态（-5表示成功） */
        private Integer status;

        /** 模板名称 */
        private String templateName;

        /** 总记录数 */
        private Integer totalRecords;

        /** 交易结束日期ID */
        private Integer trxDateEndId;

        /** 交易开始日期ID */
        private Integer trxDateStartId;

        /** 上传文件名 */
        private String uploadFileName;

        /** 上传状态描述 */
        private String uploadStatusDesc;
    }
}

步骤 2: 提交更改

git add ccdi-lsfx/src/main/java/com/ruoyi/lsfx/domain/response/UploadFileResponse.java
git commit -m "refactor(lsfx): 重构接口2 Response，添加完整字段（accountsOfLog、uploadLogList）"

---

Task 4: 重构接口3（拉取行内流水）Request和Response DTO

文件:

• 重写: ccdi-lsfx/src/main/java/com/ruoyi/lsfx/domain/request/FetchInnerFlowRequest.java
• 重写: ccdi-lsfx/src/main/java/com/ruoyi/lsfx/domain/response/FetchInnerFlowResponse.java

步骤 1: 完全重写FetchInnerFlowRequest.java

用以下代码替换整个文件：

package com.ruoyi.lsfx.domain.request;

import lombok.Data;

/**
 * 拉取行内流水请求参数（匹配新文档3.2节）
 */
@Data
public class FetchInnerFlowRequest {

    /** 项目ID */
    private Integer groupId;

    /** 客户身份证号 */
    private String customerNo;

    /** 数据渠道编码（固定值：ZJRCU） */
    private String dataChannelCode;

    /** 发起请求的时间（格式：yyyyMMdd） */
    private Integer requestDateId;

    /** 拉取开始日期（格式：yyyyMMdd） */
    private Integer dataStartDateId;

    /** 拉取结束日期（格式：yyyyMMdd） */
    private Integer dataEndDateId;

    /** 柜员号 */
    private Integer uploadUserId;
}

步骤 2: 完全重写FetchInnerFlowResponse.java

用以下代码替换整个文件：

package com.ruoyi.lsfx.domain.response;

import lombok.Data;

/**
 * 拉取行内流水响应（匹配新文档3.5节）
 */
@Data
public class FetchInnerFlowResponse {

    /** 返回码 */
    private String code;

    /** 状态 */
    private String status;

    /** 成功标识 */
    private Boolean successResponse;

    /** 响应数据 */
    private FetchData data;

    @Data
    public static class FetchData {
        /** 状态码（如：501014表示无行内流水文件） */
        private String code;

        /** 消息（如：无行内流水文件） */
        private String message;
    }
}

步骤 3: 提交更改

git add ccdi-lsfx/src/main/java/com/ruoyi/lsfx/domain/request/FetchInnerFlowRequest.java
git add ccdi-lsfx/src/main/java/com/ruoyi/lsfx/domain/response/FetchInnerFlowResponse.java
git commit -m "refactor(lsfx): 重构接口3 Request/Response，修正参数名和字段结构"

---

Task 5: 重构接口4（检查解析状态）Response DTO

文件:

• 重写: ccdi-lsfx/src/main/java/com/ruoyi/lsfx/domain/response/CheckParseStatusResponse.java

步骤 1: 完全重写CheckParseStatusResponse.java

用以下代码替换整个文件：

package com.ruoyi.lsfx.domain.response;

import lombok.Data;
import java.util.List;

/**
 * 检查文件解析状态响应（匹配新文档4.5节）
 */
@Data
public class CheckParseStatusResponse {

    /** 返回码 */
    private String code;

    /** 状态 */
    private String status;

    /** 成功标识 */
    private Boolean successResponse;

    /** 响应数据 */
    private ParseStatusData data;

    @Data
    public static class ParseStatusData {
        /** 是否正在解析（true=解析中，false=解析结束）- 关键字段 */
        private Boolean parsing;

        /** 待处理文件列表 */
        private List<PendingItem> pendingList;
    }

    @Data
    public static class PendingItem {
        /** 账号列表 */
        private List<String> accountNoList;

        /** 银行名称 */
        private String bankName;

        /** 数据类型信息 */
        private List<String> dataTypeInfo;

        /** 下载文件名 */
        private String downloadFileName;

        /** 企业名称列表 */
        private List<String> enterpriseNameList;

        /** 文件包ID */
        private String filePackageId;

        /** 文件大小（字节） */
        private Long fileSize;

        /** 上传用户ID */
        private Integer fileUploadBy;

        /** 上传用户名 */
        private String fileUploadByUserName;

        /** 上传时间 */
        private String fileUploadTime;

        /** 是否拆分 */
        private Integer isSplit;

        /** 企业ID */
        private Integer leId;

        /** 文件ID（重要） */
        private Integer logId;

        /** 日志元数据 */
        private String logMeta;

        /** 日志类型 */
        private String logType;

        /** 登录企业ID */
        private Integer loginLeId;

        /** 丢失的表头 */
        private List<String> lostHeader;

        /** 真实银行名称 */
        private String realBankName;

        /** 行数 */
        private Integer rows;

        /** 来源 */
        private String source;

        /** 状态（-5表示成功） */
        private Integer status;

        /** 模板名称 */
        private String templateName;

        /** 总记录数 */
        private Integer totalRecords;

        /** 交易结束日期ID */
        private Integer trxDateEndId;

        /** 交易开始日期ID */
        private Integer trxDateStartId;

        /** 上传文件名 */
        private String uploadFileName;

        /** 上传状态描述（data.wait.confirm.newaccount表示成功） */
        private String uploadStatusDesc;
    }
}

步骤 2: 提交更改

git add ccdi-lsfx/src/main/java/com/ruoyi/lsfx/domain/response/CheckParseStatusResponse.java
git commit -m "refactor(lsfx): 重构接口4 Response，添加parsing字段和完整pendingList"

---

Task 6: 重构接口7（获取流水）Request和Response DTO

文件:

• 重写: ccdi-lsfx/src/main/java/com/ruoyi/lsfx/domain/request/GetBankStatementRequest.java
• 重写: ccdi-lsfx/src/main/java/com/ruoyi/lsfx/domain/response/GetBankStatementResponse.java

步骤 1: 完全重写GetBankStatementRequest.java

用以下代码替换整个文件：

package com.ruoyi.lsfx.domain.request;

import lombok.Data;

/**
 * 获取银行流水请求参数（匹配新文档6.2节）
 */
@Data
public class GetBankStatementRequest {

    /** 项目ID */
    private Integer groupId;

    /** 文件ID（新增必填参数） */
    private Integer logId;

    /** 当前页码（原pageNum） */
    private Integer pageNow;

    /** 每页数量 */
    private Integer pageSize;
}

步骤 2: 完全重写GetBankStatementResponse.java

用以下完整代码替换整个文件（包含40+字段的BankStatementItem）：

package com.ruoyi.lsfx.domain.response;

import lombok.Data;
import java.math.BigDecimal;
import java.util.List;

/**
 * 获取银行流水响应（匹配新文档6.5节）
 */
@Data
public class GetBankStatementResponse {

    /** 返回码 */
    private String code;

    /** 状态 */
    private String status;

    /** 成功标识 */
    private Boolean successResponse;

    /** 响应数据 */
    private BankStatementData data;

    @Data
    public static class BankStatementData {
        /** 流水列表 */
        private List<BankStatementItem> bankStatementList;

        /** 总条数 */
        private Integer totalCount;
    }

    @Data
    public static class BankStatementItem {
        // ===== 账号相关信息 =====

        /** 流水ID */
        private Long bankStatementId;

        /** 企业ID */
        private Integer leId;

        /** 账号ID */
        private Long accountId;

        /** 企业账号名称 */
        private String leName;

        /** 企业银行账号 */
        private String accountMaskNo;

        /** 账号日期ID */
        private Integer accountingDateId;

        /** 账号日期 */
        private String accountingDate;

        /** 交易日期 */
        private String trxDate;

        /** 币种 */
        private String currency;

        // ===== 交易金额 =====

        /** 付款金额 */
        private BigDecimal drAmount;

        /** 收款金额 */
        private BigDecimal crAmount;

        /** 余额 */
        private BigDecimal balanceAmount;

        /** 交易金额 */
        private BigDecimal transAmount;

        // ===== 交易类型和标志 =====

        /** 交易类型 */
        private String cashType;

        /** 交易标志位 */
        private String transFlag;

        /** 分类ID */
        private Integer transTypeId;

        /** 异常类型 */
        private String exceptionType;

        // ===== 对手方信息 =====

        /** 对手方企业ID */
        private Integer customerId;

        /** 对手方企业名称 */
        private String customerName;

        /** 对手方账号 */
        private String customerAccountMaskNo;

        /** 对手方银行 */
        private String customerBank;

        /** 对手方备注 */
        private String customerReference;

        // ===== 摘要和备注 =====

        /** 用户交易摘要 */
        private String userMemo;

        /** 银行交易摘要 */
        private String bankComments;

        /** 银行交易号 */
        private String bankTrxNumber;

        // ===== 银行信息 =====

        /** 所属银行缩写 */
        private String bank;

        // ===== 其他字段 =====

        /** 是否为内部交易 */
        private Integer internalFlag;

        /** 上传logId */
        private Integer batchId;

        /** 项目id */
        private Integer groupId;

        /** 覆盖标识 */
        private Long overrideBsId;

        /** 交易方式 */
        private String paymentMethod;

        /** 客户账号掩码号 */
        private String cretNo;

        // ===== 附加字段 =====

        /** 附件数量 */
        private Integer attachments;

        /** 评论数 */
        private Integer commentsNum;

        /** 归档标志 */
        private Integer archivingFlag;

        /** 下付款标志 */
        private Integer downPaymentFlag;

        /** 源目录ID */
        private Integer sourceCatalogId;

        /** 拆分标志 */
        private Integer split;

        /** 子流水ID */
        private Long subBankstatementId;

        /** 待办标志 */
        private Integer toDoFlag;

        /** 转换金额 */
        private BigDecimal transformAmount;

        /** 转换收款金额 */
        private BigDecimal transformCrAmount;

        /** 转换付款金额 */
        private BigDecimal transformDrAmount;

        /** 转换余额 */
        private BigDecimal transfromBalanceAmount;

        /** 交易余额 */
        private BigDecimal trxBalance;
    }
}

步骤 3: 提交更改

git add ccdi-lsfx/src/main/java/com/ruoyi/lsfx/domain/request/GetBankStatementRequest.java
git add ccdi-lsfx/src/main/java/com/ruoyi/lsfx/domain/response/GetBankStatementResponse.java
git commit -m "refactor(lsfx): 重构接口7 Request/Response，新路径、新参数、完整字段"

---

Task 7: 更新LsfxAnalysisClient客户端类

文件:

• 修改: ccdi-lsfx/src/main/java/com/ruoyi/lsfx/client/LsfxAnalysisClient.java

步骤 1: 删除接口5和接口6的相关代码

删除以下内容：

1. 删除字段注入（约第48-52行）：

    @Value("${lsfx.api.endpoints.generate-report}")
    private String generateReportEndpoint;

    @Value("${lsfx.api.endpoints.check-report-status}")
    private String checkReportStatusEndpoint;

2. 删除 generateReport() 方法（约第127-134行）

3. 删除 checkReportStatus() 方法（约第139-146行）

步骤 2: 更新import语句

确保import中已删除：

// 确保这些import被删除
import com.ruoyi.lsfx.domain.request.GenerateReportRequest;
import com.ruoyi.lsfx.domain.response.GenerateReportResponse;
import com.ruoyi.lsfx.domain.response.CheckReportStatusResponse;

步骤 3: 更新方法注释

更新 getBankStatement() 方法的注释：

/**
 * 获取银行流水（新版接口）
 * 注意：需要传入logId参数，参数名已从pageNum改为pageNow
 *
 * @param request 请求参数（groupId, logId, pageNow, pageSize）
 * @return 流水明细列表
 */
public GetBankStatementResponse getBankStatement(GetBankStatementRequest request) {
    String url = baseUrl + getBankStatementEndpoint;

    Map<String, String> headers = new HashMap<>();
    headers.put(LsfxConstants.HEADER_CLIENT_ID, clientId);

    return httpUtil.postJson(url, request, headers, GetBankStatementResponse.class);
}

步骤 4: 提交更改

git add ccdi-lsfx/src/main/java/com/ruoyi/lsfx/client/LsfxAnalysisClient.java
git commit -m "refactor(lsfx): Client删除接口5、6方法，更新接口7注释"

---

Task 8: 更新LsfxTestController测试控制器

文件:

• 修改: ccdi-lsfx/src/main/java/com/ruoyi/lsfx/controller/LsfxTestController.java

步骤 1: 删除接口5和接口6的测试方法

删除以下两个方法：

1. generateReport() 方法（约第697-703行）
2. checkReportStatus() 方法（约第705-711行）

步骤 2: 删除相关import

确保删除：

import com.ruoyi.lsfx.domain.request.GenerateReportRequest;
import com.ruoyi.lsfx.domain.response.GenerateReportResponse;
import com.ruoyi.lsfx.domain.response.CheckReportStatusResponse;

步骤 3: 更新接口7的Swagger注释和参数验证

更新 getBankStatement() 方法：

@Operation(summary = "获取银行流水列表（新版）",
           description = "分页获取指定文件的银行流水数据，需要提供logId参数")
@PostMapping("/getBankStatement")
public AjaxResult getBankStatement(@RequestBody GetBankStatementRequest request) {
    // 参数校验
    if (request.getGroupId() == null) {
        return AjaxResult.error("参数不完整：groupId为必填");
    }
    if (request.getLogId() == null) {
        return AjaxResult.error("参数不完整：logId为必填（文件ID）");
    }
    if (request.getPageNow() == null || request.getPageNow() < 1) {
        return AjaxResult.error("参数不完整：pageNow为必填且大于0");
    }
    if (request.getPageSize() == null || request.getPageSize() < 1) {
        return AjaxResult.error("参数不完整：pageSize为必填且大于0");
    }

    GetBankStatementResponse response = lsfxAnalysisClient.getBankStatement(request);
    return AjaxResult.success(response);
}

步骤 4: 提交更改

git add ccdi-lsfx/src/main/java/com/ruoyi/lsfx/controller/LsfxTestController.java
git commit -m "refactor(lsfx): Controller删除接口5、6测试接口，更新接口7参数验证"

---

Task 9: 编译验证和测试

步骤 1: 编译项目

mvn clean compile

预期输出:

[INFO] BUILD SUCCESS
[INFO] Total time: XX.XXX s

如果编译失败:

• 检查是否有残留的import语句引用已删除的类
• 检查DTO类中的字段类型是否正确
• 查看编译错误信息并修复

步骤 2: 启动应用

cd ruoyi-admin
mvn spring-boot:run

预期输出:

Application started successfully

步骤 3: 访问Swagger UI

浏览器访问：http://localhost:8080/swagger-ui/index.html

验证项:

1. ✅ 确认接口5（生成报告）和接口6（检查报告状态）已消失
2. ✅ 确认接口7的路径显示为 /lsfx/test/getBankStatement
3. ✅ 点击接口7，查看Schema，确认Request包含4个字段（groupId, logId, pageNow, pageSize）
4. ✅ 查看Response Schema，确认包含完整的BankStatementItem字段

步骤 4: 测试接口1（获取Token）

使用Swagger或curl测试：

curl -X POST http://localhost:8080/lsfx/test/getToken \
  -H "Content-Type: application/json" \
  -d '{
    "projectNo": "902000_'$(date +%s)'",
    "entityName": "测试项目",
    "userId": "902001",
    "userName": "902001",
    "orgCode": "902000",
    "departmentCode": "902000"
  }'

预期响应:

{
  "code": 200,
  "msg": "操作成功",
  "data": {
    "code": "200",
    "data": {
      "token": "eyJ0eXAi...",
      "projectId": 123,
      ...
    }
  }
}

步骤 5: 查看git状态

git status
git log --oneline -5

预期看到5个提交:

xxxxxxx refactor(lsfx): Controller删除接口5、6测试接口，更新接口7参数验证
xxxxxxx refactor(lsfx): Client删除接口5、6方法，更新接口7注释
xxxxxxx refactor(lsfx): 重构接口7 Request/Response，新路径、新参数、完整字段
xxxxxxx refactor(lsfx): 重构接口4 Response，添加parsing字段和完整pendingList
xxxxxxx refactor(lsfx): 重构接口3 Request/Response，修正参数名和字段结构
...

步骤 6: 创建总结报告

在 doc/implementation/ 目录下创建实施报告：

cat > doc/implementation/lsfx-update-report-$(date +%Y%m%d).md << 'EOF'
# 流水分析接口更新实施报告

## 实施日期
$(date +%Y-%m-%d)

## 更新内容

### 删除的接口
- 接口5：生成尽调报告（/watson/api/project/confirmStageUploadLogs）
- 接口6：检查报告生成状态（/watson/api/project/upload/getallpendings）

### 重构的接口
- 接口2：上传文件Response - 添加完整字段（accountsOfLog、uploadLogList）
- 接口3：拉取行内流水 - 修正Request参数名，重构Response结构
- 接口4：检查解析状态 - 添加parsing字段，完善pendingList结构
- 接口7：获取流水 - 新路径、新参数（logId、pageNow）、完整40+字段

### 保留的接口
- 接口1：获取Token - 无需修改

## 修改的文件统计
- 配置文件：1个
- 删除的DTO类：3个
- 重构的DTO类：6个
- 更新的Java类：2个
- 总计：12个文件

## 测试结果
- 编译状态：✅ 成功
- 启动状态：✅ 成功
- Swagger UI：✅ 接口正常显示
- 接口1测试：✅ 返回正常

## 待办事项
- [ ] 与前端联调测试新接口参数
- [ ] 生产环境配置更新
- [ ] 接口文档更新
EOF

步骤 7: 最终提交

git add doc/implementation/lsfx-update-report-*.md
git commit -m "docs(lsfx): 添加接口更新实施报告"
git log --oneline

---

验收标准

功能验收

• ✅ 项目编译无错误
• ✅ 应用启动成功
• ✅ Swagger UI正常访问
• ✅ 接口5、6已删除
• ✅ 接口2、3、4、7的Response字段完整
• ✅ 接口7使用新路径和新参数名

代码验收

• ✅ 无残留的import语句
• ✅ DTO类使用@Data注解
• ✅ 字段类型正确（Integer、String、BigDecimal等）
• ✅ 方法注释完整清晰

文档验收

• ✅ 配置文件注释清晰
• ✅ 实施报告完整
• ✅ 提交信息规范

---

故障排查指南

问题1：编译报错找不到类

原因： 残留的import语句 解决： 搜索并删除所有对GenerateReportRequest/Response和CheckReportStatusResponse的引用

问题2：启动报错配置项不存在

原因： Client中仍然注入已删除的配置项 解决： 检查LsfxAnalysisClient.java，删除generate-report和check-report-status的@Value注入

问题3：Swagger UI不显示接口

原因： Controller方法签名错误 解决： 检查LsfxTestController.java，确保所有方法都有@Operation注解

问题4：接口调用返回字段为null

原因： DTO字段名与API返回不匹配 解决： 对比新文档响应示例，确保字段名完全一致（区分大小写）

---

参考资料

• 新版接口文档：doc/对接流水分析/兰溪-流水分析对接-新版.md
• 设计文档：docs/plans/2026-03-02-lsfx-integration-design.md
• 若依框架规范：CLAUDE.md

---

计划完成日期： 2026-03-02 预计实施时间： 2-3小时 风险等级： 中（涉及多个DTO重构）