支持拉取行内和金综流水

docs/plans/backend/2026-07-20-pull-bank-info-data-channel-backend-implementation.md

@@ -0,0 +1,20 @@
+# 拉取行内/金综流水后端实施计划
+
+## 背景
+
+项目详情页“上传数据”中的拉取流水能力需要支持两种来源：行内流水 `ZJRCU` 与金综流水 `JZL`。流水平台仍使用原 `/getJZFileOrZjrcuFile` 接口，一次请求只传一种 `dataChannelCode`。
+
+## 实施范围
+
+- `CcdiPullBankInfoSubmitDTO` 增加 `dataChannelCode`。
+- `CcdiFileUploadController#pullBankInfo` 校验流水来源，仅允许 `ZJRCU`、`JZL`。
+- `ICcdiFileUploadService#submitPullBankInfo` 与实现类透传来源。
+- `CcdiFileUploadServiceImpl#processPullBankInfoAsync` 按来源组装流水平台请求：
+  - `ZJRCU`：使用页面传入的开始、结束日期。
+  - `JZL`：`dataStartDateId=0`、`dataEndDateId=0`。
+- `LsfxConstants` 增加 `DATA_CHANNEL_JZL` 常量。
+
+## 验证计划
+
+- 运行 `CcdiFileUploadControllerTest`，验证 Controller 透传来源与金综不要求日期。
+- 运行 `CcdiFileUploadServiceImplTest`，验证金综请求传 `JZL` 与 `0/0` 日期参数。

docs/plans/frontend/2026-07-20-pull-bank-info-data-channel-frontend-implementation.md

@@ -0,0 +1,25 @@
+# 拉取行内/金综流水前端实施计划
+
+## 背景
+
+原弹窗只体现“拉取本行信息”，用户无法选择流水平台来源。新需求是在同一入口中区分拉取行内流水和拉取金综流水。
+
+## 实施范围
+
+- 将上传数据工具栏入口文案调整为“拉取流水”。
+- 将弹窗标题调整为“拉取行内/金综流水”。
+- 在弹窗中增加“流水类型”单选：
+  - 默认选择 `ZJRCU` 行内流水。
+  - 可切换为 `JZL` 金综流水。
+- 两种来源均沿用证件号码批量输入能力，多个证件号按列表提交给后端。
+- 行内流水保留时间跨度选择与近一年校验。
+- 金综流水隐藏时间跨度，提交时 `startDate/endDate` 传空，由后端固定转换为 `0/0`。
+- 类型备注按页面截图口径展示：
+  - 行内流水：`备注:仅支持获取近一年流水`。
+  - 金综流水：`备注:自动获取最近30天内授权的流水文件`。
+- 提交 payload 增加 `dataChannelCode`。
+
+## 验证计划
+
+- 前端构建检查。
+- 使用真实项目页面打开弹窗，确认默认行内、切换金综后隐藏时间跨度。

docs/reports/implementation/2026-07-20-pull-bank-info-data-channel.md

@@ -0,0 +1,44 @@
+# 拉取行内/金综流水来源选择实施记录
+
+## 修改内容
+
+- 后端拉取流水提交 DTO 增加 `dataChannelCode`。
+- 后端 Controller 校验流水来源，仅允许 `ZJRCU` 与 `JZL`。
+- 后端 Service 透传来源到流水平台请求。
+- 行内流水继续传页面日期；金综流水固定传 `dataStartDateId=0`、`dataEndDateId=0`。
+- 前端上传数据页入口改为“拉取流水”，弹窗增加行内/金综单选。
+- 前端选择金综流水时隐藏时间跨度，提交 `dataChannelCode=JZL`。
+- 行内和金综均支持多个证件号码批量提交，沿用原 `idCards` 列表。
+- 类型备注调整为截图口径，金综备注不再出现“时间参数”。
+
+## 影响范围
+
+- 项目详情页上传数据模块。
+- `/ccdi/file-upload/pull-bank-info` 接口。
+- 流水平台拉取行内/金综流水请求参数组装。
+
+## 验证情况
+
+- 后端单测通过：
+  - `mvn -pl ccdi-project -am test "-Dtest=CcdiFileUploadControllerTest,CcdiFileUploadServiceImplTest" "-Dsurefire.failIfNoSpecifiedTests=false"`
+  - 结果：40 个测试通过。
+- 前端构建通过：
+  - `.nvmrc` 指向 `14.21.3`，本机 `nvm use` 未读取版本参数；按本机已验证环境使用 Node `v22.22.3`、npm `10.9.8`。
+  - `npm run build:prod`
+  - 结果：构建成功，仅存在既有资源体积告警。
+- 真实页面验证通过：
+  - 启动真实 `ruoyi-admin.jar` 后端并访问 `http://127.0.0.1:62318/swagger-ui.html`，返回 200。
+  - 启动前端开发服务，实际访问地址为 `http://127.0.0.1:8089/`。
+  - 在真实项目详情页 `90342` 打开“拉取流水”弹窗，默认选中“拉取行内流水”并显示时间跨度。
+  - 切换“拉取金综流水”后，时间跨度隐藏。
+  - 金综备注显示为“备注:自动获取最近30天内授权的流水文件”。
+  - 复查行内备注显示为“备注:仅支持获取近一年流水”，金综备注未出现“时间参数”。
+  - 未点击“确认拉取”，未提交真实拉取任务。
+- 测试结束后已停止本轮启动的前端和后端进程，端口 `8088`、`8089`、`62318` 无本轮服务监听。
+
+## 提交前复验
+
+- 后端单测复验通过：`CcdiFileUploadControllerTest`、`CcdiFileUploadServiceImplTest` 共 40 个测试通过。
+- 前端生产构建复验通过：继续使用 Node `v22.22.3`、npm `10.9.8`，构建成功，仅存在既有资源体积告警。
+- 真实页面复验通过：访问 `http://127.0.0.1:8088/ccdiProject/detail/90342`，打开“拉取流水”弹窗后默认选中“拉取行内流水”；切换“拉取金综流水”后时间跨度隐藏；两条备注与截图一致，页面未出现“时间参数”。
+- 复验未点击“确定”，未提交真实拉取任务；复验结束后已停止后端 `62318` 与前端 `8088` 监听进程。