# 5.8 基础配置管理

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

上级文档：[基础平台产品设计](../基础平台产品设计.md)

## 5.8.1 功能说明

基础配置管理用于维护基础平台运行所需的平台级参数、客户级差异化参数、应用级接入参数和基础开关。

基础配置不承载业务系统的复杂业务规则。业务规则、业务流程、业务单据规则应放在对应业务系统中维护，例如对账规则放在连锁业务对账系统，分账规则放在分账系统，支付渠道规则放在聚合支付系统。

基础配置 1.0 重点解决：

- 配置可查询。
- 配置可新增和修改。
- 配置可启用和停用。
- 配置变更可记录。
- 配置值可结构化维护。
- 配置版本冲突可识别和回滚。

## 5.8.2 功能范围

- 查询配置列表
- 查看配置详情
- 新增配置
- 编辑配置
- 启用 / 停用配置
- 维护配置值
- 查看配置版本
- 回滚配置版本
- 查看配置操作记录

## 5.8.3 推荐基础配置清单

基础配置 1.0 建议按“先支撑基础平台运行，再支撑客户差异化，再支撑应用接入”的顺序建设。

### 5.8.3.1 平台运行配置

平台运行配置用于维护基础平台自身运行参数，由平台管理员维护。

推荐配置：

| 配置名称 | 配置说明 | 配置层级 | 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。
- 配置列表可展示配置值预览。
- 配置变更后生成新版本。
- 多人同时编辑同一配置时，系统可识别版本冲突。
- 可查看配置历史版本。
- 可回滚配置历史版本，回滚后生成新版本。
- 停用配置时能够提示配置影响。
- 平台级配置、客户级配置、应用级配置的维护权限正确。
- 配置新增、编辑、启用、停用、回滚均生成操作日志。