2.0 KiB
Raw Blame History

Final Verdict: sw-business-bank 银行代扣文件传输配置能力

当前结论

  • 状态Implemented
  • feature010-bank-transfer-config
  • 日期2026-03-24

已交付范围

  • 正式文档已补齐 REV-008 文件传输配置边界、统一解析优先级、安全约束与部署职责。
  • backend 已新增 FILE_TRANSFER_CONFIG 配置类型、统一文件传输解析器、SFTP/FTP 双协议解析能力,以及 send/back/reconcile 审计字段承接。
  • 已形成 baseline.mdbackend-validation.mddocs-validation.md 三类验证工件,可追溯本轮范围、基线和验证结果。
  • 已补充独立 Java smoke CLI 与 Docker 测试环境联动验证:BankTransferSftpSmokeClibank-transfer-test-sftp 验证通过,BankTransferFtpSmokeClibank-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 的录入约束同步进后台表单与校验逻辑。