更新功能
This commit is contained in:
@@ -4,37 +4,701 @@
|
||||
|
||||
上级文档：[基础平台产品设计](../基础平台产品设计.md)
|
||||
|
||||
|
||||
## 5.8.1 功能说明
|
||||
|
||||
基础配置管理用于维护客户级、应用级基础参数。
|
||||
基础配置管理用于维护基础平台运行所需的平台级参数、客户级差异化参数、应用级接入参数和基础开关。
|
||||
|
||||
基础配置不承载业务系统的复杂业务规则。业务规则、业务流程、业务单据规则应放在对应业务系统中维护，例如对账规则放在连锁业务对账系统，分账规则放在分账系统，支付渠道规则放在聚合支付系统。
|
||||
|
||||
基础配置 1.0 重点解决：
|
||||
|
||||
- 配置可查询。
|
||||
- 配置可新增和修改。
|
||||
- 配置可启用和停用。
|
||||
- 配置变更可记录。
|
||||
- 配置值可结构化维护。
|
||||
- 配置版本冲突可识别和回滚。
|
||||
|
||||
## 5.8.2 功能范围
|
||||
|
||||
- 配置项管理
|
||||
- 配置值维护
|
||||
- 查询配置列表
|
||||
- 查看配置详情
|
||||
- 新增配置
|
||||
- 编辑配置
|
||||
- 启用 / 停用配置
|
||||
- 按客户配置
|
||||
- 按应用配置
|
||||
- 维护配置值
|
||||
- 查看配置版本
|
||||
- 回滚配置版本
|
||||
- 查看配置操作记录
|
||||
|
||||
## 5.8.3 配置分类
|
||||
## 5.8.3 推荐基础配置清单
|
||||
|
||||
1.0 支持：
|
||||
基础配置 1.0 建议按“先支撑基础平台运行，再支撑客户差异化，再支撑应用接入”的顺序建设。
|
||||
|
||||
- 平台配置
|
||||
- 客户配置
|
||||
- 应用配置
|
||||
- 业务开关
|
||||
### 5.8.3.1 平台运行配置
|
||||
|
||||
## 5.8.4 业务规则
|
||||
平台运行配置用于维护基础平台自身运行参数，由平台管理员维护。
|
||||
|
||||
- 平台配置仅平台管理员维护。
|
||||
- 客户配置仅影响当前客户。
|
||||
- 应用配置仅影响对应应用。
|
||||
- 配置变更需要记录操作日志。
|
||||
推荐配置：
|
||||
|
||||
## 5.8.5 验收标准
|
||||
| 配置名称 | 配置说明 | 配置层级 | 1.0 建议 |
|
||||
| --- | --- | --- | --- |
|
||||
| 平台名称 | 门户头部展示的平台名称 | 平台级 | 必须 |
|
||||
| 平台 Logo | 门户头部展示的 Logo 地址或资源标识 | 平台级 | 必须 |
|
||||
| 默认语言 | 用户未设置语言时的默认语言 | 平台级 | 必须 |
|
||||
| 默认主题 | 用户未设置主题时的默认主题 | 平台级 | 必须 |
|
||||
| 默认分页条数 | 列表页默认分页大小 | 平台级 | 必须 |
|
||||
| 文件上传大小限制 | 基础平台通用上传文件大小限制 | 平台级 | 建议 |
|
||||
| 导出文件有效期 | 导出文件可下载的有效时间 | 平台级 | 建议 |
|
||||
| 系统维护公告 | 平台维护、升级、停机提示内容 | 平台级 | 建议 |
|
||||
|
||||
- 可维护客户级配置。
|
||||
- 可维护应用级配置。
|
||||
- 配置变更后业务系统可读取到正确配置。
|
||||
### 5.8.3.2 登录与安全配置
|
||||
|
||||
登录与安全配置用于支撑统一登录、账号安全、Token 有效期和密码策略。
|
||||
|
||||
推荐配置：
|
||||
|
||||
| 配置名称 | 配置说明 | 配置层级 | 1.0 建议 |
|
||||
| --- | --- | --- | --- |
|
||||
| Token 有效期 | 用户登录后 Token 的有效时间 | 平台级 | 必须 |
|
||||
| Token 刷新有效期 | Token 可被刷新的最大时间范围 | 平台级 | 必须 |
|
||||
| 登录失败锁定次数 | 连续登录失败达到次数后锁定账号 | 平台级 | 必须 |
|
||||
| 登录失败锁定时长 | 账号被锁定后的自动解锁时长 | 平台级 | 必须 |
|
||||
| 初始密码生成规则 | 系统生成初始密码的规则 | 平台级 | 必须 |
|
||||
| 密码复杂度规则 | 密码长度、字符类型等要求 | 平台级 | 必须 |
|
||||
| 首次登录修改密码 | 新建平台账号首次登录是否强制改密 | 平台级 / 客户级 | 必须 |
|
||||
| 密码有效期 | 密码到期后是否要求修改 | 平台级 / 客户级 | 建议 |
|
||||
| 第三方账号绑定开关 | 是否允许绑定微信、企微、钉钉、飞书等第三方账号 | 平台级 / 客户级 | 建议 |
|
||||
|
||||
### 5.8.3.3 门户与应用容器配置
|
||||
|
||||
门户与应用容器配置用于支撑统一门户、菜单聚合、Tab 和 iframe 应用容器。
|
||||
|
||||
推荐配置：
|
||||
|
||||
| 配置名称 | 配置说明 | 配置层级 | 1.0 建议 |
|
||||
| --- | --- | --- | --- |
|
||||
| 默认首页 | 用户登录后默认打开的页面 | 平台级 / 客户级 | 必须 |
|
||||
| 常用菜单数量 | 头部常用菜单最多展示数量 | 平台级 | 建议 |
|
||||
| 最大打开 Tab 数 | 用户最多可同时打开的页面 Tab 数 | 平台级 | 必须 |
|
||||
| iframe Token 同步开关 | 是否向 iframe 应用同步 Token 状态 | 平台级 | 必须 |
|
||||
| iframe 页面超时处理 | iframe 应用无响应或 Token 失效时的处理方式 | 平台级 | 建议 |
|
||||
| 菜单折叠默认状态 | 左侧菜单默认展开或折叠 | 平台级 / 用户级 | 建议 |
|
||||
|
||||
### 5.8.3.4 客户级基础配置
|
||||
|
||||
客户级基础配置用于支持不同客户在基础平台中的差异化设置。
|
||||
|
||||
推荐配置：
|
||||
|
||||
| 配置名称 | 配置说明 | 配置层级 | 1.0 建议 |
|
||||
| --- | --- | --- | --- |
|
||||
| 客户显示名称 | 门户展示的客户名称或简称 | 客户级 | 必须 |
|
||||
| 客户默认行业 | 客户所属行业默认值 | 客户级 | 必须 |
|
||||
| 客户默认语言 | 当前客户用户默认语言 | 客户级 | 建议 |
|
||||
| 客户默认主题 | 当前客户用户默认主题 | 客户级 | 建议 |
|
||||
| 手机号唯一策略 | 手机号在客户内唯一或平台内唯一 | 客户级 | 必须 |
|
||||
| 是否允许多组织归属 | 用户是否允许归属于多个组织 | 客户级 | 必须 |
|
||||
| 是否允许客户自维护角色 | 客户管理员是否可新增和编辑自定义角色 | 客户级 | 必须 |
|
||||
| 是否允许客户自维护组织 | 客户管理员是否可维护组织架构 | 客户级 | 建议 |
|
||||
|
||||
### 5.8.3.5 应用级接入配置
|
||||
|
||||
应用级接入配置用于支撑业务应用接入基础平台后的通用控制。
|
||||
|
||||
推荐配置：
|
||||
|
||||
| 配置名称 | 配置说明 | 配置层级 | 1.0 建议 |
|
||||
| --- | --- | --- | --- |
|
||||
| 应用启用开关 | 应用是否允许被访问 | 应用级 | 必须 |
|
||||
| 应用默认打开方式 | iframe 嵌入或外部跳转 | 应用级 | 必须 |
|
||||
| 应用菜单缓存时长 | 应用菜单授权结果缓存时间 | 应用级 | 建议 |
|
||||
| 应用权限刷新策略 | 权限变更后应用获取最新权限的策略 | 应用级 | 建议 |
|
||||
| 应用 Token 校验策略 | 应用访问时是否每次校验 Token | 应用级 | 必须 |
|
||||
|
||||
### 5.8.3.6 消息与通知配置
|
||||
|
||||
消息与通知配置用于支撑基础平台消息、待办和系统通知。
|
||||
|
||||
推荐配置：
|
||||
|
||||
| 配置名称 | 配置说明 | 配置层级 | 1.0 建议 |
|
||||
| --- | --- | --- | --- |
|
||||
| 系统消息开关 | 是否启用基础平台系统消息 | 平台级 | 建议 |
|
||||
| 待办提醒开关 | 是否启用待办提醒 | 平台级 / 客户级 | 建议 |
|
||||
| 消息保留天数 | 系统消息保留时长 | 平台级 | 建议 |
|
||||
| 未读消息提醒间隔 | 门户轮询或刷新未读消息的间隔 | 平台级 | 可延后 |
|
||||
|
||||
### 5.8.3.7 审计与日志配置
|
||||
|
||||
审计与日志配置用于支撑操作日志和安全审计。
|
||||
|
||||
推荐配置：
|
||||
|
||||
| 配置名称 | 配置说明 | 配置层级 | 1.0 建议 |
|
||||
| --- | --- | --- | --- |
|
||||
| 操作日志保留天数 | 操作日志可查询和保留时间 | 平台级 | 必须 |
|
||||
| 登录日志保留天数 | 登录日志可查询和保留时间 | 平台级 | 必须 |
|
||||
| 敏感操作二次确认 | 停用客户、停用用户、重置密码等是否二次确认 | 平台级 | 必须 |
|
||||
| 敏感字段脱敏开关 | 手机号、账号标识等字段是否脱敏展示 | 平台级 / 客户级 | 必须 |
|
||||
|
||||
### 5.8.3.8 基础业务开关
|
||||
|
||||
基础业务开关用于控制基础平台自身功能是否启用。
|
||||
|
||||
推荐配置：
|
||||
|
||||
| 配置名称 | 配置说明 | 配置层级 | 1.0 建议 |
|
||||
| --- | --- | --- | --- |
|
||||
| 是否启用客户管理 | 控制客户管理功能是否开放 | 平台级 | 必须 |
|
||||
| 是否启用应用管理 | 控制应用管理功能是否开放 | 平台级 | 必须 |
|
||||
| 是否启用组织管理 | 控制组织管理功能是否开放 | 平台级 | 必须 |
|
||||
| 是否启用角色管理 | 控制角色管理功能是否开放 | 平台级 | 必须 |
|
||||
| 是否启用第三方登录 | 控制第三方登录入口是否开放 | 平台级 | 可延后 |
|
||||
| 是否启用外部协同接入 | 控制 2.0 外部协同能力是否开放 | 平台级 | 可延后 |
|
||||
|
||||
## 5.8.4 不建议纳入基础配置的内容
|
||||
|
||||
以下内容不建议放入基础配置管理，避免基础配置变成业务系统规则中心：
|
||||
|
||||
- 对账规则、差异处理规则、账单生成规则。
|
||||
- 分账规则、结算周期、清分规则、出款规则。
|
||||
- 支付通道费率、支付路由、退款规则。
|
||||
- 门店选址模型参数、评分权重。
|
||||
- 客服工单流转规则、补偿规则、客诉处理 SLA。
|
||||
- 商品、菜单、价格、库存、营销活动规则。
|
||||
- 组织架构、用户、角色、菜单本身的主数据。
|
||||
|
||||
上述内容应分别进入对应业务系统或对应基础模块维护。基础配置只维护基础平台运行所需的通用参数和开关。
|
||||
|
||||
## 5.8.5 字段要求
|
||||
|
||||
配置项基础信息至少包括：
|
||||
|
||||
| 字段 | 说明 | 是否必填 |
|
||||
| --- | --- | --- |
|
||||
| 配置名称 | 配置项展示名称 | 是 |
|
||||
| 配置编码 | 配置项唯一编码 | 是 |
|
||||
| 配置分类 | 平台运行、登录安全、门户容器、客户配置、应用配置、消息通知、审计日志、业务开关 | 是 |
|
||||
| 配置层级 | 平台级、客户级、应用级 | 是 |
|
||||
| 所属客户 | 客户级配置所属客户 | 条件必填 |
|
||||
| 所属应用 | 应用级配置所属应用 | 条件必填 |
|
||||
| 配置值类型 | JSON、文本、数字、布尔、枚举 | 是 |
|
||||
| 配置值 | 配置实际内容 | 是 |
|
||||
| 配置值预览 | 列表页展示的配置值摘要 | 否 |
|
||||
| 版本 | 配置当前版本号 | 是 |
|
||||
| 启用状态 | 启用、停用 | 是 |
|
||||
| 备注 | 配置说明 | 否 |
|
||||
| 创建时间 | 配置创建时间 | 是 |
|
||||
| 更新时间 | 配置最近更新时间 | 是 |
|
||||
|
||||
### 5.8.5.1 配置编码规则
|
||||
|
||||
配置编码用于系统读取配置、版本管理和操作日志追踪。
|
||||
|
||||
编码规则：
|
||||
|
||||
- 配置编码在同一配置层级和归属范围内唯一。
|
||||
- 平台级配置编码全局唯一。
|
||||
- 客户级配置编码在同一客户下唯一。
|
||||
- 应用级配置编码在同一应用下唯一。
|
||||
- 配置编码创建后原则上不允许修改。
|
||||
- 配置编码建议采用大写英文字母、数字和下划线组合。
|
||||
|
||||
编码示例：
|
||||
|
||||
| 配置分类 | 编码示例 |
|
||||
| --- | --- |
|
||||
| 登录安全 | TOKEN_EXPIRE_MINUTES |
|
||||
| 登录安全 | PASSWORD_COMPLEXITY_RULE |
|
||||
| 门户容器 | MAX_OPEN_TAB_COUNT |
|
||||
| 审计日志 | OPERATION_LOG_RETENTION_DAYS |
|
||||
| 基础开关 | ENABLE_THIRD_PARTY_LOGIN |
|
||||
|
||||
## 5.8.6 业务规则
|
||||
|
||||
- 平台级配置仅平台管理员维护。
|
||||
- 客户级配置仅影响当前客户。
|
||||
- 应用级配置仅影响对应应用。
|
||||
- 配置编码保存时必须校验唯一性。
|
||||
- 配置值保存前必须通过类型校验。
|
||||
- JSON 类型配置保存前必须是合法 JSON。
|
||||
- 配置启用后，业务功能读取启用状态配置。
|
||||
- 配置停用后，系统应按默认值或上级配置执行；没有默认值时，需要提示配置不可用。
|
||||
- 配置变更需要生成新版本。
|
||||
- 配置保存时需要校验当前版本，避免多人同时编辑导致覆盖。
|
||||
- 配置回滚时，需要生成新的配置版本，不直接覆盖历史版本。
|
||||
- 配置变更、启用、停用、回滚需要记录操作日志。
|
||||
|
||||
## 5.8.7 界面设计
|
||||
|
||||
### 5.8.7.1 功能入口与访问权限
|
||||
|
||||
基础配置管理作为基础平台管理功能，建议放置在基础平台左侧菜单，并按配置场景拆分页面：
|
||||
|
||||
```text
|
||||
基础平台
|
||||
└── 基础配置管理
|
||||
├── 平台运行配置
|
||||
├── 登录与安全配置
|
||||
├── 门户与应用容器配置
|
||||
├── 客户级配置
|
||||
├── 应用级接入配置
|
||||
├── 消息与通知配置
|
||||
├── 审计与日志配置
|
||||
├── 基础开关配置
|
||||
└── 配置项管理
|
||||
```
|
||||
|
||||
页面访问规则：
|
||||
|
||||
- 平台超级管理员可维护全部配置页面。
|
||||
- 实施人员可按授权范围维护客户级配置和应用级接入配置。
|
||||
- 客户管理员是否可维护客户级配置，由客户配置开关控制。
|
||||
- 产品管理员可按授权范围维护其负责应用的应用级接入配置。
|
||||
- 普通业务用户不可访问基础配置管理页面。
|
||||
- 无基础配置管理权限的用户不展示基础配置管理菜单。
|
||||
|
||||
设计原则：
|
||||
|
||||
- 场景化配置页面面向实施、运维、客户管理员，使用业务化表单，不直接暴露 JSON。
|
||||
- 配置项管理面向平台管理员和研发支持人员，作为底层配置项兜底维护页面。
|
||||
- 常用配置应优先进入场景化页面，不应要求使用者记忆配置编码。
|
||||
- 复杂结构化配置可在配置项管理中维护，但需要控制权限和操作审计。
|
||||
|
||||
### 5.8.7.2 平台运行配置页
|
||||
|
||||
平台运行配置页用于维护平台展示和通用运行参数。
|
||||
|
||||
展示方式：
|
||||
|
||||
- 采用分组表单展示。
|
||||
- 分组包括：平台展示、通用列表、文件与导出、系统公告。
|
||||
- 页面底部固定操作按钮：取消、保存。
|
||||
|
||||
表单字段：
|
||||
|
||||
| 字段 | 控件类型 | 值来源 / 录入方式 | 说明 |
|
||||
| --- | --- | --- | --- |
|
||||
| 平台名称 | 文本输入框 | 人工录入 | 门户头部展示名称 |
|
||||
| 平台 Logo | 图片上传 / 资源选择器 | 上传或选择平台资源 | 门户头部展示 Logo |
|
||||
| 默认语言 | 下拉框 | 语言字典 | 用户未设置语言时使用 |
|
||||
| 默认主题 | 下拉框 | 主题字典 | 用户未设置主题时使用 |
|
||||
| 默认分页条数 | 数字输入框 | 人工录入 | 列表页默认分页大小 |
|
||||
| 文件上传大小限制 | 数字输入框 + 单位选择 | 人工录入 | 通用上传限制 |
|
||||
| 导出文件有效期 | 数字输入框 + 单位选择 | 人工录入 | 导出文件可下载时长 |
|
||||
| 系统维护公告 | 多行文本框 | 人工录入 | 可为空 |
|
||||
| 启用状态 | Switch | 人工选择 | 控制该组配置是否启用 |
|
||||
|
||||
页面规则：
|
||||
|
||||
- 平台名称、默认语言、默认主题、默认分页条数为必填。
|
||||
- 保存后生成配置版本。
|
||||
- 修改平台展示类配置后，用户刷新门户时生效。
|
||||
|
||||
### 5.8.7.3 登录与安全配置页
|
||||
|
||||
登录与安全配置页用于维护统一登录、Token、账号密码和第三方账号绑定相关参数。
|
||||
|
||||
展示方式：
|
||||
|
||||
- 采用分组表单展示。
|
||||
- 分组包括：Token 策略、登录失败策略、密码策略、第三方账号策略。
|
||||
- 页面底部固定操作按钮：取消、保存。
|
||||
|
||||
表单字段：
|
||||
|
||||
| 字段 | 控件类型 | 值来源 / 录入方式 | 说明 |
|
||||
| --- | --- | --- | --- |
|
||||
| Token 有效期 | 数字输入框 + 单位选择 | 人工录入 | 必填 |
|
||||
| Token 刷新有效期 | 数字输入框 + 单位选择 | 人工录入 | 必填 |
|
||||
| 登录失败锁定次数 | 数字输入框 | 人工录入 | 必填 |
|
||||
| 登录失败锁定时长 | 数字输入框 + 单位选择 | 人工录入 | 必填 |
|
||||
| 初始密码生成规则 | 下拉框 / 表单组合 | 平台预置规则 | 必填 |
|
||||
| 密码最小长度 | 数字输入框 | 人工录入 | 必填 |
|
||||
| 密码复杂度要求 | Checkbox 组 | 大写字母、小写字母、数字、特殊字符 | 必填 |
|
||||
| 首次登录修改密码 | Switch | 人工选择 | 默认开启 |
|
||||
| 密码有效期 | 数字输入框 + 单位选择 | 人工录入 | 可为空 |
|
||||
| 允许第三方账号绑定 | Switch | 人工选择 | 控制微信、企微、钉钉、飞书绑定能力 |
|
||||
|
||||
页面规则：
|
||||
|
||||
- Token 刷新有效期应大于 Token 有效期。
|
||||
- 登录失败锁定次数必须大于 0。
|
||||
- 密码复杂度保存前需要校验规则完整性。
|
||||
- 影响登录安全的配置保存时需要二次确认。
|
||||
|
||||
### 5.8.7.4 门户与应用容器配置页
|
||||
|
||||
门户与应用容器配置页用于维护统一门户、Tab、菜单和 iframe 容器参数。
|
||||
|
||||
展示方式：
|
||||
|
||||
- 采用分组表单展示。
|
||||
- 分组包括：首页与菜单、Tab 管理、iframe 容器。
|
||||
|
||||
表单字段：
|
||||
|
||||
| 字段 | 控件类型 | 值来源 / 录入方式 | 说明 |
|
||||
| --- | --- | --- | --- |
|
||||
| 默认首页 | 页面选择器 / 菜单选择器 | 基础平台页面或已启用菜单 | 用户登录后默认打开页面 |
|
||||
| 常用菜单数量 | 数字输入框 | 人工录入 | 头部常用菜单最多展示数量 |
|
||||
| 最大打开 Tab 数 | 数字输入框 | 人工录入 | 必填 |
|
||||
| 菜单折叠默认状态 | 单选框 | 展开、折叠 | 默认展开 |
|
||||
| iframe Token 同步开关 | Switch | 人工选择 | 必须开启 |
|
||||
| iframe 页面超时处理 | 下拉框 | 提示重试、关闭页签、跳转错误页 | 必填 |
|
||||
|
||||
页面规则：
|
||||
|
||||
- 最大打开 Tab 数必须大于 0。
|
||||
- iframe Token 同步开关关闭时，需要提示会影响业务应用访问。
|
||||
- 默认首页必须是用户有权限访问的页面或菜单。
|
||||
|
||||
### 5.8.7.5 客户级配置页
|
||||
|
||||
客户级配置页用于维护某个客户在基础平台中的差异化设置。
|
||||
|
||||
展示方式：
|
||||
|
||||
- 顶部为客户选择器。
|
||||
- 下方为分组表单。
|
||||
- 客户管理员进入时默认当前客户，不展示客户选择器。
|
||||
|
||||
表单字段：
|
||||
|
||||
| 字段 | 控件类型 | 值来源 / 录入方式 | 说明 |
|
||||
| --- | --- | --- | --- |
|
||||
| 所属客户 | 客户选择器 / 只读文本 | 客户管理中已启用客户 | 平台用户选择；客户管理员只读当前客户 |
|
||||
| 客户显示名称 | 文本输入框 | 默认取客户简称 | 可覆盖门户展示名称 |
|
||||
| 客户默认语言 | 下拉框 | 语言字典 | 可为空，空则使用平台默认语言 |
|
||||
| 客户默认主题 | 下拉框 | 主题字典 | 可为空，空则使用平台默认主题 |
|
||||
| 手机号唯一策略 | 单选框 | 客户内唯一、平台内唯一 | 1.0 默认客户内唯一 |
|
||||
| 允许多组织归属 | Switch | 人工选择 | 控制用户是否可归属多个组织 |
|
||||
| 允许客户自维护角色 | Switch | 人工选择 | 控制客户管理员是否可维护自定义角色 |
|
||||
| 允许客户自维护组织 | Switch | 人工选择 | 控制客户管理员是否可维护组织 |
|
||||
|
||||
页面规则：
|
||||
|
||||
- 所属客户必填。
|
||||
- 手机号唯一策略变更时，需要提示对新增用户和账号校验的影响。
|
||||
- 客户级配置仅影响当前客户。
|
||||
|
||||
### 5.8.7.6 应用级接入配置页
|
||||
|
||||
应用级接入配置页用于维护业务应用接入基础平台后的通用访问控制参数。
|
||||
|
||||
展示方式：
|
||||
|
||||
- 顶部为应用选择器。
|
||||
- 下方为分组表单。
|
||||
- 产品管理员进入时默认展示其负责应用范围。
|
||||
|
||||
表单字段：
|
||||
|
||||
| 字段 | 控件类型 | 值来源 / 录入方式 | 说明 |
|
||||
| --- | --- | --- | --- |
|
||||
| 所属应用 | 应用选择器 / 只读文本 | 应用管理中已启用应用 | 必填 |
|
||||
| 应用启用开关 | Switch | 人工选择 | 控制应用是否允许被访问 |
|
||||
| 应用默认打开方式 | 单选框 | iframe 嵌入、外部跳转 | 1.0 默认 iframe 嵌入 |
|
||||
| 应用菜单缓存时长 | 数字输入框 + 单位选择 | 人工录入 | 可为空 |
|
||||
| 应用权限刷新策略 | 下拉框 | 每次获取、定时刷新、重新登录刷新 | 必填 |
|
||||
| 应用 Token 校验策略 | 下拉框 | 每次访问校验、关键访问校验 | 必填 |
|
||||
|
||||
页面规则：
|
||||
|
||||
- 所属应用必填。
|
||||
- 应用启用开关关闭后，所有客户用户不可访问该应用。
|
||||
- 应用默认打开方式需与应用管理中的应用入口类型保持一致。
|
||||
|
||||
### 5.8.7.7 消息与通知配置页
|
||||
|
||||
消息与通知配置页用于维护基础平台消息、待办和通知提醒参数。
|
||||
|
||||
展示方式：
|
||||
|
||||
- 采用分组表单展示。
|
||||
- 分组包括：系统消息、待办提醒、消息保留。
|
||||
|
||||
表单字段：
|
||||
|
||||
| 字段 | 控件类型 | 值来源 / 录入方式 | 说明 |
|
||||
| --- | --- | --- | --- |
|
||||
| 系统消息开关 | Switch | 人工选择 | 控制系统消息能力 |
|
||||
| 待办提醒开关 | Switch | 人工选择 | 控制待办提醒能力 |
|
||||
| 消息保留天数 | 数字输入框 | 人工录入 | 必填 |
|
||||
| 未读消息提醒间隔 | 数字输入框 + 单位选择 | 人工录入 | 可为空 |
|
||||
|
||||
页面规则：
|
||||
|
||||
- 消息保留天数必须大于 0。
|
||||
- 关闭系统消息开关时，需要提示消息提醒不可用。
|
||||
|
||||
### 5.8.7.8 审计与日志配置页
|
||||
|
||||
审计与日志配置页用于维护操作日志、登录日志和敏感操作控制参数。
|
||||
|
||||
展示方式：
|
||||
|
||||
- 采用分组表单展示。
|
||||
- 分组包括：日志保留、敏感操作、字段脱敏。
|
||||
|
||||
表单字段：
|
||||
|
||||
| 字段 | 控件类型 | 值来源 / 录入方式 | 说明 |
|
||||
| --- | --- | --- | --- |
|
||||
| 操作日志保留天数 | 数字输入框 | 人工录入 | 必填 |
|
||||
| 登录日志保留天数 | 数字输入框 | 人工录入 | 必填 |
|
||||
| 敏感操作二次确认 | Switch | 人工选择 | 默认开启 |
|
||||
| 敏感字段脱敏开关 | Switch | 人工选择 | 默认开启 |
|
||||
| 脱敏字段范围 | Checkbox 组 | 手机号、登录标识、客户联系人、备注 | 脱敏开启时展示 |
|
||||
|
||||
页面规则：
|
||||
|
||||
- 日志保留天数必须大于 0。
|
||||
- 关闭敏感操作二次确认或敏感字段脱敏时，需要二次确认。
|
||||
|
||||
### 5.8.7.9 基础开关配置页
|
||||
|
||||
基础开关配置页用于维护基础平台自身功能模块的启停开关。
|
||||
|
||||
展示方式：
|
||||
|
||||
- 采用开关列表展示。
|
||||
- 每个开关一行，展示功能名称、编码、状态、说明和操作。
|
||||
|
||||
列表字段：
|
||||
|
||||
| 字段 | 说明 |
|
||||
| --- | --- |
|
||||
| 功能名称 | 开关控制的功能模块名称 |
|
||||
| 功能编码 | 开关编码 |
|
||||
| 启用状态 | 启用、停用 |
|
||||
| 影响范围 | 该开关影响的菜单或能力 |
|
||||
| 备注 | 开关说明 |
|
||||
| 操作 | 启用、停用、查看版本 |
|
||||
|
||||
页面规则：
|
||||
|
||||
- 停用客户管理、应用管理、组织管理、角色管理等核心开关时，需要二次确认。
|
||||
- 停用功能后，对应菜单不可见，对应操作不可用。
|
||||
- 开关变更需要生成配置版本并记录操作日志。
|
||||
|
||||
### 5.8.7.10 配置项管理页
|
||||
|
||||
配置项管理页用于维护底层配置项定义和少量结构化配置，是场景化配置页面之外的兜底管理能力。
|
||||
|
||||
展示方式：
|
||||
|
||||
- 查询区域 + 数据表格。
|
||||
- 新增 / 编辑采用抽屉表单。
|
||||
- 抽屉包含基础信息和配置值编辑区。
|
||||
- 抽屉底部固定操作按钮：取消、保存。
|
||||
|
||||
适用场景：
|
||||
|
||||
- 新增尚未纳入场景化页面的配置项。
|
||||
- 查看配置编码、版本、状态、配置值预览。
|
||||
- 维护少量结构化 JSON 配置。
|
||||
- 查看版本记录并回滚。
|
||||
|
||||
查询条件：
|
||||
|
||||
| 查询项 | 控件类型 | 值来源 / 录入方式 | 说明 |
|
||||
| --- | --- | --- | --- |
|
||||
| 配置名称 | 文本输入框 | 人工录入 | 支持模糊查询 |
|
||||
| 配置编码 | 文本输入框 | 人工录入 | 支持精确或模糊查询 |
|
||||
| 配置分类 | 下拉框 | 配置分类字典 | 可为空 |
|
||||
| 配置层级 | 下拉框 | 平台级、客户级、应用级 | 可为空 |
|
||||
| 所属客户 | 客户选择器 | 客户管理中已启用客户 | 客户级配置使用 |
|
||||
| 所属应用 | 应用选择器 | 应用管理中已启用应用 | 应用级配置使用 |
|
||||
| 启用状态 | 下拉框 | 全部、启用、停用 | 默认全部 |
|
||||
| 查询 | 按钮 | 用户点击 | 作为查询区域最后一个表单元素 |
|
||||
|
||||
列表字段：
|
||||
|
||||
| 字段 | 说明 |
|
||||
| --- | --- |
|
||||
| 配置名称 | 配置项展示名称 |
|
||||
| 配置编码 | 配置项唯一编码 |
|
||||
| 配置分类 | 配置所属分类 |
|
||||
| 配置层级 | 平台级、客户级、应用级 |
|
||||
| 版本 | 当前版本号 |
|
||||
| 启用状态 | 启用、停用 |
|
||||
| 配置值预览 | 配置值摘要展示 |
|
||||
| 操作 | 查看、编辑、启用、停用、版本记录 |
|
||||
|
||||
抽屉基础信息字段：
|
||||
|
||||
| 字段 | 控件类型 | 值来源 / 录入方式 | 说明 |
|
||||
| --- | --- | --- | --- |
|
||||
| 配置名称 | 文本输入框 | 人工录入 | 必填 |
|
||||
| 配置编码 | 文本输入框 | 人工录入 | 必填，编辑时只读 |
|
||||
| 配置分类 | 下拉框 | 配置分类字典 | 必填 |
|
||||
| 配置层级 | 下拉框 | 平台级、客户级、应用级 | 必填 |
|
||||
| 所属客户 | 客户选择器 | 客户管理中已启用客户 | 客户级配置必填 |
|
||||
| 所属应用 | 应用选择器 | 应用管理中已启用应用 | 应用级配置必填 |
|
||||
| 配置值类型 | 下拉框 | JSON、文本、数字、布尔、枚举 | 必填 |
|
||||
| 启用状态 | Switch | 人工选择 | 默认启用 |
|
||||
| 版本 | 只读文本 | 当前配置版本 | 系统自动带入 |
|
||||
| 备注 | 多行文本框 | 人工录入 | 选填 |
|
||||
|
||||
配置值编辑区：
|
||||
|
||||
- JSON 类型支持 JSON 编辑器。
|
||||
- 简单配置支持键值对模式。
|
||||
- 保存前需要完成配置值格式校验。
|
||||
- 配置值较长时，列表页只展示配置值预览，详情页展示完整配置值。
|
||||
|
||||
### 5.8.7.11 配置版本记录页 / 弹窗
|
||||
|
||||
版本记录用于查看配置历史版本和执行回滚。
|
||||
|
||||
展示方式：
|
||||
|
||||
- 数据表格。
|
||||
- 回滚操作需要二次确认。
|
||||
|
||||
列表字段：
|
||||
|
||||
| 字段 | 说明 |
|
||||
| --- | --- |
|
||||
| 版本号 | 配置历史版本 |
|
||||
| 配置值预览 | 该版本配置值摘要 |
|
||||
| 变更人 | 执行变更的用户 |
|
||||
| 变更时间 | 配置变更时间 |
|
||||
| 变更说明 | 变更原因或备注 |
|
||||
| 操作 | 查看、回滚 |
|
||||
|
||||
页面规则：
|
||||
|
||||
- 只能回滚到历史有效版本。
|
||||
- 回滚不会删除历史版本。
|
||||
- 回滚后生成新的版本号。
|
||||
- 回滚需要记录操作日志。
|
||||
|
||||
## 5.8.8 使用导航
|
||||
|
||||
### 5.8.8.1 维护场景化配置
|
||||
|
||||
操作路径：
|
||||
|
||||
```text
|
||||
基础平台 > 基础配置管理 > 对应配置页面
|
||||
```
|
||||
|
||||
操作步骤：
|
||||
|
||||
1. 进入基础配置管理。
|
||||
2. 选择平台运行配置、登录与安全配置、门户与应用容器配置、客户级配置、应用级接入配置、消息与通知配置、审计与日志配置或基础开关配置。
|
||||
3. 按页面表单维护对应配置。
|
||||
4. 点击保存。
|
||||
5. 系统校验配置值、版本号和权限范围。
|
||||
6. 系统生成新版本并记录操作日志。
|
||||
|
||||
### 5.8.8.2 查询配置项
|
||||
|
||||
操作路径：
|
||||
|
||||
```text
|
||||
基础平台 > 基础配置管理 > 配置项管理
|
||||
```
|
||||
|
||||
操作步骤：
|
||||
|
||||
1. 进入配置项管理页。
|
||||
2. 按配置名称、配置编码、配置分类、配置层级、所属客户、所属应用或启用状态查询。
|
||||
3. 在配置项列表中查看配置。
|
||||
|
||||
### 5.8.8.3 新增配置项
|
||||
|
||||
操作路径：
|
||||
|
||||
```text
|
||||
基础平台 > 基础配置管理 > 配置项管理 > 新增配置
|
||||
```
|
||||
|
||||
操作步骤：
|
||||
|
||||
1. 进入配置项管理页。
|
||||
2. 点击新增配置。
|
||||
3. 系统打开配置新增 / 编辑抽屉。
|
||||
4. 填写配置名称、配置编码、配置分类、配置层级。
|
||||
5. 如为客户级配置，选择所属客户。
|
||||
6. 如为应用级配置，选择所属应用。
|
||||
7. 选择配置值类型并填写配置值。
|
||||
8. 设置启用状态和备注。
|
||||
9. 保存配置。
|
||||
10. 系统创建配置、生成初始版本并记录操作日志。
|
||||
|
||||
### 5.8.8.4 编辑配置项
|
||||
|
||||
操作路径：
|
||||
|
||||
```text
|
||||
基础平台 > 基础配置管理 > 配置项管理 > 编辑
|
||||
```
|
||||
|
||||
操作步骤：
|
||||
|
||||
1. 进入配置项管理页。
|
||||
2. 查询目标配置。
|
||||
3. 点击编辑。
|
||||
4. 系统打开配置新增 / 编辑抽屉。
|
||||
5. 修改配置名称、配置值、启用状态或备注。
|
||||
6. 保存配置。
|
||||
7. 系统校验配置值格式和版本号。
|
||||
8. 系统生成新版本并记录操作日志。
|
||||
|
||||
### 5.8.8.5 启用 / 停用配置
|
||||
|
||||
操作路径：
|
||||
|
||||
```text
|
||||
基础平台 > 基础配置管理 > 配置项管理 > 启用 / 停用
|
||||
```
|
||||
|
||||
操作步骤：
|
||||
|
||||
1. 进入配置项管理页。
|
||||
2. 查询目标配置。
|
||||
3. 点击启用或停用。
|
||||
4. 停用配置时，系统提示配置停用影响。
|
||||
5. 确认操作。
|
||||
6. 系统更新配置状态、生成新版本并记录操作日志。
|
||||
|
||||
### 5.8.8.6 回滚配置版本
|
||||
|
||||
操作路径：
|
||||
|
||||
```text
|
||||
基础平台 > 基础配置管理 > 配置项管理 > 版本记录 > 回滚
|
||||
```
|
||||
|
||||
操作步骤：
|
||||
|
||||
1. 进入配置项管理页或场景化配置页面。
|
||||
2. 查询目标配置或打开当前配置的版本记录。
|
||||
3. 查看配置历史版本。
|
||||
4. 选择需要回滚的历史版本。
|
||||
5. 点击回滚。
|
||||
6. 系统二次确认回滚操作。
|
||||
7. 系统生成新版本并记录操作日志。
|
||||
|
||||
## 5.8.9 验收标准
|
||||
|
||||
- 基础配置管理按配置场景拆分页面展示。
|
||||
- 可维护平台运行配置、登录与安全配置、门户与应用容器配置、客户级配置、应用级接入配置、消息与通知配置、审计与日志配置、基础开关配置。
|
||||
- 场景化配置页面采用业务化表单，不要求用户直接编辑 JSON。
|
||||
- 配置项管理可查询平台级、客户级、应用级配置。
|
||||
- 配置项管理可新增、编辑、启用、停用配置。
|
||||
- 配置编码按配置层级和归属范围校验唯一性。
|
||||
- 配置值保存前按配置值类型完成格式校验。
|
||||
- JSON 类型配置保存前必须校验为合法 JSON。
|
||||
- 配置列表可展示配置值预览。
|
||||
- 配置变更后生成新版本。
|
||||
- 多人同时编辑同一配置时，系统可识别版本冲突。
|
||||
- 可查看配置历史版本。
|
||||
- 可回滚配置历史版本，回滚后生成新版本。
|
||||
- 停用配置时能够提示配置影响。
|
||||
- 平台级配置、客户级配置、应用级配置的维护权限正确。
|
||||
- 配置新增、编辑、启用、停用、回滚均生成操作日志。
|
||||
|
||||
@@ -4,28 +4,496 @@
|
||||
|
||||
上级文档：[基础平台产品设计](../基础平台产品设计.md)
|
||||
|
||||
|
||||
## 5.9.1 功能说明
|
||||
|
||||
消息与待办用于为业务系统提供基础通知能力。
|
||||
消息与待办用于为基础平台和各业务应用提供统一的消息提醒、待办聚合、已读未读、待办处理状态、消息跳转和用户消息中心能力。
|
||||
|
||||
消息偏通知提醒，解决“用户需要知道什么”；待办偏任务处理，解决“用户需要处理什么”。基础平台负责统一承载和展示消息与待办，不负责各业务系统内部的业务审批规则、工单流转规则和单据处理规则。
|
||||
|
||||
业务应用负责生成业务消息和业务待办，并提供对应业务页面；基础平台负责接收、展示、计数、状态维护和跳转入口。
|
||||
|
||||
## 5.9.2 功能范围
|
||||
|
||||
- 系统消息
|
||||
- 待办消息
|
||||
- 消息已读 / 未读
|
||||
- 消息列表
|
||||
- 待办列表
|
||||
- 消息详情
|
||||
- 待办详情
|
||||
- 未读消息提醒
|
||||
- 待办数量提醒
|
||||
- 已读 / 未读
|
||||
- 单条已读
|
||||
- 全部已读
|
||||
- 待办状态更新
|
||||
- 待办跳转业务系统
|
||||
- 消息归档
|
||||
- 消息查询
|
||||
- 消息跳转业务系统
|
||||
- 消息操作记录
|
||||
|
||||
## 5.9.3 业务规则
|
||||
## 5.9.3 消息与待办分类
|
||||
|
||||
- 消息必须归属于客户和用户。
|
||||
### 5.9.3.1 消息分类
|
||||
|
||||
基础平台 1.0 支持以下消息分类：
|
||||
|
||||
| 消息分类 | 定义 | 示例 |
|
||||
| --- | --- | --- |
|
||||
| 系统消息 | 基础平台自身产生的通知 | 账号创建、密码重置、客户停用、应用停用 |
|
||||
| 业务消息 | 业务应用产生的通知 | 对账差异提醒、分账失败提醒、支付异常提醒 |
|
||||
| 公告消息 | 平台或客户发布的公告 | 系统维护公告、功能上线公告 |
|
||||
| 安全消息 | 与账号、登录、安全相关的提醒 | 异地登录、密码重置、账号停用 |
|
||||
|
||||
### 5.9.3.2 待办分类
|
||||
|
||||
基础平台 1.0 支持以下待办分类：
|
||||
|
||||
| 待办分类 | 定义 | 示例 |
|
||||
| --- | --- | --- |
|
||||
| 审批待办 | 需要用户审批或确认的事项 | 自采申请审批、应用开通确认 |
|
||||
| 处理待办 | 需要用户处理的业务事项 | 对账差异处理、分账异常处理 |
|
||||
| 确认待办 | 需要用户确认结果的事项 | 配置变更确认、角色权限变更确认 |
|
||||
| 工单待办 | 来自客服或运维工单的处理事项 | 客诉工单处理、系统问题处理 |
|
||||
|
||||
### 5.9.3.3 优先级
|
||||
|
||||
消息和待办支持优先级：
|
||||
|
||||
| 优先级 | 说明 |
|
||||
| --- | --- |
|
||||
| 高 | 影响登录、结算、支付、业务处理中断等紧急事项 |
|
||||
| 中 | 需要用户及时关注或处理的一般事项 |
|
||||
| 低 | 通知类、公告类或非紧急事项 |
|
||||
|
||||
## 5.9.4 字段要求
|
||||
|
||||
### 5.9.4.1 消息字段
|
||||
|
||||
消息信息至少包括：
|
||||
|
||||
| 字段 | 说明 | 是否必填 |
|
||||
| --- | --- | --- |
|
||||
| 所属客户 | 消息归属客户 | 是 |
|
||||
| 接收用户 | 消息接收人 | 是 |
|
||||
| 来源应用 | 消息来源应用 | 是 |
|
||||
| 消息分类 | 系统消息、业务消息、公告消息、安全消息 | 是 |
|
||||
| 消息标题 | 消息标题 | 是 |
|
||||
| 消息内容 | 消息正文摘要或完整内容 | 是 |
|
||||
| 优先级 | 高、中、低 | 是 |
|
||||
| 已读状态 | 未读、已读 | 是 |
|
||||
| 发送时间 | 消息生成或发送时间 | 是 |
|
||||
| 阅读时间 | 用户首次阅读时间 | 否 |
|
||||
| 跳转类型 | 无跳转、基础平台页面、业务应用页面、外部链接 | 是 |
|
||||
| 跳转地址 | 消息点击后的目标页面 | 条件必填 |
|
||||
| 业务对象类型 | 消息关联的业务对象类型 | 否 |
|
||||
| 业务对象编号 | 消息关联的业务对象编号 | 否 |
|
||||
| 归档状态 | 未归档、已归档 | 是 |
|
||||
|
||||
### 5.9.4.2 待办字段
|
||||
|
||||
待办信息至少包括：
|
||||
|
||||
| 字段 | 说明 | 是否必填 |
|
||||
| --- | --- | --- |
|
||||
| 所属客户 | 待办归属客户 | 是 |
|
||||
| 待办处理人 | 待办接收和处理用户 | 是 |
|
||||
| 来源应用 | 待办来源应用 | 是 |
|
||||
| 待办分类 | 审批待办、处理待办、确认待办、工单待办 | 是 |
|
||||
| 待办标题 | 待办标题 | 是 |
|
||||
| 待办内容 | 待办说明 | 是 |
|
||||
| 优先级 | 高、中、低 | 是 |
|
||||
| 待办状态 | 待处理、处理中、已处理、已取消、已过期 | 是 |
|
||||
| 发送时间 | 待办生成时间 | 是 |
|
||||
| 截止时间 | 待办建议处理截止时间 | 否 |
|
||||
| 处理时间 | 待办完成或关闭时间 | 否 |
|
||||
| 跳转类型 | 基础平台页面、业务应用页面、外部链接 | 是 |
|
||||
| 跳转地址 | 待办点击后的目标页面 | 是 |
|
||||
| 业务对象类型 | 待办关联的业务对象类型 | 是 |
|
||||
| 业务对象编号 | 待办关联的业务对象编号 | 是 |
|
||||
| 处理结果 | 待办处理结果摘要 | 否 |
|
||||
|
||||
## 5.9.5 业务规则
|
||||
|
||||
### 5.9.5.1 消息规则
|
||||
|
||||
- 消息必须归属于一个客户和一个接收用户。
|
||||
- 平台级用户接收的平台管理消息可不归属具体业务客户，但必须有接收用户。
|
||||
- 用户只能查看自己的消息。
|
||||
- 待办可关联业务系统和业务单据。
|
||||
- 业务单据处理完成后，待办状态应支持更新。
|
||||
- 客户管理员不可查看客户内其他用户的个人消息，除非具备消息审计权限。
|
||||
- 消息默认进入未读状态。
|
||||
- 用户打开消息详情后，消息可自动标记为已读。
|
||||
- 用户可手工将消息标记为已读。
|
||||
- 用户可执行全部已读。
|
||||
- 消息归档不删除消息，只从默认列表中隐藏。
|
||||
- 消息保留时长由基础配置管理中的消息保留天数控制。
|
||||
|
||||
## 5.9.4 验收标准
|
||||
### 5.9.5.2 待办规则
|
||||
|
||||
- 用户可查看自己的消息和待办。
|
||||
- 已读 / 未读状态正确。
|
||||
- 待办可跳转到对应业务系统。
|
||||
- 待办必须归属于一个客户和一个处理用户。
|
||||
- 待办必须关联来源应用和业务对象。
|
||||
- 用户只能查看和处理分配给自己的待办。
|
||||
- 待办状态包括待处理、处理中、已处理、已取消、已过期。
|
||||
- 待办点击后应跳转到对应业务页面处理，不在基础平台内处理业务单据。
|
||||
- 业务应用处理完成后，应同步更新基础平台待办状态。
|
||||
- 待办已处理后，不再计入待处理数量。
|
||||
- 待办已取消或已过期后，不再允许用户继续处理。
|
||||
- 同一个业务对象可产生多个待办，但同一处理人下相同业务动作不应重复生成有效待办。
|
||||
|
||||
### 5.9.5.3 跳转规则
|
||||
|
||||
- 基础平台页面跳转在右侧内容区打开基础平台页面。
|
||||
- 业务应用页面跳转通过统一门户 iframe 容器打开业务应用页面。
|
||||
- 外部链接跳转需要按应用接入规则控制，1.0 不作为重点能力。
|
||||
- 用户无目标应用权限时，不允许跳转，并提示无权限访问。
|
||||
- 目标应用停用、客户未开通应用或菜单停用时，不允许跳转。
|
||||
- 跳转地址应尽量关联具体菜单或页面，避免只跳转到应用首页。
|
||||
|
||||
### 5.9.5.4 数量提醒规则
|
||||
|
||||
- 门户头部消息按钮展示未读消息数和待处理待办数。
|
||||
- 未读消息数只统计当前登录用户未读且未归档消息。
|
||||
- 待处理待办数只统计当前登录用户待处理和处理中待办。
|
||||
- 消息和待办数量刷新频率由基础配置管理中的未读消息提醒间隔控制。
|
||||
- 数量过多时可展示为 `99+`。
|
||||
|
||||
## 5.9.6 界面设计
|
||||
|
||||
### 5.9.6.1 功能入口与访问权限
|
||||
|
||||
消息与待办作为基础平台个人工作入口，建议放置在门户头部消息按钮和基础平台左侧菜单：
|
||||
|
||||
```text
|
||||
基础平台
|
||||
└── 消息与待办
|
||||
```
|
||||
|
||||
入口包括：
|
||||
|
||||
- 头部消息按钮：展示未读消息数和待处理待办数，点击后打开消息浮层。
|
||||
- 消息与待办菜单：进入完整消息中心页面。
|
||||
- 待办跳转入口：从消息中心或头部浮层跳转到业务应用页面。
|
||||
|
||||
页面访问规则：
|
||||
|
||||
- 登录用户可查看自己的消息和待办。
|
||||
- 平台运维人员可按授权范围查询消息投递状态，用于问题排查。
|
||||
- 普通用户不可查看其他用户消息和待办。
|
||||
- 无消息与待办权限的用户不展示消息与待办菜单，但头部消息按钮可作为个人入口展示。
|
||||
|
||||
### 5.9.6.2 头部消息浮层
|
||||
|
||||
头部消息浮层用于快速查看未读消息和待处理待办。
|
||||
|
||||
展示方式：
|
||||
|
||||
- 点击门户头部消息按钮打开浮层。
|
||||
- 浮层采用 Tab 页签展示：消息、待办。
|
||||
- 每个页签展示最近消息或待办列表。
|
||||
- 底部展示查看全部入口。
|
||||
|
||||
消息页签字段：
|
||||
|
||||
| 字段 | 说明 |
|
||||
| --- | --- |
|
||||
| 消息标题 | 消息标题 |
|
||||
| 消息分类 | 系统、业务、公告、安全 |
|
||||
| 优先级 | 高、中、低 |
|
||||
| 发送时间 | 消息发送时间 |
|
||||
| 已读状态 | 未读、已读 |
|
||||
|
||||
待办页签字段：
|
||||
|
||||
| 字段 | 说明 |
|
||||
| --- | --- |
|
||||
| 待办标题 | 待办标题 |
|
||||
| 来源应用 | 待办来源应用 |
|
||||
| 优先级 | 高、中、低 |
|
||||
| 截止时间 | 待办建议处理截止时间 |
|
||||
| 待办状态 | 待处理、处理中 |
|
||||
|
||||
页面规则：
|
||||
|
||||
- 点击消息进入消息详情。
|
||||
- 点击待办进入待办详情或直接跳转业务页面。
|
||||
- 点击查看全部进入消息与待办主页面。
|
||||
|
||||
### 5.9.6.3 消息与待办主页面
|
||||
|
||||
消息与待办主页面用于集中查看消息和待办。
|
||||
|
||||
展示方式：
|
||||
|
||||
- 页面采用 Tab 页签展示。
|
||||
- Tab 页签包括：消息、待办。
|
||||
- 每个页签采用查询区域 + 数据表格展示。
|
||||
- 查询按钮作为查询区域最后一个表单元素。
|
||||
|
||||
### 5.9.6.4 消息列表页签
|
||||
|
||||
查询条件：
|
||||
|
||||
| 查询项 | 控件类型 | 值来源 / 录入方式 | 说明 |
|
||||
| --- | --- | --- | --- |
|
||||
| 消息标题 | 文本输入框 | 人工录入 | 支持模糊查询 |
|
||||
| 消息分类 | 下拉框 | 系统消息、业务消息、公告消息、安全消息 | 可为空 |
|
||||
| 来源应用 | 下拉框 | 当前用户可访问应用 | 可为空 |
|
||||
| 优先级 | 下拉框 | 全部、高、中、低 | 默认全部 |
|
||||
| 已读状态 | 下拉框 | 全部、未读、已读 | 默认全部 |
|
||||
| 发送时间 | 日期范围选择器 | 人工选择 | 可为空 |
|
||||
| 查询 | 按钮 | 用户点击 | 作为查询区域最后一个表单元素 |
|
||||
|
||||
列表字段：
|
||||
|
||||
| 字段 | 说明 |
|
||||
| --- | --- |
|
||||
| 消息标题 | 消息标题 |
|
||||
| 消息分类 | 系统、业务、公告、安全 |
|
||||
| 来源应用 | 消息来源应用 |
|
||||
| 优先级 | 高、中、低 |
|
||||
| 已读状态 | 未读、已读 |
|
||||
| 发送时间 | 消息发送时间 |
|
||||
| 操作 | 查看、标记已读、归档 |
|
||||
|
||||
页面规则：
|
||||
|
||||
- 未读消息需要在列表中突出展示。
|
||||
- 支持批量标记已读。
|
||||
- 支持全部已读。
|
||||
- 支持归档消息。
|
||||
|
||||
### 5.9.6.5 待办列表页签
|
||||
|
||||
查询条件：
|
||||
|
||||
| 查询项 | 控件类型 | 值来源 / 录入方式 | 说明 |
|
||||
| --- | --- | --- | --- |
|
||||
| 待办标题 | 文本输入框 | 人工录入 | 支持模糊查询 |
|
||||
| 待办分类 | 下拉框 | 审批、处理、确认、工单 | 可为空 |
|
||||
| 来源应用 | 下拉框 | 当前用户可访问应用 | 可为空 |
|
||||
| 优先级 | 下拉框 | 全部、高、中、低 | 默认全部 |
|
||||
| 待办状态 | 下拉框 | 全部、待处理、处理中、已处理、已取消、已过期 | 默认待处理 |
|
||||
| 截止时间 | 日期范围选择器 | 人工选择 | 可为空 |
|
||||
| 查询 | 按钮 | 用户点击 | 作为查询区域最后一个表单元素 |
|
||||
|
||||
列表字段：
|
||||
|
||||
| 字段 | 说明 |
|
||||
| --- | --- |
|
||||
| 待办标题 | 待办标题 |
|
||||
| 待办分类 | 审批、处理、确认、工单 |
|
||||
| 来源应用 | 待办来源应用 |
|
||||
| 优先级 | 高、中、低 |
|
||||
| 待办状态 | 待处理、处理中、已处理、已取消、已过期 |
|
||||
| 截止时间 | 建议处理截止时间 |
|
||||
| 发送时间 | 待办生成时间 |
|
||||
| 操作 | 查看、去处理 |
|
||||
|
||||
页面规则：
|
||||
|
||||
- 待处理和处理中待办默认展示在前。
|
||||
- 高优先级待办需要突出展示。
|
||||
- 已处理、已取消、已过期待办不可继续处理。
|
||||
- 点击去处理时，按跳转规则打开对应业务页面。
|
||||
|
||||
### 5.9.6.6 消息详情页 / 弹窗
|
||||
|
||||
消息详情用于查看消息完整内容。
|
||||
|
||||
展示方式：
|
||||
|
||||
- 采用详情弹窗或右侧抽屉展示。
|
||||
- 内容较短时可用弹窗；内容较长时建议使用抽屉。
|
||||
|
||||
详情字段：
|
||||
|
||||
| 字段 | 说明 |
|
||||
| --- | --- |
|
||||
| 消息标题 | 消息标题 |
|
||||
| 消息分类 | 系统、业务、公告、安全 |
|
||||
| 来源应用 | 消息来源应用 |
|
||||
| 消息内容 | 消息完整内容 |
|
||||
| 发送时间 | 消息发送时间 |
|
||||
| 已读状态 | 未读、已读 |
|
||||
| 业务对象 | 关联业务对象类型和编号 |
|
||||
|
||||
操作按钮：
|
||||
|
||||
- 关闭
|
||||
- 标记已读
|
||||
- 跳转查看
|
||||
- 归档
|
||||
|
||||
### 5.9.6.7 待办详情页 / 弹窗
|
||||
|
||||
待办详情用于查看待办完整信息和处理入口。
|
||||
|
||||
展示方式：
|
||||
|
||||
- 采用详情弹窗或右侧抽屉展示。
|
||||
|
||||
详情字段：
|
||||
|
||||
| 字段 | 说明 |
|
||||
| --- | --- |
|
||||
| 待办标题 | 待办标题 |
|
||||
| 待办分类 | 审批、处理、确认、工单 |
|
||||
| 来源应用 | 待办来源应用 |
|
||||
| 待办内容 | 待办完整说明 |
|
||||
| 优先级 | 高、中、低 |
|
||||
| 待办状态 | 当前待办状态 |
|
||||
| 截止时间 | 建议处理截止时间 |
|
||||
| 业务对象 | 关联业务对象类型和编号 |
|
||||
| 处理结果 | 已处理时展示 |
|
||||
|
||||
操作按钮：
|
||||
|
||||
- 关闭
|
||||
- 去处理
|
||||
- 标记处理中
|
||||
|
||||
页面规则：
|
||||
|
||||
- 去处理跳转到业务应用页面。
|
||||
- 标记处理中只改变基础平台待办状态，不代表业务单据已处理完成。
|
||||
- 业务应用处理完成后同步更新为已处理。
|
||||
|
||||
### 5.9.6.8 消息投递查询页
|
||||
|
||||
消息投递查询页用于平台运维、实施或客服排查消息是否生成、发送、阅读和跳转异常。
|
||||
|
||||
展示方式：
|
||||
|
||||
- 查询区域 + 数据表格。
|
||||
- 仅具备消息运维权限的用户可见。
|
||||
|
||||
查询条件：
|
||||
|
||||
| 查询项 | 控件类型 | 值来源 / 录入方式 | 说明 |
|
||||
| --- | --- | --- | --- |
|
||||
| 所属客户 | 客户选择器 | 客户管理中已启用客户 | 可为空 |
|
||||
| 接收用户 | 用户选择器 | 用户与账号管理中的用户 | 可为空 |
|
||||
| 来源应用 | 应用选择器 | 应用管理中的应用 | 可为空 |
|
||||
| 消息 / 待办标题 | 文本输入框 | 人工录入 | 支持模糊查询 |
|
||||
| 状态 | 下拉框 | 未读、已读、待处理、已处理等 | 可为空 |
|
||||
| 时间范围 | 日期范围选择器 | 人工选择 | 可为空 |
|
||||
|
||||
页面规则：
|
||||
|
||||
- 运维查询用于排查，不允许代替用户处理待办。
|
||||
- 查询结果需要按客户数据隔离。
|
||||
|
||||
## 5.9.7 使用导航
|
||||
|
||||
### 5.9.7.1 查看头部消息提醒
|
||||
|
||||
操作路径：
|
||||
|
||||
```text
|
||||
基础平台门户 > 头部消息按钮
|
||||
```
|
||||
|
||||
操作步骤：
|
||||
|
||||
1. 用户登录基础平台。
|
||||
2. 系统在头部消息按钮展示未读消息数和待处理待办数。
|
||||
3. 用户点击消息按钮。
|
||||
4. 系统打开消息浮层。
|
||||
5. 用户在消息或待办页签中查看最近记录。
|
||||
|
||||
### 5.9.7.2 查看消息列表
|
||||
|
||||
操作路径：
|
||||
|
||||
```text
|
||||
基础平台 > 消息与待办 > 消息
|
||||
```
|
||||
|
||||
操作步骤：
|
||||
|
||||
1. 进入消息与待办主页面。
|
||||
2. 打开消息页签。
|
||||
3. 按消息标题、消息分类、来源应用、优先级、已读状态或发送时间查询。
|
||||
4. 查看消息列表。
|
||||
|
||||
### 5.9.7.3 查看待办列表
|
||||
|
||||
操作路径：
|
||||
|
||||
```text
|
||||
基础平台 > 消息与待办 > 待办
|
||||
```
|
||||
|
||||
操作步骤：
|
||||
|
||||
1. 进入消息与待办主页面。
|
||||
2. 打开待办页签。
|
||||
3. 按待办标题、待办分类、来源应用、优先级、待办状态或截止时间查询。
|
||||
4. 查看待办列表。
|
||||
|
||||
### 5.9.7.4 处理消息
|
||||
|
||||
操作路径：
|
||||
|
||||
```text
|
||||
基础平台 > 消息与待办 > 消息 > 查看
|
||||
```
|
||||
|
||||
操作步骤：
|
||||
|
||||
1. 查询目标消息。
|
||||
2. 点击查看。
|
||||
3. 系统打开消息详情。
|
||||
4. 用户查看消息内容。
|
||||
5. 系统标记消息为已读，或用户手工标记为已读。
|
||||
6. 如消息存在跳转地址，用户点击跳转查看。
|
||||
|
||||
### 5.9.7.5 处理待办
|
||||
|
||||
操作路径：
|
||||
|
||||
```text
|
||||
基础平台 > 消息与待办 > 待办 > 去处理
|
||||
```
|
||||
|
||||
操作步骤：
|
||||
|
||||
1. 查询目标待办。
|
||||
2. 点击去处理。
|
||||
3. 系统校验用户是否有目标应用和菜单权限。
|
||||
4. 校验通过后，通过统一门户 iframe 容器打开业务应用页面。
|
||||
5. 用户在业务应用中处理业务事项。
|
||||
6. 业务应用处理完成后，同步更新待办状态。
|
||||
7. 基础平台刷新待办状态和待处理数量。
|
||||
|
||||
### 5.9.7.6 全部已读
|
||||
|
||||
操作路径：
|
||||
|
||||
```text
|
||||
基础平台 > 消息与待办 > 消息 > 全部已读
|
||||
```
|
||||
|
||||
操作步骤：
|
||||
|
||||
1. 进入消息页签。
|
||||
2. 点击全部已读。
|
||||
3. 系统提示确认操作。
|
||||
4. 用户确认后，系统将当前用户未读消息标记为已读。
|
||||
5. 系统刷新未读消息数量。
|
||||
|
||||
## 5.9.8 验收标准
|
||||
|
||||
- 用户可通过门户头部消息按钮查看未读消息数和待处理待办数。
|
||||
- 用户可查看自己的消息列表和待办列表。
|
||||
- 普通用户不可查看其他用户消息和待办。
|
||||
- 消息支持系统消息、业务消息、公告消息、安全消息分类。
|
||||
- 待办支持审批待办、处理待办、确认待办、工单待办分类。
|
||||
- 消息支持未读、已读状态。
|
||||
- 消息支持查看详情、标记已读、全部已读、归档。
|
||||
- 待办支持待处理、处理中、已处理、已取消、已过期状态。
|
||||
- 待办可关联来源应用和业务对象。
|
||||
- 待办可跳转到对应基础平台页面或业务应用页面。
|
||||
- 用户无目标应用或菜单权限时，不允许跳转待办。
|
||||
- 业务应用处理完成后，基础平台待办状态可更新为已处理。
|
||||
- 头部消息数量与消息列表、待办列表状态一致。
|
||||
- 消息保留天数、待办提醒开关、未读消息提醒间隔可受基础配置管理控制。
|
||||
- 平台运维人员可按授权范围查询消息投递状态。
|
||||
- 消息查看、标记已读、全部已读、归档、待办状态变更、待办跳转均生成操作日志。
|
||||
|
||||
@@ -4,47 +4,393 @@
|
||||
|
||||
上级文档：[基础平台产品设计](../基础平台产品设计.md)
|
||||
|
||||
|
||||
## 5.10.1 功能说明
|
||||
|
||||
操作日志用于记录用户关键操作，支持审计和问题排查。
|
||||
操作日志用于记录基础平台中的关键用户操作、管理配置变更、安全敏感操作和跨应用跳转操作，支撑审计追溯、问题排查、责任界定和安全风控。
|
||||
|
||||
## 5.10.2 日志范围
|
||||
操作日志只记录“谁在什么时间，对什么对象，做了什么操作，结果如何”。操作日志不替代业务单据流水，不记录完整业务处理过程，不作为业务系统账务、审批、工单、对账或分账明细。
|
||||
|
||||
1.0 至少记录：
|
||||
## 5.10.2 功能范围
|
||||
|
||||
- 登录
|
||||
- 新增
|
||||
- 编辑
|
||||
- 删除
|
||||
- 启用 / 停用
|
||||
- 授权变更
|
||||
- 配置变更
|
||||
- 导入
|
||||
- 导出
|
||||
- 操作日志采集
|
||||
- 操作日志查询
|
||||
- 操作日志详情
|
||||
- 操作日志导出
|
||||
- 操作结果记录
|
||||
- 变更前后摘要记录
|
||||
- 敏感操作标识
|
||||
- 日志留存控制
|
||||
|
||||
## 5.10.3 日志字段
|
||||
## 5.10.3 必须记录操作清单
|
||||
|
||||
日志至少包括：
|
||||
### 5.10.3.1 登录与账号安全类
|
||||
|
||||
- 操作时间
|
||||
- 操作用户
|
||||
- 所属客户
|
||||
- 所属组织
|
||||
- 操作应用
|
||||
- 操作模块
|
||||
- 操作类型
|
||||
- 操作对象
|
||||
- 操作结果
|
||||
以下操作必须记录操作日志或登录安全日志：
|
||||
|
||||
## 5.10.4 业务规则
|
||||
| 操作类型 | 触发场景 | 是否必须 |
|
||||
| --- | --- | --- |
|
||||
| 登录成功 | 用户通过平台账号或第三方账号登录成功 | 是 |
|
||||
| 登录失败 | 用户登录失败，包括账号不存在、密码错误、账号停用等 | 是 |
|
||||
| 登录锁定 | 连续登录失败触发账号锁定 | 是 |
|
||||
| 退出登录 | 用户主动注销登录 | 是 |
|
||||
| Token 刷新失败 | Token 刷新失败并引导重新登录 | 是 |
|
||||
| 密码重置 | 管理员重置平台账号密码 | 是 |
|
||||
| 首次登录修改密码 | 用户首次登录修改密码 | 是 |
|
||||
| 账号启用 / 停用 | 登录账号启用、停用 | 是 |
|
||||
| 第三方账号绑定 / 解绑 | 微信、企微、钉钉、飞书等账号绑定或解绑 | 是 |
|
||||
|
||||
- 操作日志不可由普通用户修改或删除。
|
||||
- 日志查询需按权限控制。
|
||||
- 不同客户日志隔离。
|
||||
### 5.10.3.2 客户管理类
|
||||
|
||||
## 5.10.5 验收标准
|
||||
以下客户管理操作必须记录：
|
||||
|
||||
- 关键操作可生成日志。
|
||||
- 日志内容可查询。
|
||||
- 客户之间日志隔离。
|
||||
| 操作类型 | 触发场景 | 是否必须 |
|
||||
| --- | --- | --- |
|
||||
| 新增客户 | 创建客户档案 | 是 |
|
||||
| 编辑客户 | 修改客户名称、简称、类型、行业、状态等基础信息 | 是 |
|
||||
| 启用 / 停用客户 | 客户启用或停用 | 是 |
|
||||
| 开通应用 | 为客户开通业务应用 | 是 |
|
||||
| 关闭应用 | 关闭客户已开通应用 | 是 |
|
||||
| 添加客户管理员 | 为客户添加管理员 | 是 |
|
||||
| 取消客户管理员 | 取消用户客户管理员身份 | 是 |
|
||||
| 启用 / 停用客户管理员 | 客户管理员启用或停用 | 是 |
|
||||
| 重置客户管理员密码 | 重置客户管理员平台账号密码 | 是 |
|
||||
|
||||
### 5.10.3.3 应用管理类
|
||||
|
||||
以下应用管理操作必须记录：
|
||||
|
||||
| 操作类型 | 触发场景 | 是否必须 |
|
||||
| --- | --- | --- |
|
||||
| 新增应用 | 创建应用档案 | 是 |
|
||||
| 编辑应用 | 修改应用名称、简称、类型、入口等基础信息 | 是 |
|
||||
| 启用 / 停用应用 | 应用启用或停用 | 是 |
|
||||
| 配置应用入口 | 修改应用入口类型、入口地址、打开方式 | 是 |
|
||||
| 新增 / 编辑菜单 | 新增或修改应用菜单 | 是 |
|
||||
| 启用 / 停用菜单 | 菜单启用或停用 | 是 |
|
||||
| 调整菜单排序 | 修改菜单展示顺序 | 是 |
|
||||
| 配置菜单操作权限 | 新增、编辑、停用菜单下操作权限 | 是 |
|
||||
| 配置可授权范围 | 修改适用客户类型、行业、默认角色模板、默认菜单范围 | 是 |
|
||||
|
||||
### 5.10.3.4 组织管理类
|
||||
|
||||
以下组织管理操作必须记录：
|
||||
|
||||
| 操作类型 | 触发场景 | 是否必须 |
|
||||
| --- | --- | --- |
|
||||
| 新增组织 | 新增下级组织 | 是 |
|
||||
| 编辑组织 | 修改组织名称、编码、类型、负责人等信息 | 是 |
|
||||
| 启用 / 停用组织 | 组织启用或停用 | 是 |
|
||||
| 调整上级组织 | 调整组织父级关系 | 是 |
|
||||
| 组织负责人变更 | 变更组织负责人 | 是 |
|
||||
|
||||
### 5.10.3.5 用户与账号管理类
|
||||
|
||||
以下用户与账号操作必须记录：
|
||||
|
||||
| 操作类型 | 触发场景 | 是否必须 |
|
||||
| --- | --- | --- |
|
||||
| 新增用户 | 创建用户档案并默认创建平台账号 | 是 |
|
||||
| 编辑用户 | 修改用户姓名、手机号、所属组织、默认组织、状态等 | 是 |
|
||||
| 启用 / 停用用户 | 用户启用或停用 | 是 |
|
||||
| 所属组织变更 | 用户所属组织发生变化 | 是 |
|
||||
| 默认组织变更 | 用户默认组织发生变化 | 是 |
|
||||
| 创建平台账号 | 为用户创建平台账号 | 是 |
|
||||
| 绑定第三方账号 | 为用户绑定微信、企微、钉钉、飞书等账号 | 是 |
|
||||
| 解绑账号 | 解绑平台账号或第三方账号 | 是 |
|
||||
| 启用 / 停用账号 | 登录账号启用或停用 | 是 |
|
||||
| 重置平台账号密码 | 管理员重置平台账号密码 | 是 |
|
||||
| 分配角色 | 给用户分配角色 | 是 |
|
||||
| 移除角色 | 移除用户角色 | 是 |
|
||||
|
||||
### 5.10.3.6 角色管理类
|
||||
|
||||
以下角色管理操作必须记录：
|
||||
|
||||
| 操作类型 | 触发场景 | 是否必须 |
|
||||
| --- | --- | --- |
|
||||
| 新增角色 | 创建平台角色、客户角色或应用角色 | 是 |
|
||||
| 编辑角色 | 修改角色名称、说明、模板标识等 | 是 |
|
||||
| 复制角色 | 基于已有角色复制新角色 | 是 |
|
||||
| 启用 / 停用角色 | 角色启用或停用 | 是 |
|
||||
| 配置菜单权限 | 修改角色可访问菜单 | 是 |
|
||||
| 配置操作权限 | 修改角色菜单下操作权限 | 是 |
|
||||
| 配置数据范围 | 修改全部、本组织、指定组织、指定门店等数据范围 | 是 |
|
||||
|
||||
### 5.10.3.7 基础配置管理类
|
||||
|
||||
以下配置操作必须记录：
|
||||
|
||||
| 操作类型 | 触发场景 | 是否必须 |
|
||||
| --- | --- | --- |
|
||||
| 场景化配置变更 | 修改平台运行、登录安全、门户容器、客户级、应用级等配置 | 是 |
|
||||
| 新增配置项 | 在配置项管理中新建配置项 | 是 |
|
||||
| 编辑配置项 | 修改配置项基础信息或配置值 | 是 |
|
||||
| 启用 / 停用配置项 | 配置项启用或停用 | 是 |
|
||||
| 配置版本回滚 | 回滚到历史配置版本 | 是 |
|
||||
| 基础开关变更 | 启用或停用基础平台功能开关 | 是 |
|
||||
|
||||
### 5.10.3.8 消息与待办类
|
||||
|
||||
以下消息与待办操作必须记录：
|
||||
|
||||
| 操作类型 | 触发场景 | 是否必须 |
|
||||
| --- | --- | --- |
|
||||
| 查看消息 | 用户打开消息详情 | 建议 |
|
||||
| 标记已读 | 单条消息标记已读 | 是 |
|
||||
| 全部已读 | 用户执行全部已读 | 是 |
|
||||
| 归档消息 | 用户归档消息 | 是 |
|
||||
| 待办状态变更 | 待办标记处理中、已处理、已取消、已过期 | 是 |
|
||||
| 待办跳转 | 用户从待办跳转业务页面 | 是 |
|
||||
|
||||
说明：查看消息频率较高，可按配置决定是否记录；涉及状态变化的消息和待办操作必须记录。
|
||||
|
||||
### 5.10.3.9 数据字典类
|
||||
|
||||
以下数据字典操作必须记录：
|
||||
|
||||
| 操作类型 | 触发场景 | 是否必须 |
|
||||
| --- | --- | --- |
|
||||
| 新增字典 | 新增数据字典和字典值列表 | 是 |
|
||||
| 编辑字典 | 修改字典名称、归属业务系统、状态、备注等 | 是 |
|
||||
| 删除字典 | 软删除数据字典 | 是 |
|
||||
| 新增字典值 | 在字典中新增字典值 | 是 |
|
||||
| 删除字典值 | 从字典中删除字典值 | 是 |
|
||||
| 启用 / 停用字典值 | 字典值启用或停用 | 是 |
|
||||
| 调整字典值排序 | 修改字典值展示顺序 | 是 |
|
||||
| 修改字典值颜色 | 修改字典值展示颜色 | 是 |
|
||||
|
||||
### 5.10.3.10 城市管理类
|
||||
|
||||
以下城市管理操作必须记录：
|
||||
|
||||
| 操作类型 | 触发场景 | 是否必须 |
|
||||
| --- | --- | --- |
|
||||
| 新增国家 | 新增国家主数据 | 是 |
|
||||
| 编辑国家 | 修改国家名称、简称、国家码、ISO 编码等 | 是 |
|
||||
| 启用 / 停用国家 | 国家启用或停用 | 是 |
|
||||
| 删除国家 | 删除国家主数据 | 是 |
|
||||
| 新增城市节点 | 新增省份、城市、区县、街道节点 | 是 |
|
||||
| 编辑城市节点 | 修改城市名称、编码、外部编码、经纬度、排序等 | 是 |
|
||||
| 启用 / 停用城市节点 | 城市节点启用或停用 | 是 |
|
||||
| 删除城市节点 | 删除城市节点 | 是 |
|
||||
|
||||
### 5.10.3.11 支行信息管理类
|
||||
|
||||
以下支行信息管理操作必须记录：
|
||||
|
||||
| 操作类型 | 触发场景 | 是否必须 |
|
||||
| --- | --- | --- |
|
||||
| 新增支行信息 | 新增银行总行、支行、支行号、银行侧城市编码和行政省市映射信息 | 是 |
|
||||
| 编辑支行信息 | 修改总行信息、支行信息、银行侧城市编码、行政省市或状态 | 是 |
|
||||
| 启用 / 停用支行信息 | 支行信息启用或停用 | 是 |
|
||||
| 删除支行信息 | 软删除支行信息 | 是 |
|
||||
| 删除失败 | 支行信息因存在业务引用被禁止删除 | 是 |
|
||||
|
||||
### 5.10.3.12 导入导出类
|
||||
|
||||
以下导入导出操作必须记录：
|
||||
|
||||
| 操作类型 | 触发场景 | 是否必须 |
|
||||
| --- | --- | --- |
|
||||
| 导入数据 | 客户、组织、用户、角色、菜单、配置等批量导入 | 是 |
|
||||
| 导入失败 | 导入校验失败或部分失败 | 是 |
|
||||
| 导出数据 | 导出客户、组织、用户、角色、日志等数据 | 是 |
|
||||
| 下载导出文件 | 用户下载导出结果文件 | 建议 |
|
||||
|
||||
## 5.10.4 日志字段
|
||||
|
||||
操作日志至少包括：
|
||||
|
||||
| 字段 | 说明 | 是否必填 |
|
||||
| --- | --- | --- |
|
||||
| 操作时间 | 操作发生时间 | 是 |
|
||||
| 操作用户 | 执行操作的用户 | 是 |
|
||||
| 登录账号 | 执行操作时使用的登录账号 | 是 |
|
||||
| 所属客户 | 操作用户所属客户或操作对象所属客户 | 条件必填 |
|
||||
| 当前组织 | 操作用户当前组织上下文 | 否 |
|
||||
| 来源应用 | 操作发生的应用 | 是 |
|
||||
| 操作模块 | 客户管理、应用管理、组织管理等 | 是 |
|
||||
| 操作类型 | 新增、编辑、启用、停用、授权、回滚等 | 是 |
|
||||
| 操作对象类型 | 客户、应用、组织、用户、角色、配置项等 | 是 |
|
||||
| 操作对象编号 | 被操作对象编码或 ID | 是 |
|
||||
| 操作对象名称 | 被操作对象名称 | 否 |
|
||||
| 操作结果 | 成功、失败、部分成功 | 是 |
|
||||
| 失败原因 | 操作失败时记录原因 | 否 |
|
||||
| 变更前摘要 | 操作前关键字段摘要 | 否 |
|
||||
| 变更后摘要 | 操作后关键字段摘要 | 否 |
|
||||
| IP 地址 | 操作来源 IP | 否 |
|
||||
| 设备信息 | 浏览器、设备、客户端信息 | 否 |
|
||||
| 请求流水号 | 便于研发排查的请求标识 | 否 |
|
||||
| 操作说明 | 用户填写的原因或系统说明 | 否 |
|
||||
|
||||
敏感字段要求：
|
||||
|
||||
- 密码、Token、密钥、验证码不得明文记录。
|
||||
- 手机号、登录标识等敏感字段按基础配置中的脱敏策略展示。
|
||||
- 配置值如包含敏感内容，日志只记录摘要，不记录完整明文。
|
||||
|
||||
## 5.10.5 业务规则
|
||||
|
||||
- 操作日志由系统自动生成，普通用户不可新增、编辑或删除操作日志。
|
||||
- 操作日志一经生成，不允许被业务页面修改。
|
||||
- 不同客户之间操作日志必须隔离。
|
||||
- 平台用户可按授权范围查询多个客户日志。
|
||||
- 客户管理员只能查询本客户范围内与其权限相关的日志。
|
||||
- 普通业务用户默认不可进入操作日志查询页面。
|
||||
- 操作失败也应记录日志，尤其是登录失败、权限拒绝、配置保存失败、导入失败等。
|
||||
- 批量操作需要记录批次日志，并记录成功数量、失败数量和失败原因摘要。
|
||||
- 操作日志保留天数由基础配置管理中的审计与日志配置控制。
|
||||
- 超过保留期的日志处理策略由平台运维制度决定，产品 1.0 只要求支持按保留期查询和归档边界。
|
||||
|
||||
## 5.10.6 界面设计
|
||||
|
||||
### 5.10.6.1 功能入口与访问权限
|
||||
|
||||
操作日志作为基础平台审计查询功能，建议放置在基础平台左侧菜单：
|
||||
|
||||
```text
|
||||
基础平台
|
||||
└── 操作日志
|
||||
```
|
||||
|
||||
页面访问规则：
|
||||
|
||||
- 平台超级管理员可查询全部日志。
|
||||
- 平台运维人员可按授权范围查询日志。
|
||||
- 实施人员可按项目授权范围查询客户日志。
|
||||
- 客户管理员可按配置和授权范围查询本客户日志。
|
||||
- 普通业务用户不展示操作日志菜单。
|
||||
|
||||
### 5.10.6.2 操作日志列表页
|
||||
|
||||
展示方式：
|
||||
|
||||
- 查询区域 + 数据表格。
|
||||
- 查询条件较多时支持展开 / 收起。
|
||||
- 查询按钮作为查询区域最后一个表单元素。
|
||||
|
||||
查询条件：
|
||||
|
||||
| 查询项 | 控件类型 | 值来源 / 录入方式 | 说明 |
|
||||
| --- | --- | --- | --- |
|
||||
| 所属客户 | 客户选择器 / 只读文本 | 客户管理中已启用客户 | 平台用户可选；客户管理员只读当前客户 |
|
||||
| 操作用户 | 用户选择器 | 用户与账号管理中的用户 | 可为空 |
|
||||
| 来源应用 | 应用选择器 | 应用管理中的应用 | 可为空 |
|
||||
| 操作模块 | 下拉框 | 客户管理、应用管理、组织管理等 | 可为空 |
|
||||
| 操作类型 | 下拉框 | 新增、编辑、启用、停用、授权、回滚等 | 可为空 |
|
||||
| 操作对象 | 文本输入框 | 人工录入 | 支持按对象名称或编号查询 |
|
||||
| 操作结果 | 下拉框 | 全部、成功、失败、部分成功 | 默认全部 |
|
||||
| 操作时间 | 日期时间范围选择器 | 人工选择 | 必填或默认最近 7 天 |
|
||||
| 查询 | 按钮 | 用户点击 | 作为查询区域最后一个表单元素 |
|
||||
|
||||
列表字段：
|
||||
|
||||
| 字段 | 说明 |
|
||||
| --- | --- |
|
||||
| 操作时间 | 操作发生时间 |
|
||||
| 操作用户 | 执行操作用户 |
|
||||
| 所属客户 | 操作归属客户 |
|
||||
| 来源应用 | 操作发生应用 |
|
||||
| 操作模块 | 操作模块 |
|
||||
| 操作类型 | 新增、编辑、启用、停用等 |
|
||||
| 操作对象 | 对象名称和编号 |
|
||||
| 操作结果 | 成功、失败、部分成功 |
|
||||
| 操作 | 查看详情 |
|
||||
|
||||
### 5.10.6.3 操作日志详情页 / 弹窗
|
||||
|
||||
操作日志详情用于查看单条日志完整信息。
|
||||
|
||||
展示方式：
|
||||
|
||||
- 采用详情弹窗或右侧抽屉展示。
|
||||
- 变更前后摘要采用左右对比或上下分区展示。
|
||||
|
||||
详情区域：
|
||||
|
||||
| 区域 | 展示内容 |
|
||||
| --- | --- |
|
||||
| 基础信息 | 操作时间、操作用户、登录账号、所属客户、当前组织 |
|
||||
| 操作信息 | 来源应用、操作模块、操作类型、操作对象、操作结果 |
|
||||
| 变更摘要 | 变更前摘要、变更后摘要 |
|
||||
| 请求信息 | IP 地址、设备信息、请求流水号 |
|
||||
| 失败信息 | 失败原因、错误摘要 |
|
||||
|
||||
页面规则：
|
||||
|
||||
- 敏感字段按脱敏策略展示。
|
||||
- 普通查询人员不可查看完整敏感字段。
|
||||
- 失败原因展示给运维或实施人员时可更详细，展示给客户管理员时应控制技术细节。
|
||||
|
||||
### 5.10.6.4 操作日志导出
|
||||
|
||||
操作日志导出用于审计和问题排查。
|
||||
|
||||
业务规则：
|
||||
|
||||
- 只有具备日志导出权限的用户可导出。
|
||||
- 导出必须受当前查询条件和数据权限限制。
|
||||
- 导出操作本身必须记录操作日志。
|
||||
- 导出文件有效期由基础配置管理控制。
|
||||
|
||||
## 5.10.7 使用导航
|
||||
|
||||
### 5.10.7.1 查询操作日志
|
||||
|
||||
操作路径：
|
||||
|
||||
```text
|
||||
基础平台 > 操作日志
|
||||
```
|
||||
|
||||
操作步骤：
|
||||
|
||||
1. 进入操作日志列表页。
|
||||
2. 按所属客户、操作用户、来源应用、操作模块、操作类型、操作对象、操作结果或操作时间查询。
|
||||
3. 在列表中查看日志。
|
||||
|
||||
### 5.10.7.2 查看日志详情
|
||||
|
||||
操作路径：
|
||||
|
||||
```text
|
||||
基础平台 > 操作日志 > 查看详情
|
||||
```
|
||||
|
||||
操作步骤：
|
||||
|
||||
1. 查询目标日志。
|
||||
2. 点击查看详情。
|
||||
3. 系统打开日志详情页或弹窗。
|
||||
4. 查看基础信息、操作信息、变更摘要、请求信息和失败信息。
|
||||
|
||||
### 5.10.7.3 导出操作日志
|
||||
|
||||
操作路径：
|
||||
|
||||
```text
|
||||
基础平台 > 操作日志 > 导出
|
||||
```
|
||||
|
||||
操作步骤：
|
||||
|
||||
1. 进入操作日志列表页。
|
||||
2. 设置查询条件。
|
||||
3. 点击导出。
|
||||
4. 系统校验导出权限。
|
||||
5. 系统按当前查询条件生成导出文件。
|
||||
6. 系统记录导出操作日志。
|
||||
|
||||
## 5.10.8 验收标准
|
||||
|
||||
- 客户管理、应用管理、组织管理、用户与账号管理、角色管理、基础配置管理、消息与待办、数据字典、城市管理、支行信息管理的关键操作均生成操作日志。
|
||||
- 登录成功、登录失败、退出登录、账号锁定、密码重置等安全操作均生成日志。
|
||||
- 新增、编辑、启用、停用、授权、绑定、解绑、回滚、导入、导出等操作均可记录。
|
||||
- 操作失败场景可记录失败日志和失败原因。
|
||||
- 操作日志包含操作时间、操作用户、所属客户、来源应用、操作模块、操作类型、操作对象和操作结果。
|
||||
- 操作日志支持按客户、用户、应用、模块、类型、对象、结果和时间查询。
|
||||
- 操作日志详情可查看变更前后摘要。
|
||||
- 敏感字段不明文展示。
|
||||
- 不同客户之间日志隔离。
|
||||
- 普通用户不可修改或删除操作日志。
|
||||
- 具备权限的用户可导出操作日志，导出动作本身生成操作日志。
|
||||
|
||||
@@ -4,26 +4,369 @@
|
||||
|
||||
上级文档：[基础平台产品设计](../基础平台产品设计.md)
|
||||
|
||||
|
||||
## 5.11.1 功能说明
|
||||
|
||||
数据字典用于维护基础枚举类数据，供各业务系统复用。
|
||||
数据字典用于维护基础平台和各业务应用可复用的枚举、状态值、颜色和展示顺序，为前端页面、后端接口、查询条件、状态标签和下拉选项提供统一值域来源。
|
||||
|
||||
数据字典解决以下问题：
|
||||
|
||||
- 统一维护字典编号和字典名称。
|
||||
- 统一维护字典值编码、名称、排序、颜色、状态和备注。
|
||||
- 支持按归属业务系统筛选字典。
|
||||
- 支持业务系统按字典编号查询字典值。
|
||||
- 支持停用字典或字典值后不影响历史数据展示。
|
||||
|
||||
数据字典不负责：
|
||||
|
||||
- 多语言文案维护。
|
||||
- 字典审批、发布和版本管理。
|
||||
- 字典值被业务引用后的统一反查。
|
||||
- 字典自动同步到其他系统。
|
||||
- 复杂业务规则配置。
|
||||
|
||||
## 5.11.2 功能范围
|
||||
|
||||
- 字典分类
|
||||
- 字典项
|
||||
- 启用 / 停用字典项
|
||||
- 字典项排序
|
||||
- 字典列表查询
|
||||
- 字典详情查询
|
||||
- 新增字典
|
||||
- 编辑字典
|
||||
- 删除字典
|
||||
- 字典值维护
|
||||
- 字典值新增
|
||||
- 字典值删除
|
||||
- 字典值启用 / 停用
|
||||
- 字典值排序
|
||||
- 字典值颜色维护
|
||||
- 按归属业务系统筛选
|
||||
- 按字典编号查询字典值
|
||||
|
||||
## 5.11.3 业务规则
|
||||
## 5.11.3 管理对象
|
||||
|
||||
- 字典编码唯一。
|
||||
- 停用字典项后，不影响历史数据展示。
|
||||
- 字典变更需记录日志。
|
||||
数据字典首版只维护一个管理对象：字典。
|
||||
|
||||
## 5.11.4 验收标准
|
||||
每条字典记录归属于一个业务系统，并包含一组字典值。字典值不单独作为顶层管理对象，在字典新增 / 编辑抽屉内维护。
|
||||
|
||||
- 可维护字典分类和字典项。
|
||||
- 业务系统可使用启用状态的字典项。
|
||||
- 停用字典项不影响历史数据。
|
||||
对象关系：
|
||||
|
||||
- 一个业务系统可拥有多个字典。
|
||||
- 一个字典拥有多个字典值。
|
||||
- 字典编号在未删除数据内唯一。
|
||||
- 字典值编码在同一字典内唯一。
|
||||
|
||||
## 5.11.4 字段要求
|
||||
|
||||
### 5.11.4.1 字典字段
|
||||
|
||||
字典信息至少包括：
|
||||
|
||||
| 字段 | 说明 | 是否必填 |
|
||||
| --- | --- | --- |
|
||||
| 字典编号 | 字典唯一编号 | 是 |
|
||||
| 字典名称 | 字典展示名称 | 是 |
|
||||
| 归属业务系统 | 字典归属系统 | 是 |
|
||||
| 启用状态 | 启用、停用 | 是 |
|
||||
| 备注 | 字典说明 | 否 |
|
||||
| 字典值列表 | 当前字典包含的值列表 | 是 |
|
||||
| 创建时间 | 字典创建时间 | 是 |
|
||||
| 更新时间 | 字典最近更新时间 | 是 |
|
||||
|
||||
### 5.11.4.2 字典值字段
|
||||
|
||||
字典值信息至少包括：
|
||||
|
||||
| 字段 | 说明 | 是否必填 |
|
||||
| --- | --- | --- |
|
||||
| 字典值编码 | 字典值唯一编码 | 是 |
|
||||
| 字典值名称 | 字典值展示名称 | 是 |
|
||||
| 排序 | 字典值展示顺序 | 是 |
|
||||
| 展示颜色 | 字典值在标签、状态等场景中的展示颜色 | 否 |
|
||||
| 启用状态 | 启用、停用 | 是 |
|
||||
| 备注 | 字典值说明 | 否 |
|
||||
|
||||
## 5.11.5 编码与校验规则
|
||||
|
||||
### 5.11.5.1 字典编号规则
|
||||
|
||||
字典编号用于业务系统查询字典值，是前后端共同使用的稳定标识。
|
||||
|
||||
规则：
|
||||
|
||||
- 字典编号必填。
|
||||
- 字典编号保存前统一去除首尾空格并转小写。
|
||||
- 字典编号建议采用“表名_字段名”的蛇形命名方式。
|
||||
- 示例：`system_dictionary_status`、`system_user_status`、`system_app_type`。
|
||||
- 未删除数据内字典编号唯一。
|
||||
- 字典编号创建后原则上不允许修改。
|
||||
|
||||
### 5.11.5.2 字典字段校验
|
||||
|
||||
| 字段 | 校验规则 |
|
||||
| --- | --- |
|
||||
| 字典编号 | 必填，符合蛇形命名规则，未删除数据内唯一 |
|
||||
| 字典名称 | 必填，长度 2-32 个字符 |
|
||||
| 归属业务系统 | 必填，必须选择已存在业务系统 |
|
||||
| 启用状态 | 必填，只允许启用、停用 |
|
||||
| 备注 | 可空，最长 256 个字符 |
|
||||
| 字典值列表 | 必填，至少包含一个字典值 |
|
||||
|
||||
### 5.11.5.3 字典值校验
|
||||
|
||||
| 字段 | 校验规则 |
|
||||
| --- | --- |
|
||||
| 字典值编码 | 必填，同一字典内忽略大小写后不得重复 |
|
||||
| 字典值名称 | 必填 |
|
||||
| 排序 | 必填，必须大于 0 |
|
||||
| 展示颜色 | 可空，非空时必须符合十六进制颜色格式 |
|
||||
| 启用状态 | 必填，只允许启用、停用 |
|
||||
| 备注 | 可空 |
|
||||
|
||||
## 5.11.6 业务规则
|
||||
|
||||
- 字典必须归属于一个业务系统。
|
||||
- 字典编号未删除数据内唯一。
|
||||
- 字典值列表不能为空。
|
||||
- 同一字典内字典值编码不可重复。
|
||||
- 新增字典默认启用。
|
||||
- 新增字典值默认启用。
|
||||
- 停用字典后，业务系统默认不应继续读取该字典作为可选值。
|
||||
- 停用字典值后，不影响历史数据展示，但新增或编辑业务数据时不应再作为可选项。
|
||||
- 删除字典采用软删除。
|
||||
- 删除字典前，首版不做统一引用反查；后续接入业务引用关系后，应支持引用阻断删除。
|
||||
- 字典值排序由用户维护，拖拽排序后按顺序重建排序号。
|
||||
- 字典保存成功后，前端按编号查询的缓存应失效，重新查询应返回最新字典值。
|
||||
- 数据字典变更需要记录操作日志。
|
||||
|
||||
## 5.11.7 界面设计
|
||||
|
||||
### 5.11.7.1 功能入口与访问权限
|
||||
|
||||
数据字典作为基础平台基础资料管理功能，建议放置在基础平台左侧菜单：
|
||||
|
||||
```text
|
||||
基础平台
|
||||
└── 数据字典
|
||||
```
|
||||
|
||||
页面访问规则：
|
||||
|
||||
- 平台超级管理员可维护全部字典。
|
||||
- 产品管理员可维护其负责业务系统的字典。
|
||||
- 实施人员可按授权范围查看或维护字典。
|
||||
- 客户管理员默认不可维护系统级数据字典。
|
||||
- 普通业务用户不可访问数据字典页面。
|
||||
- 无数据字典权限的用户不展示数据字典菜单。
|
||||
|
||||
### 5.11.7.2 数据字典列表页
|
||||
|
||||
数据字典列表页用于查询和维护字典。
|
||||
|
||||
展示方式：
|
||||
|
||||
- 查询区域 + 数据表格 + 分页。
|
||||
- 新增 / 编辑采用右侧抽屉。
|
||||
- 查询条件较多时支持展开 / 收起。
|
||||
- 查询按钮作为查询区域最后一个表单元素。
|
||||
|
||||
查询条件：
|
||||
|
||||
| 查询项 | 控件类型 | 值来源 / 录入方式 | 说明 |
|
||||
| --- | --- | --- | --- |
|
||||
| 关键字 | 文本输入框 | 人工录入 | 匹配字典编号、字典名称、备注、字典值 |
|
||||
| 启用状态 | 下拉框 | 全部、启用、停用 | 默认全部 |
|
||||
| 归属业务系统 | 下拉框 / 应用选择器 | 应用管理中已启用业务系统 | 可为空 |
|
||||
| 查询 | 按钮 | 用户点击 | 作为查询区域最后一个表单元素 |
|
||||
| 重置 | 按钮 | 用户点击 | 清空查询条件 |
|
||||
|
||||
列表字段：
|
||||
|
||||
| 字段 | 说明 |
|
||||
| --- | --- |
|
||||
| 字典编号 | 字典唯一编号 |
|
||||
| 字典名称 | 字典展示名称 |
|
||||
| 归属业务系统 | 字典归属系统 |
|
||||
| 启用状态 | 启用、停用 |
|
||||
| 字典值预览 | 最多展示前三个字典值，超出部分显示数量提示 |
|
||||
| 备注 | 字典说明 |
|
||||
| 更新时间 | 最近更新时间 |
|
||||
| 操作 | 编辑、删除 |
|
||||
|
||||
页面规则：
|
||||
|
||||
- 默认分页大小为 20。
|
||||
- 字典值预览最多展示前三个值。
|
||||
- 删除必须二次确认。
|
||||
- 删除成功后刷新列表并失效对应缓存。
|
||||
|
||||
### 5.11.7.3 字典新增 / 编辑抽屉
|
||||
|
||||
字典新增 / 编辑抽屉用于维护字典基础信息和字典值列表。
|
||||
|
||||
展示方式：
|
||||
|
||||
- 右侧抽屉。
|
||||
- 上方为基础信息表单。
|
||||
- 下方为字典值列表。
|
||||
- 底部固定操作按钮：取消、保存。
|
||||
|
||||
基础信息字段：
|
||||
|
||||
| 字段 | 控件类型 | 值来源 / 录入方式 | 说明 |
|
||||
| --- | --- | --- | --- |
|
||||
| 字典编号 | 文本输入框 | 人工录入 | 必填，编辑时只读 |
|
||||
| 字典名称 | 文本输入框 | 人工录入 | 必填 |
|
||||
| 归属业务系统 | 下拉框 / 应用选择器 | 应用管理中已启用业务系统 | 必填 |
|
||||
| 启用状态 | Switch | 人工选择 | 默认启用 |
|
||||
| 备注 | 多行文本框 | 人工录入 | 选填 |
|
||||
|
||||
字典值列表字段：
|
||||
|
||||
| 字段 | 控件类型 | 值来源 / 录入方式 | 说明 |
|
||||
| --- | --- | --- | --- |
|
||||
| 字典值编码 | 文本输入框 | 人工录入 | 必填，同一字典内唯一 |
|
||||
| 字典值名称 | 文本输入框 | 人工录入 | 必填 |
|
||||
| 排序 | 数字输入框 / 拖拽排序 | 人工录入或拖拽生成 | 必填 |
|
||||
| 展示颜色 | 颜色选择器 / 文本输入框 | 人工选择或录入 | 选填 |
|
||||
| 启用状态 | Switch | 人工选择 | 默认启用 |
|
||||
| 备注 | 文本输入框 | 人工录入 | 选填 |
|
||||
| 操作 | 按钮 | 用户点击 | 新增、删除、上移、下移 |
|
||||
|
||||
页面规则：
|
||||
|
||||
- 字典值列表不能为空。
|
||||
- 支持新增字典值。
|
||||
- 支持删除字典值。
|
||||
- 支持拖拽排序或上移、下移。
|
||||
- 支持启用、停用单个字典值。
|
||||
- 保存前前端先做基础校验，后端再次执行同等或更严格校验。
|
||||
- 保存失败时保留表单输入并展示中文错误信息。
|
||||
|
||||
### 5.11.7.4 字典详情页 / 弹窗
|
||||
|
||||
字典详情用于查看字典基础信息和字典值列表。
|
||||
|
||||
展示方式：
|
||||
|
||||
- 采用详情弹窗或右侧抽屉展示。
|
||||
|
||||
详情内容：
|
||||
|
||||
| 区域 | 展示内容 |
|
||||
| --- | --- |
|
||||
| 基础信息 | 字典编号、字典名称、归属业务系统、启用状态、备注 |
|
||||
| 字典值列表 | 字典值编码、字典值名称、排序、颜色、启用状态、备注 |
|
||||
| 审计信息 | 创建时间、更新时间、创建人、更新人 |
|
||||
|
||||
## 5.11.8 使用导航
|
||||
|
||||
### 5.11.8.1 查询数据字典
|
||||
|
||||
操作路径：
|
||||
|
||||
```text
|
||||
基础平台 > 数据字典
|
||||
```
|
||||
|
||||
操作步骤：
|
||||
|
||||
1. 进入数据字典列表页。
|
||||
2. 按关键字、启用状态、归属业务系统查询。
|
||||
3. 查看字典列表和字典值预览。
|
||||
|
||||
### 5.11.8.2 新增数据字典
|
||||
|
||||
操作路径：
|
||||
|
||||
```text
|
||||
基础平台 > 数据字典 > 新增
|
||||
```
|
||||
|
||||
操作步骤：
|
||||
|
||||
1. 进入数据字典列表页。
|
||||
2. 点击新增。
|
||||
3. 系统打开字典新增 / 编辑抽屉。
|
||||
4. 填写字典编号、字典名称、归属业务系统、启用状态和备注。
|
||||
5. 新增至少一个字典值。
|
||||
6. 填写字典值编码、字典值名称、排序、颜色、状态和备注。
|
||||
7. 保存字典。
|
||||
8. 系统校验字典编号唯一性、字典值唯一性和颜色格式。
|
||||
9. 保存成功后刷新列表并记录操作日志。
|
||||
|
||||
### 5.11.8.3 编辑数据字典
|
||||
|
||||
操作路径：
|
||||
|
||||
```text
|
||||
基础平台 > 数据字典 > 编辑
|
||||
```
|
||||
|
||||
操作步骤：
|
||||
|
||||
1. 查询目标字典。
|
||||
2. 点击编辑。
|
||||
3. 系统打开字典新增 / 编辑抽屉。
|
||||
4. 修改字典名称、归属业务系统、启用状态、备注或字典值列表。
|
||||
5. 保存字典。
|
||||
6. 系统校验字典值唯一性和颜色格式。
|
||||
7. 保存成功后刷新列表、失效按编号查询缓存，并记录操作日志。
|
||||
|
||||
### 5.11.8.4 删除数据字典
|
||||
|
||||
操作路径：
|
||||
|
||||
```text
|
||||
基础平台 > 数据字典 > 删除
|
||||
```
|
||||
|
||||
操作步骤：
|
||||
|
||||
1. 查询目标字典。
|
||||
2. 点击删除。
|
||||
3. 系统二次确认删除操作。
|
||||
4. 删除成功后刷新列表、失效对应缓存，并记录操作日志。
|
||||
|
||||
### 5.11.8.5 按编号使用数据字典
|
||||
|
||||
使用场景：
|
||||
|
||||
```text
|
||||
业务系统页面 / 接口 > 按字典编号查询字典值
|
||||
```
|
||||
|
||||
业务步骤：
|
||||
|
||||
1. 业务系统按字典编号请求字典详情。
|
||||
2. 基础平台返回字典基础信息和字典值列表。
|
||||
3. 业务系统可按需要只使用启用状态字典值。
|
||||
4. 字典被编辑或删除后，对应编号缓存失效。
|
||||
|
||||
## 5.11.9 权限资源
|
||||
|
||||
数据字典建议纳入应用菜单与按钮资源治理。
|
||||
|
||||
资源编码建议：
|
||||
|
||||
| 操作 | 权限资源 |
|
||||
| --- | --- |
|
||||
| 查看列表 | system.dictionary.view |
|
||||
| 新增字典 | system.dictionary.create |
|
||||
| 编辑字典 | system.dictionary.update |
|
||||
| 删除字典 | system.dictionary.delete |
|
||||
|
||||
前端按钮显隐只消费后端授权结果；后端接口仍必须做真实权限校验，不能只依赖前端隐藏按钮。
|
||||
|
||||
## 5.11.10 验收标准
|
||||
|
||||
- 数据字典列表默认分页大小为 20。
|
||||
- 可按关键字、启用状态、归属业务系统查询数据字典。
|
||||
- 新增字典时，非法编号、空名称、空归属业务系统、空字典值必须被阻断。
|
||||
- 字典编号重复时，后端必须阻断保存。
|
||||
- 同一字典内重复字典值编码时，前端和后端均需阻断保存。
|
||||
- 非法颜色格式必须被前端和后端阻断。
|
||||
- 字典值支持新增、删除、启用、停用、排序、颜色和备注维护。
|
||||
- 字典值预览最多展示前三个值，超出部分以数量提示。
|
||||
- 编辑后按编号查询缓存必须失效，重新查询应返回最新字典值。
|
||||
- 删除字典必须二次确认。
|
||||
- 删除成功后列表刷新；删除不存在的字典应提示字典不存在。
|
||||
- 停用字典值不影响历史数据展示。
|
||||
- 数据字典新增、编辑、删除、字典值变更均生成操作日志。
|
||||
|
||||
534
40-平台与架构/基础平台/功能模块/12-城市管理.md
Normal file
534
40-平台与架构/基础平台/功能模块/12-城市管理.md
Normal file
@@ -0,0 +1,534 @@
|
||||
# 5.12 城市管理
|
||||
|
||||
本文档从《基础平台产品设计》第 5 章拆分而来，用于独立描述基础平台功能模块的业务需求、规则和验收标准。
|
||||
|
||||
上级文档：[基础平台产品设计](../基础平台产品设计.md)
|
||||
|
||||
## 5.12.1 功能说明
|
||||
|
||||
城市管理用于维护基础平台中的国家与行政区划主数据，为门店、组织、供应链、营销、结算、报表、门店选址规划系统等业务场景提供统一的地区引用来源。
|
||||
|
||||
城市管理首版解决以下问题：
|
||||
|
||||
- 管理国家主数据。
|
||||
- 管理省份、城市、区县、街道四级行政层级。
|
||||
- 维护内部城市编码、国家码和外部系统城市编码映射。
|
||||
- 支持按国家浏览城市树。
|
||||
- 支持按名称、编码、层级、状态查询城市节点。
|
||||
- 支持新增、编辑、启用、停用和删除城市节点。
|
||||
- 为后续业务系统引用国家与城市主数据提供稳定 ID、编码、层级和经纬度字段。
|
||||
|
||||
城市管理不负责：
|
||||
|
||||
- 门店、组织、人员等业务对象的城市归属维护。
|
||||
- 第三方地图或地理编码 API 调用。
|
||||
- 真实行政区划数据自动同步。
|
||||
- 跨系统城市数据分发任务编排。
|
||||
- 业务系统本地缓存刷新策略。
|
||||
- 行政区划版本更新和批量导入，首版仅预留后续扩展。
|
||||
|
||||
## 5.12.2 功能范围
|
||||
|
||||
- 国家主数据维护
|
||||
- 城市主数据维护
|
||||
- 父子行政层级维护
|
||||
- 城市编码维护
|
||||
- 外部城市编码维护
|
||||
- 经纬度基础信息维护
|
||||
- 排序维护
|
||||
- 启用 / 停用
|
||||
- 删除前子级校验
|
||||
- 删除前业务引用约束校验预留
|
||||
- 城市树懒加载查询
|
||||
- 城市分页查询
|
||||
- 城市详情查询
|
||||
|
||||
## 5.12.3 管理对象
|
||||
|
||||
城市管理包含两个核心对象：国家和城市节点。
|
||||
|
||||
国家不作为城市树节点，国家通过页面顶部国家上下文进行选择。城市树只展示当前国家下的省、市、区县、街道四级节点。
|
||||
|
||||
城市节点层级固定为：
|
||||
|
||||
| 层级值 | 语义 | 说明 |
|
||||
| --- | --- | --- |
|
||||
| 1 | 省份 | 城市树根节点 |
|
||||
| 2 | 城市 | 省份下级 |
|
||||
| 3 | 区县 | 城市下级 |
|
||||
| 4 | 街道 | 区县下级，首版不允许继续新增子级 |
|
||||
|
||||
## 5.12.4 字段要求
|
||||
|
||||
### 5.12.4.1 国家字段
|
||||
|
||||
国家信息至少包括：
|
||||
|
||||
| 字段 | 说明 | 是否必填 |
|
||||
| --- | --- | --- |
|
||||
| 国家名称 | 国家正式名称，例如中国 | 是 |
|
||||
| 国家简称 | 国家简称 | 否 |
|
||||
| 国家码 | 电话国家码，例如中国为 86 | 是 |
|
||||
| ISO Alpha-2 | ISO 3166-1 alpha-2，例如 CN | 否 |
|
||||
| ISO Alpha-3 | ISO 3166-1 alpha-3，例如 CHN | 否 |
|
||||
| 排序 | 国家列表展示顺序 | 是 |
|
||||
| 启用状态 | 启用、停用 | 是 |
|
||||
| 创建时间 | 国家档案创建时间 | 是 |
|
||||
| 更新时间 | 国家档案最近更新时间 | 是 |
|
||||
|
||||
### 5.12.4.2 城市节点字段
|
||||
|
||||
城市节点信息至少包括：
|
||||
|
||||
| 字段 | 说明 | 是否必填 |
|
||||
| --- | --- | --- |
|
||||
| 父级城市 | 当前节点的父级城市；省份为空 | 条件必填 |
|
||||
| 城市名称 | 省、市、区县、街道名称 | 是 |
|
||||
| 城市简称 | 城市简称 | 否 |
|
||||
| 国家码 | 当前城市所属国家码 | 是 |
|
||||
| 城市编码 | 行政业务编码，固定 8 位 | 是 |
|
||||
| 外部编码 1 | 外部系统城市编码 1 | 否 |
|
||||
| 外部编码 2 | 外部系统城市编码 2 | 否 |
|
||||
| 层级 | 省份、城市、区县、街道 | 是 |
|
||||
| 经度 | 城市经度 | 否 |
|
||||
| 纬度 | 城市纬度 | 否 |
|
||||
| 排序 | 同级节点展示顺序 | 是 |
|
||||
| 启用状态 | 启用、停用 | 是 |
|
||||
| 创建时间 | 城市节点创建时间 | 是 |
|
||||
| 更新时间 | 城市节点最近更新时间 | 是 |
|
||||
|
||||
## 5.12.5 编码规则
|
||||
|
||||
### 5.12.5.1 国家码
|
||||
|
||||
国家码用于表达国家或地区电话国家码，当前中国默认为 `86`。
|
||||
|
||||
业务规则：
|
||||
|
||||
- 国家码必填。
|
||||
- 国家码只允许数字。
|
||||
- 国家码全局唯一。
|
||||
- 当前只维护中国城市主数据时，系统默认初始化中国 `86`。
|
||||
- 已存在城市节点的国家，首版不允许修改国家码。
|
||||
|
||||
### 5.12.5.2 城市编码
|
||||
|
||||
城市编码用于表达行政业务编码，不拼接国家码，固定为 8 位数字。
|
||||
|
||||
编码规则：
|
||||
|
||||
| 节点类型 | 编码规则 | 示例 |
|
||||
| --- | --- | --- |
|
||||
| 省份 | 省份 2 位 + 6 位补零 | 43000000 |
|
||||
| 城市 | 省份 2 位 + 城市 2 位 + 4 位补零 | 43010000 |
|
||||
| 区县 | 省份 2 位 + 城市 2 位 + 区县 2 位 + 2 位补零 | 43010200 |
|
||||
| 街道 | 省份 2 位 + 城市 2 位 + 区县 2 位 + 街道 2 位 | 43010201 |
|
||||
|
||||
业务规则：
|
||||
|
||||
- 城市编码只允许数字，且固定 8 位。
|
||||
- 城市编码不拼接国家码。
|
||||
- 如接口或外部系统需要完整跨国编码，可由国家码 + 城市编码派生。
|
||||
- 省直辖县级市等特殊行政编码需要保留有效行政码，避免压缩后丢失唯一性。
|
||||
- 外部编码 1、外部编码 2 只用于外部系统城市编码映射，不参与行政层级判断。
|
||||
|
||||
## 5.12.6 业务规则
|
||||
|
||||
### 5.12.6.1 国家规则
|
||||
|
||||
- 国家管理首版不新增独立菜单，入口固定放在城市管理页顶部国家上下文右侧。
|
||||
- 国家码必填且全局唯一。
|
||||
- ISO Alpha-2、ISO Alpha-3 可为空，非空时必须全局唯一。
|
||||
- 禁用国家后，不影响历史城市数据展示。
|
||||
- 禁用国家后，不允许在该国家下新增城市节点。
|
||||
- 删除国家前，必须校验该国家下是否存在未删除城市节点。
|
||||
- 若国家下存在未删除城市节点，禁止删除国家。
|
||||
|
||||
### 5.12.6.2 城市层级规则
|
||||
|
||||
- 城市树根节点直接展示省份，不展示国家节点。
|
||||
- 省份节点父级城市为空，层级必须为省份。
|
||||
- 非省份节点必须选择父级城市。
|
||||
- 非省份节点层级必须等于父级层级加 1。
|
||||
- 非省份节点国家码必须与父节点一致。
|
||||
- 街道节点不允许继续新增子级。
|
||||
- 编辑城市节点时，首版不允许修改层级。
|
||||
- 如后续需要调整城市层级或父级，应单独设计“移动城市节点”能力。
|
||||
|
||||
### 5.12.6.3 启停与删除规则
|
||||
|
||||
- 停用城市节点后，历史数据仍可展示。
|
||||
- 停用城市节点后，不允许在该节点下新增子级。
|
||||
- 停用节点在城市树中弱化展示，但不隐藏。
|
||||
- 删除城市节点必须二次确认。
|
||||
- 删除城市节点前，必须校验是否存在未删除子节点。
|
||||
- 如存在未删除子节点，禁止删除。
|
||||
- 删除城市节点前预留业务引用检查；当门店、组织、供应链、结算等系统已引用该城市时，禁止删除。
|
||||
|
||||
### 5.12.6.4 查询规则
|
||||
|
||||
- 国家上下文决定当前城市树和城市列表的数据范围。
|
||||
- 当前只维护中国城市主数据时，页面默认显示中国 `86`。
|
||||
- 存在多个启用国家时，页面展示国家下拉筛选器。
|
||||
- 查询关键字支持匹配城市名称、简称、国家码、城市编码、外部编码 1、外部编码 2。
|
||||
- 层级按省份、城市、区县、街道精确筛选。
|
||||
- 状态按启用、停用精确筛选。
|
||||
- 查询区支持按 Enter 键触发查询。
|
||||
|
||||
## 5.12.7 界面设计
|
||||
|
||||
### 5.12.7.1 功能入口与访问权限
|
||||
|
||||
城市管理作为基础平台基础资料管理功能，建议放置在基础平台左侧菜单：
|
||||
|
||||
```text
|
||||
基础平台
|
||||
└── 城市管理
|
||||
```
|
||||
|
||||
页面访问规则：
|
||||
|
||||
- 平台超级管理员可维护国家和城市主数据。
|
||||
- 平台实施人员可按授权范围维护国家和城市主数据。
|
||||
- 客户管理员默认不维护城市主数据，只能在业务系统中引用城市。
|
||||
- 普通业务用户不可访问城市管理页面。
|
||||
- 无城市管理权限的用户不展示城市管理菜单。
|
||||
|
||||
### 5.12.7.2 页面结构
|
||||
|
||||
城市管理采用“国家管理入口 + 国家上下文 + 查询区 + 左树右表 + 抽屉表单”的结构。
|
||||
|
||||
```text
|
||||
┌──────────────────────────────────────────────────────────────────────────────┐
|
||||
│ 国家上下文：国家 = 中国（86） [国家管理] │
|
||||
├──────────────────────────────────────────────────────────────────────────────┤
|
||||
│ 关键字：[ ] 层级：[全部 v] 状态：[全部 v] [查询] │
|
||||
├──────────────────────────┬───────────────────────────────────────────────────┤
|
||||
│ 城市树 │ 城市列表 │
|
||||
│ - 湖南省 43000000 │ 名称 简称 编码 外部编码 层级 经纬度 状态 排序 操作 │
|
||||
│ - 长沙市 43010000 │ 长沙市 长沙 43010000 ... 城市 ... 启用 1 编辑 │
|
||||
│ - 芙蓉区 43010200 │ │
|
||||
├──────────────────────────┴───────────────────────────────────────────────────┤
|
||||
│ 抽屉：新增 / 编辑城市节点 │
|
||||
└──────────────────────────────────────────────────────────────────────────────┘
|
||||
```
|
||||
|
||||
页面区域规则：
|
||||
|
||||
- 国家上下文固定在页面顶部。
|
||||
- 国家管理入口放在国家上下文右侧。
|
||||
- 查询区位于国家上下文下方。
|
||||
- 主体区域左侧为城市树，右侧为城市列表。
|
||||
- 抽屉从右侧打开，用于新增和编辑城市节点。
|
||||
- 移动端或窄屏下，左侧树可改为顶部下拉树选择器，列表仍作为主工作区。
|
||||
|
||||
### 5.12.7.3 国家管理弹窗
|
||||
|
||||
国家管理用于维护国家主数据，首版采用列表 + 表单弹窗方式。
|
||||
|
||||
展示方式：
|
||||
|
||||
- 查询区域 + 国家列表。
|
||||
- 新增 / 编辑国家采用表单弹窗。
|
||||
|
||||
查询条件：
|
||||
|
||||
| 查询项 | 控件类型 | 值来源 / 录入方式 | 说明 |
|
||||
| --- | --- | --- | --- |
|
||||
| 关键字 | 文本输入框 | 人工录入 | 匹配国家名称、简称、国家码、ISO2、ISO3 |
|
||||
| 启用状态 | 下拉框 | 全部、启用、停用 | 默认全部 |
|
||||
| 查询 | 按钮 | 用户点击 | 作为查询区域最后一个表单元素 |
|
||||
|
||||
列表字段：
|
||||
|
||||
| 字段 | 说明 |
|
||||
| --- | --- |
|
||||
| 国家名称 | 国家正式名称 |
|
||||
| 国家简称 | 国家简称 |
|
||||
| 国家码 | 电话国家码 |
|
||||
| ISO Alpha-2 | ISO 2 位编码 |
|
||||
| ISO Alpha-3 | ISO 3 位编码 |
|
||||
| 启用状态 | 启用、停用 |
|
||||
| 排序 | 展示顺序 |
|
||||
| 操作 | 编辑、启用、停用、删除 |
|
||||
|
||||
表单字段：
|
||||
|
||||
| 字段 | 控件类型 | 值来源 / 录入方式 | 说明 |
|
||||
| --- | --- | --- | --- |
|
||||
| 国家名称 | 文本输入框 | 人工录入 | 必填 |
|
||||
| 国家简称 | 文本输入框 | 人工录入 | 选填 |
|
||||
| 国家码 | 文本输入框 | 人工录入 | 必填，全局唯一 |
|
||||
| ISO Alpha-2 | 文本输入框 | 人工录入 | 选填，非空唯一 |
|
||||
| ISO Alpha-3 | 文本输入框 | 人工录入 | 选填，非空唯一 |
|
||||
| 启用状态 | Radio | 启用、停用 | 必填 |
|
||||
| 排序 | 数字输入框 | 人工录入 | 默认 1 |
|
||||
|
||||
### 5.12.7.4 国家上下文
|
||||
|
||||
国家上下文用于展示和限定当前城市树所属国家。
|
||||
|
||||
展示规则：
|
||||
|
||||
- 当前只维护中国城市主数据时，显示只读文本：中国（86）。
|
||||
- 存在多个启用国家时，展示国家下拉选择器。
|
||||
- 切换国家后，左侧城市树和右侧列表整体刷新。
|
||||
- 所有树查询、列表查询、新增、编辑请求都携带当前国家码。
|
||||
- 新增省份时，表单自动带入当前国家码。
|
||||
- 新增市、区县、街道时，表单继承父节点国家码。
|
||||
|
||||
### 5.12.7.5 查询区
|
||||
|
||||
查询区用于在当前国家范围内检索城市节点。
|
||||
|
||||
查询条件：
|
||||
|
||||
| 查询项 | 控件类型 | 值来源 / 录入方式 | 说明 |
|
||||
| --- | --- | --- | --- |
|
||||
| 关键字 | 文本输入框 | 人工录入 | 匹配名称、简称、国家码、城市编码、外部编码 |
|
||||
| 层级 | 下拉框 | 全部、省份、城市、区县、街道 | 可为空 |
|
||||
| 启用状态 | 下拉框 | 全部、启用、停用 | 默认全部 |
|
||||
| 查询 | 按钮 | 用户点击 | 作为查询区域最后一个表单元素 |
|
||||
|
||||
页面规则：
|
||||
|
||||
- 查询区不提供重置按钮。
|
||||
- 支持按 Enter 键触发查询。
|
||||
|
||||
### 5.12.7.6 城市树区
|
||||
|
||||
城市树用于展示当前国家下的城市层级结构。
|
||||
|
||||
展示方式：
|
||||
|
||||
- 树形结构。
|
||||
- 懒加载直接子级。
|
||||
- 树节点展示城市名称，辅助展示城市编码。
|
||||
|
||||
页面规则：
|
||||
|
||||
- 默认只加载当前国家下的省份节点。
|
||||
- 默认按层级、排序、城市编码排序。
|
||||
- 点击树节点后，右侧列表默认查询该节点的直接子级。
|
||||
- 展开某个树节点时，只请求该节点直接子级。
|
||||
- 停用节点弱化展示，但不从树中隐藏。
|
||||
- 街道节点不展示展开控件。
|
||||
|
||||
### 5.12.7.7 城市列表区
|
||||
|
||||
城市列表用于维护当前筛选范围下的城市节点。
|
||||
|
||||
列表字段：
|
||||
|
||||
| 字段 | 说明 |
|
||||
| --- | --- |
|
||||
| 城市名称 | 城市节点名称 |
|
||||
| 城市简称 | 城市简称 |
|
||||
| 城市编码 | 8 位行政业务编码 |
|
||||
| 国家码 | 所属国家码 |
|
||||
| 外部编码 1 | 外部系统城市编码 1 |
|
||||
| 外部编码 2 | 外部系统城市编码 2 |
|
||||
| 层级 | 省份、城市、区县、街道 |
|
||||
| 经度 | 城市经度 |
|
||||
| 纬度 | 城市纬度 |
|
||||
| 启用状态 | 启用、停用 |
|
||||
| 排序 | 同级展示顺序 |
|
||||
| 操作 | 新增子级、编辑、启用 / 停用、删除 |
|
||||
|
||||
页面规则：
|
||||
|
||||
- 默认每页 20 条。
|
||||
- 支持切换每页条数。
|
||||
- 空状态文案为：暂无城市数据。
|
||||
- 删除必须二次确认。
|
||||
- 街道节点不展示新增子级操作。
|
||||
|
||||
### 5.12.7.8 城市新增 / 编辑抽屉
|
||||
|
||||
城市新增 / 编辑抽屉用于维护单个城市节点。
|
||||
|
||||
展示方式：
|
||||
|
||||
- 右侧抽屉。
|
||||
- 表单方式展示。
|
||||
- 底部固定操作按钮：取消、保存。
|
||||
|
||||
表单字段：
|
||||
|
||||
| 字段 | 控件类型 | 值来源 / 录入方式 | 说明 |
|
||||
| --- | --- | --- | --- |
|
||||
| 父级城市 | 树形选择器 / 只读文本 | 当前城市树 | 新增子级时自动带入 |
|
||||
| 层级 | 只读文本 / 下拉框 | 根据父级自动计算 | 编辑时只读 |
|
||||
| 城市名称 | 文本输入框 | 人工录入 | 必填 |
|
||||
| 城市简称 | 文本输入框 | 人工录入 | 选填 |
|
||||
| 城市编码 | 文本输入框 | 人工录入 | 必填，8 位数字 |
|
||||
| 国家码 | 只读文本 | 当前国家上下文或父节点 | 必填 |
|
||||
| 外部编码 1 | 文本输入框 | 人工录入 | 选填 |
|
||||
| 外部编码 2 | 文本输入框 | 人工录入 | 选填 |
|
||||
| 经度 | 数字输入框 | 人工录入 | 选填 |
|
||||
| 纬度 | 数字输入框 | 人工录入 | 选填 |
|
||||
| 启用状态 | Radio | 启用、停用 | 必填 |
|
||||
| 排序 | 数字输入框 | 人工录入 | 默认 1 |
|
||||
|
||||
表单规则：
|
||||
|
||||
- 从新增子级进入时，父级城市自动带入，层级自动等于父级层级加 1。
|
||||
- 新增省份时，父级城市为空，层级只能为省份。
|
||||
- 编辑时不允许随意修改层级。
|
||||
- 状态使用 Radio。
|
||||
- 排序默认值为 1。
|
||||
|
||||
## 5.12.8 字段校验
|
||||
|
||||
### 5.12.8.1 国家字段校验
|
||||
|
||||
| 字段 | 校验规则 |
|
||||
| --- | --- |
|
||||
| 国家名称 | 必填，长度 1-255 |
|
||||
| 国家简称 | 可空，最大长度 64 |
|
||||
| 国家码 | 必填，允许 1-3 位数字，全局唯一 |
|
||||
| ISO Alpha-2 | 可空，非空时必须为 2 位大写字母，且全局唯一 |
|
||||
| ISO Alpha-3 | 可空，非空时必须为 3 位大写字母，且全局唯一 |
|
||||
| 排序 | 必填，必须大于等于 0 |
|
||||
| 启用状态 | 必填，只允许启用或停用 |
|
||||
|
||||
### 5.12.8.2 城市字段校验
|
||||
|
||||
| 字段 | 校验规则 |
|
||||
| --- | --- |
|
||||
| 父级城市 | 省份可为空；非省份必填且必须是同国家下已存在父级城市 |
|
||||
| 城市名称 | 必填，长度 1-255 |
|
||||
| 城市简称 | 可空，最大长度 64 |
|
||||
| 国家码 | 必填，允许 1-3 位数字 |
|
||||
| 城市编码 | 固定 8 位数字 |
|
||||
| 外部编码 1 | 可空，最大长度 64 |
|
||||
| 外部编码 2 | 可空，最大长度 64 |
|
||||
| 层级 | 必填，只允许省份、城市、区县、街道 |
|
||||
| 排序 | 必填，必须大于等于 0 |
|
||||
| 经度 | 可空，范围 -180 到 180，保留 6 位小数 |
|
||||
| 纬度 | 可空，范围 -90 到 90，保留 6 位小数 |
|
||||
| 启用状态 | 必填，只允许启用或停用 |
|
||||
|
||||
## 5.12.9 使用导航
|
||||
|
||||
### 5.12.9.1 维护国家
|
||||
|
||||
操作路径：
|
||||
|
||||
```text
|
||||
基础平台 > 城市管理 > 国家管理
|
||||
```
|
||||
|
||||
操作步骤：
|
||||
|
||||
1. 进入城市管理页面。
|
||||
2. 点击国家管理。
|
||||
3. 查询国家列表。
|
||||
4. 新增、编辑、启用、停用或删除国家。
|
||||
5. 系统校验国家码唯一性和城市引用关系。
|
||||
6. 系统保存国家信息并记录操作日志。
|
||||
|
||||
### 5.12.9.2 查询城市
|
||||
|
||||
操作路径：
|
||||
|
||||
```text
|
||||
基础平台 > 城市管理
|
||||
```
|
||||
|
||||
操作步骤：
|
||||
|
||||
1. 进入城市管理页面。
|
||||
2. 确认当前国家上下文。
|
||||
3. 按关键字、层级、状态查询城市。
|
||||
4. 在左侧城市树选择节点。
|
||||
5. 在右侧列表查看该节点的直接子级或查询结果。
|
||||
|
||||
### 5.12.9.3 新增城市节点
|
||||
|
||||
操作路径：
|
||||
|
||||
```text
|
||||
基础平台 > 城市管理 > 城市列表 > 新增子级
|
||||
```
|
||||
|
||||
操作步骤：
|
||||
|
||||
1. 进入城市管理页面。
|
||||
2. 在城市树或城市列表中选择父级节点。
|
||||
3. 点击新增子级。
|
||||
4. 系统打开城市新增 / 编辑抽屉。
|
||||
5. 系统自动带入父级城市、层级和国家码。
|
||||
6. 填写城市名称、编码、外部编码、经纬度、状态和排序。
|
||||
7. 保存城市节点。
|
||||
8. 系统刷新城市树和城市列表，并记录操作日志。
|
||||
|
||||
### 5.12.9.4 编辑城市节点
|
||||
|
||||
操作路径：
|
||||
|
||||
```text
|
||||
基础平台 > 城市管理 > 城市列表 > 编辑
|
||||
```
|
||||
|
||||
操作步骤：
|
||||
|
||||
1. 查询目标城市节点。
|
||||
2. 点击编辑。
|
||||
3. 系统打开城市新增 / 编辑抽屉。
|
||||
4. 修改城市名称、简称、外部编码、经纬度、状态或排序。
|
||||
5. 保存城市节点。
|
||||
6. 系统刷新城市树和城市列表，并记录操作日志。
|
||||
|
||||
### 5.12.9.5 启用 / 停用城市节点
|
||||
|
||||
操作路径：
|
||||
|
||||
```text
|
||||
基础平台 > 城市管理 > 城市列表 > 启用 / 停用
|
||||
```
|
||||
|
||||
操作步骤：
|
||||
|
||||
1. 查询目标城市节点。
|
||||
2. 点击启用或停用。
|
||||
3. 停用时，系统提示停用影响。
|
||||
4. 确认操作。
|
||||
5. 系统更新城市状态，并记录操作日志。
|
||||
|
||||
### 5.12.9.6 删除城市节点
|
||||
|
||||
操作路径：
|
||||
|
||||
```text
|
||||
基础平台 > 城市管理 > 城市列表 > 删除
|
||||
```
|
||||
|
||||
操作步骤：
|
||||
|
||||
1. 查询目标城市节点。
|
||||
2. 点击删除。
|
||||
3. 系统二次确认删除操作。
|
||||
4. 系统校验是否存在未删除子节点。
|
||||
5. 系统预留校验是否存在业务引用。
|
||||
6. 校验通过后删除城市节点，并记录操作日志。
|
||||
|
||||
## 5.12.10 验收标准
|
||||
|
||||
- 可维护国家主数据。
|
||||
- 中国 `86` 可作为首版默认国家。
|
||||
- 城市树根节点直接展示省份，不展示国家节点。
|
||||
- 城市支持省份、城市、区县、街道四级层级。
|
||||
- 城市树支持懒加载直接子级。
|
||||
- 点击树节点后，右侧列表展示直接子级。
|
||||
- 可按关键字、层级、状态查询城市节点。
|
||||
- 可新增、编辑、启用、停用、删除城市节点。
|
||||
- 街道节点不可新增子级。
|
||||
- 停用节点在树中弱化展示但不隐藏。
|
||||
- 删除国家时，如存在城市节点，则禁止删除。
|
||||
- 删除城市节点时，如存在未删除子节点，则禁止删除。
|
||||
- 城市编码必须为 8 位数字。
|
||||
- 经度、纬度校验范围正确。
|
||||
- 无权限用户不可见国家管理和城市管理相关按钮。
|
||||
- 直接调用无权限接口时应被拒绝。
|
||||
- 国家新增、编辑、启用、停用、删除，以及城市新增、编辑、启用、停用、删除均生成操作日志。
|
||||
456
40-平台与架构/基础平台/功能模块/13-支行信息管理.md
Normal file
456
40-平台与架构/基础平台/功能模块/13-支行信息管理.md
Normal file
@@ -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。
|
||||
- 可按关键字、总行、省份、城市、状态查询支行信息。
|
||||
- 关键字可匹配总行编号、总行名称、支行号、支行名称、支行地址、银行侧城市编码。
|
||||
- 省份变化后，城市查询条件自动清空。
|
||||
- 新增支行信息时，启用状态下支行号和支行名称必填。
|
||||
- 支行号非空时必须校验全局唯一。
|
||||
- 支行号格式不合法时，前端和后端均必须阻断保存。
|
||||
- 城市非空但省份为空时，前端和后端均必须阻断保存。
|
||||
- 城市不属于所选省份时，前端和后端均必须阻断保存。
|
||||
- 银行侧城市编码与行政省市编码在页面上必须并列展示，不能混用。
|
||||
- 启用支行信息时，必须校验支行号和支行名称已填写。
|
||||
- 停用支行信息后，新增业务资料不可继续选择该支行。
|
||||
- 删除支行信息必须二次确认。
|
||||
- 存在业务引用的支行信息禁止删除。
|
||||
- 删除成功后，支行信息不在默认列表展示。
|
||||
- 支行信息新增、编辑、启停、删除均生成操作日志。
|
||||
@@ -15,3 +15,5 @@
|
||||
| 5.9 | 消息与待办 | [09-消息与待办.md](./09-消息与待办.md) |
|
||||
| 5.10 | 操作日志 | [10-操作日志.md](./10-操作日志.md) |
|
||||
| 5.11 | 数据字典 | [11-数据字典.md](./11-数据字典.md) |
|
||||
| 5.12 | 城市管理 | [12-城市管理.md](./12-城市管理.md) |
|
||||
| 5.13 | 支行信息管理 | [13-支行信息管理.md](./13-支行信息管理.md) |
|
||||
|
||||
@@ -43,6 +43,8 @@
|
||||
- 操作日志
|
||||
- 消息与待办基础能力
|
||||
- 基础数据字典
|
||||
- 城市管理
|
||||
- 支行信息管理
|
||||
- 业务系统接入管理
|
||||
|
||||
1.0 不展开：
|
||||
@@ -87,6 +89,8 @@
|
||||
- 消息与待办基础能力
|
||||
- 操作日志
|
||||
- 数据字典
|
||||
- 城市管理
|
||||
- 支行信息管理
|
||||
- 业务系统接入管理
|
||||
|
||||
基础平台不负责：
|
||||
@@ -197,6 +201,8 @@
|
||||
| 5.9 | 消息与待办 | [09-消息与待办.md](./功能模块/09-消息与待办.md) |
|
||||
| 5.10 | 操作日志 | [10-操作日志.md](./功能模块/10-操作日志.md) |
|
||||
| 5.11 | 数据字典 | [11-数据字典.md](./功能模块/11-数据字典.md) |
|
||||
| 5.12 | 城市管理 | [12-城市管理.md](./功能模块/12-城市管理.md) |
|
||||
| 5.13 | 支行信息管理 | [13-支行信息管理.md](./功能模块/13-支行信息管理.md) |
|
||||
|
||||
## 6. 跨模块业务规则
|
||||
|
||||
@@ -419,6 +425,8 @@
|
||||
| 配置管理 | 支持平台、客户、应用配置 | 是 |
|
||||
| 消息待办 | 支持消息查询、已读未读、待办跳转 | 是 |
|
||||
| 操作日志 | 支持关键操作记录和查询 | 是 |
|
||||
| 城市管理 | 支持国家、省、市、区县、街道主数据维护和城市树查询 | 是 |
|
||||
| 支行信息管理 | 支持银行总行、支行、支行号、银行侧城市编码和行政省市映射维护 | 是 |
|
||||
| 多客户隔离 | 客户数据不可互相访问 | 是 |
|
||||
| 停用规则 | 客户、组织、用户、角色、菜单停用规则正确 | 是 |
|
||||
|
||||
|
||||
Reference in New Issue
Block a user