zd_product_document/40-平台与架构/基础平台/功能模块/13-支行信息管理.md

5.13 支行信息管理

本文档从《基础平台产品设计》第 5 章拆分而来，用于独立描述基础平台功能模块的业务需求、规则和验收标准。

上级文档：基础平台产品设计

5.13.1 功能说明

支行信息管理用于维护基础平台中的银行总行、支行、支行号、银行侧城市编码和行政省市映射资料，为结算、对账、分账、收付款、门店开户资料、供应商资料等业务系统提供统一的银行支行引用来源。

支行信息管理首版解决以下问题：

• 统一维护总行编号和总行名称。
• 统一维护支行号、支行名称和支行地址。
• 维护银行侧城市编码，并明确其与行政区域编码不是同一套编码体系。
• 维护省、市行政区域编码，便于按城市管理资料筛选和关联。
• 支持按总行、支行、支行号、银行城市码、省市和状态查询支行信息。
• 支持新增、编辑、启用、停用和删除支行信息。
• 为后续结算账户、门店账户、供应商账户引用提供稳定的银行支行数据来源。

支行信息管理不负责：

• 企业银行账户、门店账户、供应商账户维护。
• 银行卡号、账户号、户名一致性校验。
• 支付通道、银企直连、清算渠道或资金路由配置。
• 第三方银行联行号数据自动同步。
• 银行联行号全量导入。
• 银行侧城市码字典同步。
• 业务系统侧银行引用关系反向写入。

5.13.2 功能范围

• 支行信息维护
• 总行编号与总行名称维护
• 支行号、支行名称和支行地址维护
• 银行侧城市编码维护
• 省、市行政区域编码维护
• 启用 / 停用
• 删除前业务引用约束校验预留
• 支行分页查询
• 支行详情查询
• 总行筛选候选查询

5.13.3 管理对象

支行信息管理首版只维护一个管理对象：银行支行记录。

每条记录代表一个可被业务引用的银行支行或银行网点。

首版不拆分独立总行管理。总行编号和总行名称随支行记录保存，满足查询、展示和业务引用需要。后续如果出现总行独立生命周期、总行级配置、跨支行批量治理等需求，再评估拆分总行管理和支行管理。

5.13.4 字段要求

支行信息至少包括：

字段	说明	是否必填
总行编号	银行总行编码	否
总行名称	银行总行名称	否
支行号	支行号或联行号	启用时必填
支行名称	支行或网点名称	启用时必填
支行地址	支行详细地址	否
银行侧城市编码	银行数据源中的城市编码	否
省份	行政省份，来源于城市管理	否
城市	行政城市，来源于城市管理	否
启用状态	启用、停用	是
创建时间	支行信息创建时间	是
更新时间	支行信息最近更新时间	是
创建人	创建支行信息的用户	是
更新人	最近更新支行信息的用户	是

5.13.5 编码与映射规则

5.13.5.1 支行号规则

支行号用于业务系统引用具体银行支行或银行网点。

规则如下：

• 支行号非空时，在未删除数据内全局唯一。
• 支行号最长 64 个字符。
• 支行号非空时只允许字母、数字、短横线和下划线。
• 启用状态下，支行号必填。
• 支行号创建后允许编辑，但编辑时必须重新校验唯一性。
• 已被业务系统引用的支行号不建议修改；首版先预留引用检查和风险提示。

5.13.5.2 总行编号规则

总行编号用于按银行总行筛选和聚合支行信息。

规则如下：

• 总行编号最长 64 个字符。
• 总行编号允许为空。
• 总行编号相同的记录应尽量保持总行名称一致。
• 首版不强制维护总行编号唯一性。
• 总行编号和总行名称不构成独立总行档案。

5.13.5.3 城市编码映射规则

支行信息同时保存两套城市编码：

字段	编码体系	用途
银行侧城市编码	银行侧编码	银行联行、结算、开户行资料中的城市编码
省份	行政区域编码	按省份筛选、展示和对齐城市管理
城市	行政区域编码	按城市筛选、展示和对齐城市管理

规则如下：

• 银行侧城市编码不参与行政层级校验。
• 省份和城市来源于城市管理。
• 城市非空时，省份必填。
• 城市必须属于所选省份。
• 如果银行数据源只提供银行侧城市编码，允许先只填写银行侧城市编码，后续再补行政省市映射。
• 页面展示时优先显示行政省市名称；未匹配到城市主数据时显示原始编码，并给出弱提示。

5.13.6 业务规则

5.13.6.1 查询规则

• 支持按关键字模糊查询。
• 关键字匹配总行编号、总行名称、支行号、支行名称、支行地址和银行侧城市编码。
• 支持按总行筛选。
• 支持按省份、城市筛选。
• 支持按启用状态筛选。
• 省份变化后自动清空城市筛选。
• 列表默认按更新时间倒序展示。
• 默认每页 20 条。

5.13.6.2 新增规则

• 新增支行信息时，默认状态为启用。
• 启用状态下，支行号和支行名称必填。
• 支行号非空时必须校验全局唯一。
• 城市非空时必须先选择省份。
• 银行侧城市编码和行政省市可以同时为空，但不建议长期为空。

5.13.6.3 编辑规则

• 编辑支行信息时，允许修改总行编号、总行名称、支行号、支行名称、支行地址、银行侧城市编码、省份、城市和状态。
• 编辑支行号时必须重新校验唯一性。
• 已被结算账户、门店账户或供应商账户引用的支行信息，编辑关键字段时应给出风险提示。
• 已停用的支行信息仍可编辑。

5.13.6.4 启停规则

• 停用后，业务系统不应在新增业务资料时继续选择该支行。
• 停用不影响历史业务单据、历史账户资料和历史结算记录展示。
• 启用时必须校验支行号和支行名称已填写。

5.13.6.5 删除规则

• 删除采用软删除。
• 删除必须二次确认。
• 已被结算账户、门店账户、供应商账户等业务对象引用的支行信息，必须禁止删除。
• 首版可以先预留引用检查口；后续业务系统接入后必须补齐真实引用校验。
• 删除后不在默认列表展示。
• 删除后的支行号不建议复用；如后端允许复用，必须确保不会影响历史引用。

5.13.7 界面设计

5.13.7.1 功能入口与访问权限

支行信息管理作为基础平台基础资料管理功能，建议放置在基础平台左侧菜单：

基础平台
└── 支行信息管理

访问规则：

• 平台管理员可维护支行信息。
• 客户管理员默认不可维护系统级支行信息。
• 普通业务用户不可访问支行信息管理页面。
• 无支行信息管理权限的用户不展示支行信息管理菜单。

5.13.7.2 页面结构

支行信息管理采用“查询区 + 操作区 + 表格列表 + 抽屉表单”的结构。

简化原型：

+------------------------------------------------------------------+
| 查询区：关键字 / 总行 / 省份 / 城市 / 状态 / 查询 / 重置          |
+------------------------------------------------------------------+
| 操作区：新增支行信息                                             |
+------------------------------------------------------------------+
| 表格：总行编号 / 总行名称 / 支行号 / 支行名称 / 银行城市码        |
|      省份 / 城市 / 支行地址 / 状态 / 更新时间 / 操作              |
+------------------------------------------------------------------+
| 抽屉：新增 / 编辑支行信息                                        |
+------------------------------------------------------------------+

页面规则：

• 查询区固定在页面顶部。
• 查询条件较多时支持展开和收起。
• 查询按钮作为查询表单最后一个表单元素。
• 列表默认按更新时间倒序展示。
• 表单使用右侧抽屉，宽度建议 560-720px。
• 移动端或窄屏下，查询区折叠为多行，列表保持横向滚动，不压缩关键字段。

5.13.7.3 查询区

查询区字段：

字段	控件类型	值来源 / 录入方式	说明
关键字	文本输入框	人工录入	匹配总行编号、总行名称、支行号、支行名称、支行地址、银行侧城市编码
总行	远程下拉框	已有支行信息聚合出的总行候选	展示总行名称，提交总行编号
省份	下拉框 / 树形选择器	城市管理中的省份数据	选中后过滤城市候选
城市	下拉框 / 树形选择器	城市管理中的城市数据	省份变化后清空
状态	下拉框	启用、停用	默认全部
查询	按钮	用户点击	查询按钮放在查询条件最后
重置	按钮	用户点击	清空查询条件并重新查询

5.13.7.4 列表区

列表区展示支行分页数据。

展示方式：

• 表格。
• 默认每页 20 条。
• 支持分页切换。
• 支持横向滚动。

列表字段：

字段	展示方式	说明
总行编号	文本	为空显示 -
总行名称	文本	为空显示 -
支行号	文本	为空显示 -
支行名称	文本	为空显示 -
银行侧城市编码	文本	与行政城市编码并列展示
省份	文本 + Tooltip	优先展示省份名称，Tooltip 展示编码
城市	文本 + Tooltip	优先展示城市名称，Tooltip 展示编码
支行地址	文本省略 + Tooltip	过长省略
状态	Tag / Switch	启用、停用
更新时间	日期时间	最近更新时间
操作	按钮组	编辑、启用 / 停用、删除

行操作规则：

• 点击编辑，打开右侧编辑抽屉。
• 点击启用 / 停用，二次确认后更新状态。
• 点击删除，二次确认后执行软删除。
• 删除失败时，需要明确提示是否存在业务引用。
• 支行号为空时允许展示，但启用状态下不允许保存为空。

5.13.7.5 支行新增 / 编辑抽屉

支行新增 / 编辑抽屉用于维护单条支行信息。

展示方式：

• 右侧抽屉。
• 表单方式展示。
• 底部固定操作按钮：取消、保存。

表单字段：

字段	控件类型	值来源 / 录入方式	说明
总行编号	文本输入框	人工录入 / 选择总行后带入	最长 64 字符
总行名称	文本输入框	人工录入 / 选择总行后带入	最长 128 字符
支行号	文本输入框	人工录入	启用时必填，非空唯一
支行名称	文本输入框	人工录入	启用时必填
支行地址	文本输入框 / 多行文本框	人工录入	选填，最长 255 字符
银行侧城市编码	文本输入框	人工录入	选填，不等同于行政城市编码
省份	下拉框 / 树形选择器	城市管理中的省份数据	选填
城市	下拉框 / 树形选择器	城市管理中的城市数据	省份选择后加载
状态	Radio / Switch	启用、停用	必填，新增默认启用

表单规则：

• 保存前校验支行号唯一性。
• 启用状态下，支行号和支行名称必填。
• 支行号非空时只允许字母、数字、短横线和下划线。
• 城市非空时，省份必填。
• 省份变化后，城市自动清空。
• 银行侧城市编码旁需要展示提示：银行侧城市编码不等同于行政城市编码。
• 保存失败时保留表单内容，并展示明确错误信息。

5.13.7.6 支行详情页 / 弹窗

支行详情用于查看单条支行信息。

展示方式：

• 弹窗或抽屉。
• 只读描述列表。

展示区域：

区域	内容
总行信息	总行编号、总行名称
支行信息	支行号、支行名称、支行地址、启用状态
城市映射	银行侧城市编码、省份、城市
系统信息	创建时间、创建人、更新时间、更新人

5.13.8 字段校验

字段校验规则：

字段	校验规则
总行编号	选填，最长 64 字符
总行名称	选填，最长 128 字符
支行号	启用时必填，最长 64 字符，非空唯一，只允许字母、数字、短横线和下划线
支行名称	启用时必填，最长 255 字符
支行地址	选填，最长 255 字符
银行侧城市编码	选填，最长 64 字符
省份	选填，必须来源于城市管理
城市	选填，必须来源于城市管理；城市非空时省份必填
状态	必填，取值为启用、停用

5.13.9 使用导航

5.13.9.1 查询支行信息

入口路径：

基础平台 > 支行信息管理

操作步骤：

1. 进入支行信息管理页面。
2. 输入关键字，或选择总行、省份、城市、状态。
3. 点击查询。
4. 系统展示符合条件的支行分页列表。
5. 如需重新查询，点击重置后重新输入条件。

5.13.9.2 新增支行信息

入口路径：

基础平台 > 支行信息管理 > 新增支行信息

操作步骤：

1. 进入支行信息管理页面。
2. 点击新增支行信息。
3. 系统打开新增抽屉。
4. 填写总行编号、总行名称、支行号、支行名称、支行地址。
5. 按需填写银行侧城市编码。
6. 按需选择省份和城市。
7. 选择启用状态。
8. 点击保存。
9. 系统校验支行号唯一性、启用状态必填项和城市归属。
10. 保存成功后关闭抽屉并刷新列表。

5.13.9.3 编辑支行信息

入口路径：

基础平台 > 支行信息管理 > 编辑

操作步骤：

1. 查询需要维护的支行信息。
2. 点击编辑。
3. 系统打开编辑抽屉并回显支行信息。
4. 修改总行信息、支行信息、银行侧城市编码、行政省市或状态。
5. 点击保存。
6. 系统完成校验后保存。
7. 保存成功后关闭抽屉并刷新列表。

5.13.9.4 启用 / 停用支行信息

入口路径：

基础平台 > 支行信息管理 > 启用 / 停用

操作步骤：

1. 查询需要处理的支行信息。
2. 点击启用或停用。
3. 系统弹出二次确认。
4. 用户确认后系统更新状态。
5. 状态更新成功后刷新列表。

5.13.9.5 删除支行信息

入口路径：

基础平台 > 支行信息管理 > 删除

操作步骤：

1. 查询需要删除的支行信息。
2. 点击删除。
3. 系统弹出二次确认。
4. 用户确认后系统检查是否存在业务引用。
5. 如不存在引用，系统软删除支行信息并刷新列表。
6. 如存在引用，系统禁止删除并提示引用原因。

5.13.10 权限资源

支行信息管理建议纳入应用菜单与按钮资源治理。

权限资源建议如下：

权限资源	说明
system.bank.query	查询支行信息
system.bank.create	新增支行信息
system.bank.update	编辑支行信息
system.bank.update_status	启用 / 停用支行信息
system.bank.delete	删除支行信息

权限规则：

• 无查询权限，不展示支行信息管理菜单。
• 无新增权限，不展示新增支行信息按钮。
• 无编辑权限，不展示编辑按钮。
• 无启停权限，不展示启用 / 停用按钮。
• 无删除权限，不展示删除按钮。
• 后端接口必须进行真实权限校验，前端按钮显隐不能替代后端鉴权。

5.13.11 验收标准

• 支行信息管理菜单可按权限展示。
• 无权限用户不可访问支行信息管理页面。
• 支行列表默认分页大小为 20。
• 可按关键字、总行、省份、城市、状态查询支行信息。
• 关键字可匹配总行编号、总行名称、支行号、支行名称、支行地址、银行侧城市编码。
• 省份变化后，城市查询条件自动清空。
• 新增支行信息时，启用状态下支行号和支行名称必填。
• 支行号非空时必须校验全局唯一。
• 支行号格式不合法时，前端和后端均必须阻断保存。
• 城市非空但省份为空时，前端和后端均必须阻断保存。
• 城市不属于所选省份时，前端和后端均必须阻断保存。
• 银行侧城市编码与行政省市编码在页面上必须并列展示，不能混用。
• 启用支行信息时，必须校验支行号和支行名称已填写。
• 停用支行信息后，新增业务资料不可继续选择该支行。
• 删除支行信息必须二次确认。
• 存在业务引用的支行信息禁止删除。
• 删除成功后，支行信息不在默认列表展示。
• 支行信息新增、编辑、启停、删除均生成操作日志。