33 lines
2.0 KiB
Markdown
33 lines
2.0 KiB
Markdown
# Final Verdict: sw-business-bank 银行代扣文件传输配置能力
|
||
|
||
## 当前结论
|
||
|
||
- 状态：Implemented
|
||
- feature：`010-bank-transfer-config`
|
||
- 日期：2026-03-24
|
||
|
||
## 已交付范围
|
||
|
||
- 正式文档已补齐 `REV-008` 文件传输配置边界、统一解析优先级、安全约束与部署职责。
|
||
- backend 已新增 `FILE_TRANSFER_CONFIG` 配置类型、统一文件传输解析器、`SFTP/FTP` 双协议解析能力，以及 send/back/reconcile 审计字段承接。
|
||
- 已形成 `baseline.md`、`backend-validation.md`、`docs-validation.md` 三类验证工件，可追溯本轮范围、基线和验证结果。
|
||
- 已补充独立 Java smoke CLI 与 Docker 测试环境联动验证：`BankTransferSftpSmokeCli` 对 `bank-transfer-test-sftp` 验证通过，`BankTransferFtpSmokeCli` 对 `bank-transfer-test-ftp` 验证通过，上传后再下载的样本 SHA256 一致。
|
||
|
||
## Deferred 范围
|
||
|
||
- 真实银行 `SFTP/FTP` 联调、生产凭据与白名单开通
|
||
- `BankCollection` 托收链路对等改造
|
||
- 运行态样本、真实回盘文件与生产环境故障演练补证
|
||
|
||
## 风险提示
|
||
|
||
- `bk_channel_api_config` 现有后台管理约束对 `FILE_TRANSFER_CONFIG` 采取“按 `configId` 管理、多条同 `channelId + apiType` 允许”的实现口径，后续若补运营端维护页面，需同步确认 UI/查询行为。
|
||
- 当前“已落库批次不漂移”已覆盖回盘目录与协议；若后续把对账、归档也提升为更严格的跨批次快照约束，需要补充更细粒度持久化字段。
|
||
- 当前 Docker smoke 证明了解析结果可驱动本地容器化 `SFTP/FTP` 收发，但不等同于真实银行网络、白名单、生产凭据和专有报文联调已完成。
|
||
|
||
## 下一步建议
|
||
|
||
1. 在测试或联调环境补 `SFTP/FTP` 真实连通性与样本文件验证。
|
||
2. 若要扩展到 `BankCollection`，优先复用同一解析器与合同，而不是复制第二套路径拼接逻辑。
|
||
3. 后续如新增运营配置入口，应把 `scopeType/businessType/tenantId/channelId` 的录入约束同步进后台表单与校验逻辑。
|