迁移文档路径,将基础平台作为产品线下的产品之一

10-产品线/基础平台/功能模块/13-支行信息管理.md

@@ -0,0 +1,456 @@
+# 5.13 支行信息管理
+
+本文档从《基础平台产品设计》第 5 章拆分而来，用于独立描述基础平台功能模块的业务需求、规则和验收标准。
+
+上级文档：[基础平台产品设计](../基础平台产品设计.md)
+
+## 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 功能入口与访问权限
+
+支行信息管理作为基础平台基础资料管理功能，建议放置在基础平台左侧菜单：
+
+```text
+基础平台
+└── 支行信息管理
+```
+
+访问规则：
+
+- 平台管理员可维护支行信息。
+- 客户管理员默认不可维护系统级支行信息。
+- 普通业务用户不可访问支行信息管理页面。
+- 无支行信息管理权限的用户不展示支行信息管理菜单。
+
+### 5.13.7.2 页面结构
+
+支行信息管理采用“查询区 + 操作区 + 表格列表 + 抽屉表单”的结构。
+
+简化原型：
+
+```text
++------------------------------------------------------------------+
+| 查询区：关键字 / 总行 / 省份 / 城市 / 状态 / 查询 / 重置          |
++------------------------------------------------------------------+
+| 操作区：新增支行信息                                             |
++------------------------------------------------------------------+
+| 表格：总行编号 / 总行名称 / 支行号 / 支行名称 / 银行城市码        |
+|      省份 / 城市 / 支行地址 / 状态 / 更新时间 / 操作              |
++------------------------------------------------------------------+
+| 抽屉：新增 / 编辑支行信息                                        |
++------------------------------------------------------------------+
+```
+
+页面规则：
+
+- 查询区固定在页面顶部。
+- 查询条件较多时支持展开和收起。
+- 查询按钮作为查询表单最后一个表单元素。
+- 列表默认按更新时间倒序展示。
+- 表单使用右侧抽屉，宽度建议 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 查询支行信息
+
+入口路径：
+
+```text
+基础平台 > 支行信息管理
+```
+
+操作步骤：
+
+1. 进入支行信息管理页面。
+2. 输入关键字，或选择总行、省份、城市、状态。
+3. 点击查询。
+4. 系统展示符合条件的支行分页列表。
+5. 如需重新查询，点击重置后重新输入条件。
+
+### 5.13.9.2 新增支行信息
+
+入口路径：
+
+```text
+基础平台 > 支行信息管理 > 新增支行信息
+```
+
+操作步骤：
+
+1. 进入支行信息管理页面。
+2. 点击新增支行信息。
+3. 系统打开新增抽屉。
+4. 填写总行编号、总行名称、支行号、支行名称、支行地址。
+5. 按需填写银行侧城市编码。
+6. 按需选择省份和城市。
+7. 选择启用状态。
+8. 点击保存。
+9. 系统校验支行号唯一性、启用状态必填项和城市归属。
+10. 保存成功后关闭抽屉并刷新列表。
+
+### 5.13.9.3 编辑支行信息
+
+入口路径：
+
+```text
+基础平台 > 支行信息管理 > 编辑
+```
+
+操作步骤：
+
+1. 查询需要维护的支行信息。
+2. 点击编辑。
+3. 系统打开编辑抽屉并回显支行信息。
+4. 修改总行信息、支行信息、银行侧城市编码、行政省市或状态。
+5. 点击保存。
+6. 系统完成校验后保存。
+7. 保存成功后关闭抽屉并刷新列表。
+
+### 5.13.9.4 启用 / 停用支行信息
+
+入口路径：
+
+```text
+基础平台 > 支行信息管理 > 启用 / 停用
+```
+
+操作步骤：
+
+1. 查询需要处理的支行信息。
+2. 点击启用或停用。
+3. 系统弹出二次确认。
+4. 用户确认后系统更新状态。
+5. 状态更新成功后刷新列表。
+
+### 5.13.9.5 删除支行信息
+
+入口路径：
+
+```text
+基础平台 > 支行信息管理 > 删除
+```
+
+操作步骤：
+
+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。
+- 可按关键字、总行、省份、城市、状态查询支行信息。
+- 关键字可匹配总行编号、总行名称、支行号、支行名称、支行地址、银行侧城市编码。
+- 省份变化后，城市查询条件自动清空。
+- 新增支行信息时，启用状态下支行号和支行名称必填。
+- 支行号非空时必须校验全局唯一。
+- 支行号格式不合法时，前端和后端均必须阻断保存。
+- 城市非空但省份为空时，前端和后端均必须阻断保存。
+- 城市不属于所选省份时，前端和后端均必须阻断保存。
+- 银行侧城市编码与行政省市编码在页面上必须并列展示，不能混用。
+- 启用支行信息时，必须校验支行号和支行名称已填写。
+- 停用支行信息后，新增业务资料不可继续选择该支行。
+- 删除支行信息必须二次确认。
+- 存在业务引用的支行信息禁止删除。
+- 删除成功后，支行信息不在默认列表展示。
+- 支行信息新增、编辑、启停、删除均生成操作日志。