# 配置项管理

本文档为《基础配置管理》下的独立配置页面设计，用于描述该配置项目的配置清单、界面设计、业务规则和验收关注点。

上级文档：[基础配置管理](../08-基础配置管理.md)

## 界面设计

配置项管理页用于维护底层配置项定义和少量结构化配置，是场景化配置页面之外的兜底管理能力。

展示方式：

- 查询区域 + 数据表格。
- 新增 / 编辑采用抽屉表单。
- 抽屉包含基础信息和配置值编辑区。
- 抽屉底部固定操作按钮：取消、保存。

适用场景：

- 新增尚未纳入场景化页面的配置项。
- 查看配置编码、版本、状态、配置值预览。
- 维护少量结构化 JSON 配置。
- 查看版本记录并回滚。

查询条件：

| 查询项 | 控件类型 | 值来源 / 录入方式 | 说明 |
| --- | --- | --- | --- |
| 配置名称 | 文本输入框 | 人工录入 | 支持模糊查询 |
| 配置编码 | 文本输入框 | 人工录入 | 支持精确或模糊查询 |
| 配置分类 | 下拉框 | 配置分类字典 | 可为空 |
| 配置层级 | 下拉框 | 平台级、客户级、应用级 | 可为空 |
| 所属客户 | 客户选择器 | 客户管理中已启用客户 | 客户级配置使用 |
| 所属应用 | 应用选择器 | 应用管理中已启用应用 | 应用级配置使用 |
| 启用状态 | 下拉框 | 全部、启用、停用 | 默认全部 |
| 查询 | 按钮 | 用户点击 | 作为查询区域最后一个表单元素 |

列表字段：

| 字段 | 说明 |
| --- | --- |
| 配置名称 | 配置项展示名称 |
| 配置编码 | 配置项唯一编码 |
| 配置分类 | 配置所属分类 |
| 配置层级 | 平台级、客户级、应用级 |
| 版本 | 当前版本号 |
| 启用状态 | 启用、停用 |
| 配置值预览 | 配置值摘要展示 |
| 操作 | 查看、编辑、启用、停用、版本记录 |

抽屉基础信息字段：

| 字段 | 控件类型 | 值来源 / 录入方式 | 说明 |
| --- | --- | --- | --- |
| 配置名称 | 文本输入框 | 人工录入 | 必填 |
| 配置编码 | 文本输入框 | 人工录入 | 必填，编辑时只读 |
| 配置分类 | 下拉框 | 配置分类字典 | 必填 |
| 配置层级 | 下拉框 | 平台级、客户级、应用级 | 必填 |
| 所属客户 | 客户选择器 | 客户管理中已启用客户 | 客户级配置必填 |
| 所属应用 | 应用选择器 | 应用管理中已启用应用 | 应用级配置必填 |
| 配置值类型 | 下拉框 | JSON、文本、数字、布尔、枚举 | 必填 |
| 启用状态 | Switch | 人工选择 | 默认启用 |
| 版本 | 只读文本 | 当前配置版本 | 系统自动带入 |
| 备注 | 多行文本框 | 人工录入 | 选填 |

配置值编辑区：

- JSON 类型支持 JSON 编辑器。
- 简单配置支持键值对模式。
- 保存前需要完成配置值格式校验。
- 配置值较长时，列表页只展示配置值预览，详情页展示完整配置值。