# 兴业银行联调基础配置确认表设计

## 目标

生成一份可由福建水务营收系统项目组与兴业银行共同填写、确认和回传的 Markdown 配置表，用于联调前的信息交换、网络开通、安全参数确认和责任边界核对。

## 文档定位

- 文档类型：兴业银行专项联调配置确认表。
- 使用阶段：联调准备、网络申请、配置交换和联调准入检查。
- 对接双方：兴业银行与福建水务营收系统项目组。
- 目标文件：`docs/evidence/bank-integration/兴业银行联调基础配置确认表.md`。

## 状态规则

每一项配置使用以下状态之一：

| 状态 | 含义 |
|---|---|
| 已确认 | 可由当前项目代码、正式文档或已验证环境直接确认 |
| 可预填 | 可根据当前实现预填，但仍需部署、运维或银行书面确认 |
| 待兴业银行提供 | 当前项目无法确定，需兴业银行提供 |
| 待我方提供 | 需我方运维、安全、业务或项目负责人提供 |
| 双方待确认 | 涉及双方共同选择或约定，不能由单方确定 |
| 不适用 | 经双方确认后不适用于本次联调范围 |

不得把本地 Docker 测试账号、密码、端口或样本目录标记为正式联调配置。

## 表格结构

### 1. 文档基本信息

记录银行名称、分支机构、项目名称、环境、文档版本、双方负责人和更新时间。银行名称与项目名称可预填，分支机构及联系人待补充。

### 2. 兴业银行提供给我方

包括：

- 银行测试环境接口地址、机构号、渠道号和商户号；
- 银行出口 IP、端口、访问方向和网络要求；
- SFTP/FTP 地址、端口、认证方式及送盘、回盘、对账目录；
- 数据格式、字符集、金额单位、日期格式和文件命名规则；
- 加密、签名、证书、时间戳、防重放和密钥交换规则；
- 正常与异常请求报文、送盘、回盘和对账样本；
- 错误码、超时、重试、对账和结算规则；
- 银行技术、业务及网络联系人。

### 3. 我方提供给兴业银行

包括：

- 福建水务营收系统联调环境域名、入口 IP、端口和 HTTPS 证书信息；
- 兴业银行需要访问的接口相对路径；
- 我方访问银行的固定出口 IP；
- 我方机构编码、租户/机构映射和测试客户数据；
- 我方支持的数据格式、加密能力和文件传输协议；
- 我方技术、业务、运维和安全联系人；
- 联调时间窗口、故障通知方式和日志查询信息。

接口路径只预填当前代码可确认的相对路径，不虚构正式域名、外网 IP 或端口。

### 4. 双方共同确认

包括联调范围、接口版本、环境用途、网络访问矩阵、幂等键、超时时间、重试次数、文件处理时点、对账日切、异常补偿、验收标准和上线切换方式。

### 5. 当前填写完成度

汇总：

- 已能从项目确认的内容；
- 可预填但需要复核的内容；
- 兴业银行必须提供的内容；
- 我方运维、安全和业务必须补充的内容；
- 阻止正式联调启动的关键缺口。

## 预填原则

当前可预填：

- 对接银行为兴业银行；
- 项目名称为福建水务营收系统；
- 当前实现支持 XML/JSON 报文转换；
- 当前文件传输解析支持 SFTP/FTP，正式联调推荐 SFTP；
- 当前接口类别包括欠费查询、实时缴费、缴费红冲、代扣/托收签解约、客户校验、送盘、回盘及状态查询；
- 当前网关存在 `/app-api/bankbusiness/**` 银行侧路由。

必须保持待确认：

- 兴业银行具体分支机构；
- 双方测试环境域名、IP、端口及白名单；
- 银行机构号、渠道号、商户号；
- 正式接口是否统一经网关访问；
- 兴业银行采用的加密、签名和证书规则；
- SFTP 地址、账号、目录及认证方式；
- 兴业银行私有报文和文件格式；
- 生产或联调密钥、密码、私钥。

## 安全约束

- 表内不记录密码、私钥、完整对称密钥或可直接使用的生产凭据。
- 敏感项只记录密钥编号、证书指纹、有效期、交换方式和责任人。
- IP、域名和证书信息在对外发送前由我方运维或安全人员复核。
- 所有本地 Docker smoke 参数只作为内部验证证据，不进入对外配置值。

## 完成标准

- 表格明确区分双方提供项和共同确认项。
- 所有预填值都有当前项目证据，不确定内容明确留空并标注责任方。
- 表格可以直接发送给兴业银行填写，不要求对方阅读项目源码或内部设计文档。
- 文档末尾明确给出当前是否具备接口预联调、网络联调和端到端业务联调条件。