docs: 添加流水分析对接文档和数据库迁移计划

2026-03-02 09:52:28 +08:00
parent 4d94a3cd9d
commit a32af2fc37
11 changed files with 2410 additions and 605 deletions
--- a/doc/database/backup/ccdi_data.sql
+++ b/doc/database/backup/ccdi_data.sql
@@ -1,5 +1,5 @@
 -- CCDI 数据库数据
-- 导出时间: 2026-02-28 15:23:04
+-- 导出时间: 2026-02-28 15:26:26
 -- 源数据库: 116.62.17.81:3306/ccdi
 -- 字符集: utf8mb4

@@ -445,6 +445,6 @@ UNLOCK TABLES;
 /*!40101 SET COLLATION_CONNECTION=@OLD_COLLATION_CONNECTION */;
 /*!40111 SET SQL_NOTES=@OLD_SQL_NOTES */;

-- Dump completed on 2026-02-28 15:23:04
+-- Dump completed on 2026-02-28 15:26:26

 SET FOREIGN_KEY_CHECKS=1;
--- a/doc/database/backup/ccdi_structure.sql
+++ b/doc/database/backup/ccdi_structure.sql
@@ -1,5 +1,5 @@
 -- CCDI 数据库表结构
-- 导出时间: 2026-02-28 15:22:54
+-- 导出时间: 2026-02-28 15:26:16
 -- 源数据库: 116.62.17.81:3306/ccdi
 -- 字符集: utf8mb4

@@ -1092,4 +1092,4 @@ CREATE TABLE `sys_user_role` (
 /*!40101 SET COLLATION_CONNECTION=@OLD_COLLATION_CONNECTION */;
 /*!40111 SET SQL_NOTES=@OLD_SQL_NOTES */;

-- Dump completed on 2026-02-28 15:22:54
+-- Dump completed on 2026-02-28 15:26:16
--- a/doc/test-scripts/2026-02-28-frontend-test-report.md
+++ b/doc/test-scripts/2026-02-28-frontend-test-report.md
@@ -0,0 +1,308 @@
+# 前端功能测试报告
+
+## 测试概述
+
+**测试日期**: 2026-02-28
+**测试人员**: Claude Code
+**测试环境**:
+- 后端: http://localhost:8080
+- 前端: http://localhost:84
+- 浏览器: Chrome 145.0.0.0
+- 测试账号: admin/admin123
+
+## 测试目标
+
+验证项目管理页面状态统计数字显示正确，并在用户交互（搜索、分页、状态切换）过程中保持稳定。
+
+## 测试场景
+
+### ✅ 场景 1: 页面初始加载
+
+**操作步骤**:
+1. 访问前端应用 http://localhost:84
+2. 使用 admin/admin123 登录系统
+3. 导航到"初核项目管理"页面
+
+**预期结果**:
+- 页面正常加载
+- 标签页显示正确的统计数字
+- 两个 API 请求成功（list 和 statusCounts）
+
+**实际结果**: ✅ **通过**
+
+**验证数据**:
+- 标签页统计:
+  - 全部项目(29) ✅
+  - 进行中(27) ✅
+  - 已完成(1) ✅
+  - 已归档(1) ✅
+- 列表显示: 共 29 条 ✅
+- API 请求:
+  - `/ccdi/project/list?pageNum=1&pageSize=10` → 200 OK
+  - `/ccdi/project/statusCounts` → 200 OK
+
+**响应数据验证**:
+```json
+// list 接口响应
+{
+  "total": 29,
+  "rows": [ ...10条记录... ],
+  "code": 200,
+  "msg": "查询成功"
+}
+
+// statusCounts 接口响应
+{
+  "msg": "操作成功",
+  "code": 200,
+  "data": {
+    "all": 29,
+    "status0": 27,
+    "status1": 1,
+    "status2": 1
+  }
+}
+```
+
+---
+
+### ✅ 场景 2: 搜索功能
+
+**操作步骤**:
+1. 在搜索框输入 "测试4"
+2. 按回车键触发搜索
+
+**预期结果**:
+- 列表只显示匹配的项目
+- 标签页数字保持不变（显示总数）
+
+**实际结果**: ✅ **通过**
+
+**验证数据**:
+- 搜索结果: 1 条（测试4） ✅
+- 标签页统计（保持不变）:
+  - 全部项目(29) ✅
+  - 进行中(27) ✅
+  - 已完成(1) ✅
+  - 已归档(1) ✅
+- 分页显示: 共 1 条 ✅
+
+**API 请求验证**:
+```
+GET /ccdi/project/list?pageNum=1&pageSize=10&projectName=测试4 → 200 OK
+```
+
+---
+
+### ✅ 场景 3: 分页功能
+
+**操作步骤**:
+1. 清空搜索框，刷新页面恢复初始状态
+2. 点击分页组件的"2"按钮，切换到第 2 页
+
+**预期结果**:
+- 列表切换到第 2 页数据
+- 标签页数字保持不变
+
+**实际结果**: ✅ **通过**
+
+**验证数据**:
+- 当前页码: 第 2 页 ✅
+- 标签页统计（保持不变）:
+  - 全部项目(29) ✅
+  - 进行中(27) ✅
+  - 已完成(1) ✅
+  - 已归档(1) ✅
+- 分页显示: 共 29 条 ✅
+
+**API 请求验证**:
+```
+GET /ccdi/project/list?pageNum=2&pageSize=10 → 200 OK
+GET /ccdi/project/statusCounts → 200 OK
+```
+
+---
+
+### ✅ 场景 4: 状态切换功能
+
+**操作步骤**:
+1. 点击"进行中"标签
+
+**预期结果**:
+- 列表只显示"进行中"状态的项目
+- 标签页数字保持不变（仍显示总数）
+
+**实际结果**: ✅ **通过**
+
+**验证数据**:
+- 列表过滤: 所有项目状态都是"进行中" ✅
+- 标签页统计（保持不变）:
+  - 全部项目(29) ✅
+  - 进行中(27) ✅
+  - 已完成(1) ✅
+  - 已归档(1) ✅
+- 分页显示: 共 27 条（正确反映当前状态的项目数） ✅
+
+**API 请求验证**:
+```
+GET /ccdi/project/list?pageNum=1&pageSize=10&status=0 → 200 OK
+GET /ccdi/project/statusCounts → 200 OK
+```
+
+**响应数据验证**:
+```json
+// status=0 过滤后的列表
+{
+  "total": 27,
+  "rows": [
+    {"projectId": 31, "projectName": "测试123", "status": "0", ...},
+    {"projectId": 23, "projectName": "测试23", "status": "0", ...},
+    ...
+  ],
+  "code": 200,
+  "msg": "查询成功"
+}
+
+// 状态统计（始终返回总数）
+{
+  "msg": "操作成功",
+  "code": 200,
+  "data": {
+    "all": 29,
+    "status0": 27,
+    "status1": 1,
+    "status2": 1
+  }
+}
+```
+
+---
+
+### ✅ 场景 5: 浏览器控制台检查
+
+**操作步骤**:
+1. 打开浏览器开发者工具的 Console 标签
+
+**预期结果**:
+- 没有 JavaScript 错误
+- 看到两个 API 请求成功
+
+**实际结果**: ✅ **通过**
+
+**控制台消息**:
+- ✅ 没有 JavaScript 错误
+- ⚠️ 1 个警告: "A form field element should have an id or name attribute" (不影响功能)
+
+---
+
+## 网络请求统计
+
+**总请求数**: 40 个
+
+**关键 API 请求**:
+1. 初始加载:
+   - `/ccdi/project/list?pageNum=1&pageSize=10` → 200 OK
+   - `/ccdi/project/statusCounts` → 200 OK
+
+2. 搜索功能:
+   - `/ccdi/project/list?pageNum=1&pageSize=10&projectName=测试4` → 200 OK
+
+3. 分页功能:
+   - `/ccdi/project/list?pageNum=2&pageSize=10` → 200 OK
+   - `/ccdi/project/statusCounts` → 200 OK
+
+4. 状态切换:
+   - `/ccdi/project/list?pageNum=1&pageSize=10&status=0` → 200 OK
+   - `/ccdi/project/statusCounts` → 200 OK
+
+**所有请求状态**: ✅ 全部成功（200 OK）
+
+---
+
+## 核心修复验证
+
+### 问题回顾
+
+**原始问题**: 标签页数字随分页变化，不稳定
+
+**根本原因**: 前端使用列表响应的 total 字段来更新标签页数字，导致搜索/分页/过滤时数字会变化
+
+**解决方案**:
+1. 后端新增 `/statusCounts` 接口，始终返回所有状态的总数
+2. 前端在每次加载时并行请求 list 和 statusCounts
+3. 标签页数字只使用 statusCounts 的数据，不受列表过滤影响
+
+### 修复效果验证
+
+✅ **搜索时**: 标签页数字保持 29/27/1/1 不变
+✅ **分页时**: 标签页数字保持 29/27/1/1 不变
+✅ **状态切换时**: 标签页数字保持 29/27/1/1 不变
+
+---
+
+## 测试结论
+
+### ✅ 所有测试场景通过
+
+| 测试场景 | 状态 | 备注 |
+|---------|------|------|
+| 页面初始加载 | ✅ 通过 | 标签页数字正确显示 |
+| 搜索功能 | ✅ 通过 | 数字保持稳定 |
+| 分页功能 | ✅ 通过 | 数字保持稳定 |
+| 状态切换功能 | ✅ 通过 | 数字保持稳定 |
+| 浏览器控制台 | ✅ 通过 | 无 JavaScript 错误 |
+
+### 关键指标
+
+- ✅ **功能正确性**: 100% 通过
+- ✅ **数据一致性**: 标签页数字在所有操作中保持稳定
+- ✅ **用户体验**: 符合预期，数字显示直观清晰
+- ✅ **性能**: API 请求并行执行，响应迅速
+- ✅ **代码质量**: 无 JavaScript 错误，警告不影响功能
+
+### 建议
+
+1. ✅ **功能完善**: 建议将此修复方案应用到其他类似的列表页面
+2. ⚠️ **警告处理**: 建议为搜索框添加 id 或 name 属性以消除控制台警告
+3. ✅ **文档更新**: 更新用户手册，说明标签页数字表示总数而非当前过滤结果
+
+---
+
+## 附录
+
+### 测试环境信息
+
+```
+操作系统: Windows 11 Pro 10.0.26200
+浏览器: Chrome 145.0.0.0
+后端服务: http://localhost:8080
+前端服务: http://localhost:84
+数据库: MySQL 8.2.0
+Java 版本: 17
+Spring Boot 版本: 3.5.8
+Vue.js 版本: 2.6.12
+```
+
+### 相关文件
+
+**后端**:
+- `D:/ccdi/ccdi/ruoyi-info-collection/src/main/java/com/ruoyi/info/collection/domain/vo/ProjectStatusCountsVO.java`
+- `D:/ccdi/ccdi/ruoyi-info-collection/src/main/java/com/ruoyi/info/collection/service/ICcdiProjectService.java`
+- `D:/ccdi/ccdi/ruoyi-info-collection/src/main/java/com/ruoyi/info/collection/service/impl/CcdiProjectServiceImpl.java`
+- `D:/ccdi/ccdi/ruoyi-info-collection/src/main/java/com/ruoyi/info/collection/controller/CcdiProjectController.java`
+
+**前端**:
+- `D:/ccdi/ccdi/ruoyi-ui/src/api/ccdiProject.js`
+- `D:/ccdi/ccdi/ruoyi-ui/src/views/ccdiProject/index.vue`
+- `D:/ccdi/ccdi/ruoyi-ui/src/views/ccdiProject/components/SearchBar.vue`
+
+### 测试执行时间
+
+- 开始时间: 2026-02-28 09:46:48
+- 结束时间: 2026-02-28 09:50:00
+- 总耗时: 约 3 分钟
+
+---
+
+**测试人员签名**: Claude Code
+**测试日期**: 2026-02-28
--- a/doc/对接流水分析/task.md
+++ b/doc/对接流水分析/task.md
@@ -0,0 +1,7 @@
+# 系统需要对接流水分析平台，调用流水分析平台的接口
+- 新建一个模块ccdi_lsfx，保存所有调用流水分析平台的代码
+- 创建一个用于发起http请求的工具类，使用RestTemplate
+- 读取接口文档 D:\ccdi\ccdi\doc\对接流水分析\兰溪-流水分析对接.docx，分析每个接口的入参和返回值格式，封装入参和出参的对象
+- 在配置文档中添加每个接口对应的url配置
+- 在后端服务层中实现这些接口的调用，获取返回值
+- 创建一个控制层，可以调用这些接口，用于测试
--- a/doc/对接流水分析/兰溪-流水分析对接.docx
+++ b/doc/对接流水分析/兰溪-流水分析对接.docx
--- a/doc/对接流水分析/兰溪-流水分析对接.md
+++ b/doc/对接流水分析/兰溪-流水分析对接.md
@@ -0,0 +1,561 @@
+# 兰溪-流水分析对接文档
+
+## 概述
+
+本文档描述与**见知现金流尽调系统**的对接接口，用于拉取银行流水数据。
+
+---
+
+## 1. 新建项目并获取Token
+
+### 1.1 接口请求地址
+
+- **测试环境**: `http://158.234.196.5:82/c4c3/account/common/getToken`
+- **请求方法**: POST
+
+### 1.2 请求参数说明
+
+> 接口备注：第三方系统中，点击需要查看的项目向见知现金流尽调系统请求访问token，每个项目的token不同。现金流尽调系统根据 ProjectNo为唯一标识查找项目，如果对应的项目不存在则自动创建项目。注意token使用一次后即失效，再次访问项目需要重新申请。（支持拉取金综和行内流水）
+
+| 参数名 | 示例值 | 参数类型 | 是否必填 | 参数描述 |
+|--------|--------|----------|----------|----------|
+| projectNo | test-zjnx-1204 | String | 是 | 项目编号 |
+| entityName | 浙江农信test1204 | String | 是 | 项目名称 |
+| userId | test001 | String | 是 | 操作人员编号 |
+| userName | 测试001 | String | 是 | 操作人员姓名 |
+| appId | remote_app | String | 是 | 见知提供appId |
+| appSecretCode | 6ee87a361f29234ad25d7893da9975a9 | String | 是 | 安全码 md5(projectNo + "_" + entityName + "_" + appSecret) |
+| role | VIEWER | String | 否 | 人员角色（VIEWER：普通用户，READER：只读用户）默认值：VIEWER |
+| orgCode | 800000 | String | 是 | 行社机构号 |
+| entityId | ZJNX1234567890 | String | 否 | 企业统信码或个人身份证号 |
+| xdRelatedPersons | [{"relatedPerson":"上海上水纯净水有限公司","relation":"董事长"}] | String | 否 | 信贷关联人信息 |
+| jzDataDateId | 0 | String | 否 | 拉取指定日期推送过来的金综链流水，为0时标识不需要拉取金综链流水 |
+| innerBSStartDateId | 0 | String | 否 | 拉取行内流水开始日期，0:不需要拉取行内流水。流水分析系统根据entityId到数仓中查询行内流水 |
+| innerBSEndDateId | 0 | String | 否 | 拉取行内流水结束日期，0:不需要拉取行内流水。流水分析系统根据entityId到数仓中查询行内流水 |
+| analysisType | -1 | String | 是 | 固定值 |
+| departmentCode | 800111 | String | 是 | 客户经理所属营业部/分理处的机构编码 |
+
+### 1.3 返回参数说明
+
+#### 成功响应 (200)
+
+| 参数名 | 示例值 | 参数类型 | 参数描述 |
+|--------|--------|----------|----------|
+| code | 200 | String | 返回码 |
+| data.token | eyJ0eXAi... | String | token |
+| data.projectId | 77 | Integer | 见知项目Id |
+| data.projectNo | test-zjnx-1204 | String | 项目编号 |
+| data.entityName | 浙江农信test1204 | String | 项目名称 |
+| data.analysisType | 0 | Integer | 分析类型 |
+| message | create.token.success | String | 消息 |
+| status | 200 | String | 状态 |
+| successResponse | true | Boolean | 成功标识 |
+
+#### 错误码说明
+
+| 错误码 | 说明 |
+|--------|------|
+| 200 | 请求成功 |
+| 40100 | 未知异常 |
+| 40101 | appId错误 |
+| 40102 | appSecretCode错误 |
+| 40104 | 可使用项目次数为0，无法创建项目 |
+| 40105 | 只读模式下无法新建项目 |
+| 40106 | 错误的分析类型，不在规定的取值范围内 |
+| 40107 | 当前系统不支持的分析类型 |
+| 40108 | 当前用户所属行社无权限 |
+
+### 1.4 返回示例
+
+```json
+{
+  "code": "200",
+  "data": {
+    "token": "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9...",
+    "projectId": 77,
+    "projectNo": "test-zjnx-1204",
+    "entityName": "浙江农信test1204",
+    "analysisType": 0
+  },
+  "message": "create.token.success",
+  "status": "200",
+  "successResponse": true
+}
+```
+
+---
+
+## 2. 上传文件接口
+
+### 2.1 接口请求地址
+
+- **测试环境**: `158.234.196.5:82/c4c3/watson/api/project/remoteUploadSplitFile`
+- **请求方法**: POST
+- **请求头**: `X-Xencio-Client-Id: c2017e8d105c435a96f86373635b6a09`
+
+### 2.2 请求参数说明
+
+| 参数 | 类型 | 参数名称 | 是否必填 | 说明 |
+|------|------|----------|----------|------|
+| groupId | Int | 项目id | 是 | - |
+| files | File | 上传的文件 | 是 | - |
+
+### 2.3 响应结果信息
+
+| 字段 | 类型 | 备注 |
+|------|------|------|
+| code | String | 200成功，其他状态码失败 |
+| data | Object | 列表 |
+| accountName | - | 主体名称 |
+| accountNo | - | 账号 |
+| uploadFileName | - | 文件名称 |
+| fileSize | - | 文件大小，单位Byte |
+| status | - | 状态值 |
+| uploadStatusDesc | - | 文件状态描述 |
+| bank | - | 所属银行 |
+| currency | - | 币种 |
+| accountId | - | 账号id |
+| logId | - | 文件id |
+
+> **注意**: `status`等于-5且`uploadStatusDesc`等于`data.wait.confirm.newaccount`表示当前流水文件上传后解析成功。反之则没有成功。
+
+### 2.4 返回示例
+
+```json
+{
+  "code": "200",
+  "data": {
+    "accountsOfLog": {
+      "13976": [
+        {
+          "bank": "BSX",
+          "accountName": "",
+          "accountNo": "虞海良绍兴银行流水",
+          "currency": "CNY"
+        }
+      ]
+    },
+    "uploadLogList": [
+      {
+        "accountNoList": [],
+        "bankName": "BSX",
+        "dataTypeInfo": ["CSV", ","],
+        "downloadFileName": "虞海良绍兴银行流水.csv",
+        "enterpriseNameList": [],
+        "filePackageId": "14b13103010e4d32b5406c764cfe3644",
+        "fileSize": 46724,
+        "fileUploadBy": 448,
+        "fileUploadByUserName": "admin@support.com",
+        "fileUploadTime": "2025-03-12 18:53:29",
+        "leId": 10724,
+        "logId": 13976,
+        "logMeta": "{\"lostHeader\":[],\"balanceAmount\":true}",
+        "logType": "bankstatement",
+        "loginLeId": 10724,
+        "realBankName": "BSX",
+        "rows": 0,
+        "source": "http",
+        "status": -5,
+        "templateName": "BSX_T240925",
+        "totalRecords": 280,
+        "trxDateEndId": 20240905,
+        "trxDateStartId": 20230914,
+        "uploadFileName": "虞海良绍兴银行流水.csv",
+        "uploadStatusDesc": "data.wait.confirm.newaccount"
+      }
+    ],
+    "uploadStatus": 1
+  },
+  "status": "200",
+  "successResponse": true
+}
+```
+
+---
+
+## 3. 拉取行内流水接口
+
+### 3.1 接口请求地址
+
+- **测试环境**: `158.234.196.5:82/c4c3/watson/api/project/getJZFileOrZjrcuFile`
+- **请求方法**: POST
+- **请求头**: `X-Xencio-Client-Id: c2017e8d105c435a96f86373635b6a09`
+
+### 3.2 请求参数说明
+
+| 参数 | 类型 | 参数名称 | 是否必填 | 说明 |
+|------|------|----------|----------|------|
+| groupId | Int | 项目id | 是 | - |
+| customerNo | String | 客户身份证号 | 是 | - |
+| dataChannelCode | String | 校验码 | 是 | 固定值: ZJRCU |
+| requestDateId | Int | 发起请求的时间 | 是 | 当天请求时间 |
+| dataStartDateId | Int | 拉取开始日期 | 是 | - |
+| dataEndDateId | Int | 拉取结束日期 | 是 | - |
+| uploadUserId | int | 柜员号 | 是 | - |
+
+### 3.3 响应结果信息
+
+| 序号 | 字段 | 类型 | 备注 |
+|------|------|------|------|
+| 1 | code | String | 200成功，其他状态码失败 |
+| 2 | data | Object | 列表 |
+
+### 3.4 返回示例（无行内流水）
+
+```json
+{
+  "code": "200",
+  "data": {
+    "code": "501014",
+    "message": "无行内流水文件"
+  },
+  "status": "200",
+  "successResponse": true
+}
+```
+
+---
+
+## 4. 判断文件是否解析结束
+
+### 4.1 接口请求地址
+
+- **测试环境**: `http://158.234.196.5:82/c4c3/watson/api/project/upload/getpendings`
+- **请求方法**: POST
+- **请求头**: `X-Xencio-Client-Id: c2017e8d105c435a96f86373635b6a09`
+
+### 4.2 请求参数说明
+
+| 参数 | 类型 | 参数名称 | 是否必填 | 说明 |
+|------|------|----------|----------|------|
+| groupId | Int | 项目id | 是 | - |
+| inprogressList | String | 文件id | 是 | - |
+
+### 4.3 响应结果信息
+
+| 序号 | 字段 | 类型 | 备注 |
+|------|------|------|------|
+| 1 | code | String | 200成功，其他状态码失败 |
+| 2 | data | Object | 列表 |
+| 3 | uploadFileName | - | 上传文件名称 |
+| 4 | status | - | 文件解析后状态值 |
+| 5 | uploadStatusDesc | - | 文件解析后状态描述 |
+| 6 | parsing | - | 文件解析状态，true表示解析中，false表示解析结束 |
+
+> **注意**: 文件解析有个处理过程，`parsing`为false表示解析结束，可以轮询调用此接口，`status`等于-5且`uploadStatusDesc`等于`data.wait.confirm.newaccount`表示文件解析成功。
+
+### 4.4 返回示例
+
+```json
+{
+  "code": "200",
+  "data": {
+    "parsing": false,
+    "pendingList": [
+      {
+        "accountNoList": [],
+        "bankName": "ZJRCU",
+        "dataTypeInfo": ["CSV", ","],
+        "downloadFileName": "230902199012261247_20260201_20260201_1772096608615.csv",
+        "enterpriseNameList": [],
+        "filePackageId": "cde6c7cf5cab48e8892f0c1c36b2aa7d",
+        "fileSize": 53101,
+        "fileUploadBy": 448,
+        "fileUploadByUserName": "admin@support.com",
+        "fileUploadTime": "2026-02-27 09:50:18",
+        "isSplit": 0,
+        "leId": 16210,
+        "logId": 19116,
+        "logMeta": "{\"lostHeader\":[],\"balanceAmount\":true}",
+        "logType": "bankstatement",
+        "loginLeId": 16210,
+        "lostHeader": [],
+        "realBankName": "ZJRCU",
+        "rows": 0,
+        "source": "http",
+        "status": -5,
+        "templateName": "ZJRCU_T251114",
+        "totalRecords": 131,
+        "trxDateEndId": 20240228,
+        "trxDateStartId": 20240201,
+        "uploadFileName": "230902199012261247_20260201_20260201_1772096608615.csv",
+        "uploadStatusDesc": "data.wait.confirm.newaccount"
+      }
+    ]
+  },
+  "status": "200",
+  "successResponse": true
+}
+```
+
+---
+
+## 5. 生成尽调报告接口
+
+### 5.1 接口请求地址
+
+- **测试环境**: `158.234.196.5:82/c4c3/watson/api/project/confirmStageUploadLogs`
+- **请求方法**: POST
+- **请求头**: `X-Xencio-Client-Id: c2017e8d105c435a96f86373635b6a09`
+
+### 5.2 请求参数说明
+
+| 参数 | 类型 | 参数名称 | 是否必填 | 说明 |
+|------|------|----------|----------|------|
+| groupId | Int | 项目id | 是 | - |
+| logIds | Array | 文件id数组 | 是 | 上传几个文件就用几个 |
+| userLogin | Int | 登录柜员号 | 是 | - |
+
+### 5.3 响应结果信息
+
+| 序号 | 字段 | 类型 | 备注 |
+|------|------|------|------|
+| 1 | Code | String | 200成功，其他状态码失败 |
+| 2 | Data | Object | 列表 |
+
+### 5.4 返回示例
+
+```json
+{
+  "code": "200",
+  "data": {
+    "message": "upload.confirm.ok"
+  },
+  "status": "200",
+  "successResponse": true
+}
+```
+
+---
+
+## 6. 判断尽调报告是否生成
+
+### 6.1 接口请求地址
+
+- **测试环境**: `158.234.196.5:82/c4c3/watson/api/project/upload/getallpendings?groupId=#{groupId}`
+- **请求方法**: GET
+- **请求头**: `X-Xencio-Client-Id: c2017e8d105c435a96f86373635b6a09`
+
+### 6.2 请求参数说明
+
+| 参数 | 类型 | 参数名称 | 是否必填 | 说明 |
+|------|------|----------|----------|------|
+| groupId | Int | 项目id | 是 | - |
+
+### 6.3 响应结果信息
+
+| 序号 | 字段 | 类型 | 备注 |
+|------|------|------|------|
+| 1 | code | String | 200成功，其他状态码失败 |
+| 2 | data | Object | 列表 |
+
+> **注意**: 生成尽调报告有个处理过程，`pendingList`为[]表示处理结束，可以轮询调用此接口。
+
+### 6.4 返回示例
+
+```json
+{
+  "code": "200",
+  "data": {
+    "pendingList": []
+  },
+  "status": "200",
+  "successResponse": true
+}
+```
+
+---
+
+## 7. 获取流水列表并存储到兰溪本地
+
+### 7.1 接口请求地址
+
+- **测试环境**: `158.234.196.5:82/c4c3/watson/api/project/upload/getBankStatement`
+- **请求方法**: POST
+- **请求头**: `X-Xencio-Client-Id: c2017e8d105c435a96f86373635b6a09`
+
+### 7.2 请求参数说明
+
+| 参数 | 类型 | 参数名称 | 是否必填 | 说明 |
+|------|------|----------|----------|------|
+| groupId | Int | 项目id | 是 | - |
+| logId | Int | 文件id | 是 | - |
+| pageNow | Int | 当前页码 | 是 | - |
+| pageSize | Int | 查询条数 | 是 | - |
+
+### 7.3 响应结果信息
+
+| 序号 | 字段 | 类型 | 备注 |
+|------|------|------|------|
+| 1 | code | String | 200成功，其他状态码失败 |
+| 2 | data | Object | 列表 |
+| 3 | bankStatementList | - | 流水列表 |
+| 4 | pageable | - | 分页参数 |
+| 5 | searchable | - | 查询参数 |
+
+### 7.4 流水字段说明
+
+| 字段名 | 说明 | 示例值 |
+|--------|------|--------|
+| accountId | 账户ID | 0 |
+| accountMaskNo | 账号 | 6228580199062321798 |
+| accountingDate | 记账日期 | 2025-02-03 |
+| accountingDateId | 记账日期ID | 20250203 |
+| balanceAmount | 余额 | 85688.37 |
+| bank | 银行代码 | AI |
+| bankComments | 银行备注 | - |
+| bankStatementId | 流水ID | 4585279 |
+| catalogName | 交易名称 | 收单收入 |
+| crAmount | 贷方金额 | 290 |
+| currency | 币种 | CNY |
+| customerAccountMaskNo | 客户账号 | 80100001471621000100 |
+| customerAccountName | 客户账户名 | 系统内清算资金往来-全渠道收单平台 |
+| customerName | 客户名称 | 系统内清算资金往来-全渠道收单平台 |
+| drAmount | 借方金额 | 0 |
+| leName | 企业名称 | 徐设华 |
+| transAmount | 交易金额 | 290 |
+| transFlag | 交易标志 | R |
+| transTypeName | 交易名称 | 收单收入 |
+| trxDate | 交易日期 | 2025-02-03 00:00:00 |
+| userMemo | 用户备注 | 收单 |
+
+### 7.5 返回示例
+
+```json
+{
+  "code": "200",
+  "data": {
+    "bankStatementList": [
+      {
+        "accountId": 0,
+        "accountMaskNo": "6228580199062321798",
+        "accountingDate": "2025-02-03",
+        "accountingDateId": 20250203,
+        "archivingFlag": 0,
+        "attachments": 0,
+        "balanceAmount": 85688.37,
+        "bank": "AI",
+        "bankComments": "",
+        "bankStatementId": 4585279,
+        "bankTrxNumber": "",
+        "cashType": "",
+        "catalogName": "收单收入",
+        "commentsNum": 0,
+        "crAmount": 290,
+        "currency": "CNY",
+        "customNoteCount": 0,
+        "customerAccountMaskNo": "80100001471621000100",
+        "customerAccountName": "系统内清算资金往来-全渠道收单平台",
+        "customerId": 0,
+        "customerName": "系统内清算资金往来-全渠道收单平台",
+        "customerReference": "",
+        "downPaymentFlag": 0,
+        "drAmount": 0,
+        "hasCustomNote": 0,
+        "internalFlag": 0,
+        "isMarked": 0,
+        "leId": 16260,
+        "leName": "徐设华",
+        "sourceCatalogId": 405625,
+        "split": 0,
+        "subBankstatementId": 0,
+        "toDoFlag": 0,
+        "transAmount": 290,
+        "transFlag": "R",
+        "transTypeId": 405625,
+        "transTypeName": "收单收入",
+        "transformAmount": 290,
+        "transformCrAmount": 290,
+        "transformDrAmount": 0,
+        "transfromBalanceAmount": 85688.37,
+        "trxBalance": 0,
+        "trxDate": "2025-02-03 00:00:00",
+        "trxFlag": "R",
+        "userMemo": "收单"
+      }
+    ],
+    "pageable": {
+      "hasNext": true,
+      "hasPre": false,
+      "isFirst": true,
+      "isLast": false,
+      "pageNow": 1,
+      "pageSize": 1,
+      "startPos": 0,
+      "totalCount": 3392,
+      "totalPageCount": 3392
+    },
+    "searchable": {
+      "appInput": 0,
+      "dayFromId": 0,
+      "dayToId": 0,
+      "endDateId": 0,
+      "enterpriseId": 0,
+      "groupTypeId": 0,
+      "logId": 19060,
+      "pageNow": 1,
+      "pageSize": 1,
+      "showDownPayment": 0,
+      "startDateId": 0,
+      "trxAmount": 0,
+      "trxTypeId": 0,
+      "uploadFromDateId": 0,
+      "uploadToDateId": 0,
+      "useForBsSearch": 0,
+      "useNameExactMatching": 0,
+      "withOrderBy": true
+    }
+  },
+  "status": "200",
+  "successResponse": true
+}
+```
+
+---
+
+## 接口调用流程
+
+```
+┌─────────────────────────────────────────────────────────────────┐
+│  1. 初始化调用 /account/common/getToken 接口创建项目              │
+│     ↓                                                           │
+│  2. 调用 /remoteUploadSplitFile 接口上传文件                     │
+│     或调用 /getJZFileOrZjrcuFile 拉取行内流水                    │
+│     ↓                                                           │
+│  3. 调用 /getpendings 获取文件解析状态                           │
+│     - parsing=true 时，间隔1s轮询                               │
+│     - parsing=false 且 status=-5 表示解析成功                   │
+│     ↓                                                           │
+│  4. 调用 /confirmStageUploadLogs 接口生成尽调报告                │
+│     ↓                                                           │
+│  5. 调用 /getallpending 检查尽调报告生成状态                     │
+│     - pendingList 不为空时，间隔1s轮询                          │
+│     - pendingList=[] 表示生成完成                               │
+│     ↓                                                           │
+│  6. 调用 /getBankStatement 接口获取流水数据存储到兰溪本地         │
+└─────────────────────────────────────────────────────────────────┘
+```
+
+---
+
+## 生产环境配置
+
+| 配置项 | 值 |
+|--------|-----|
+| 生产IP | 64.202.32.176 |
+| 生产X-Xencio-Client-Id | 通过接口获取 |
+
+### 获取生产环境 Client-Id
+
+```
+GET http://64.202.32.176/c4c3/watson/api/common/GenerateAccessKey?userLogin={流水分析平台登录柜员号}
+```
+
+---
+
+## 附录：公共请求头
+
+| 请求头 | 值 | 说明 |
+|--------|-----|------|
+| X-Xencio-Client-Id | c2017e8d105c435a96f86373635b6a09 | 测试环境固定值 |
+| Content-Type | application/json | POST请求 |