feat: 系统配置

openspec/changes/add-system-config-management/specs/system-config-management/spec.md

@@ -0,0 +1,56 @@
+## ADDED Requirements
+
+### Requirement: 受控系统配置列表
+
+系统 SHALL 在设置管理提供受控系统配置列表，支持按 `module` 筛选和分页，并展示后端返回的配置元数据及当前值。
+
+#### Scenario: 查询系统配置
+
+- **WHEN** 用户进入系统配置页面或执行刷新
+- **THEN** 前端调用 `GET /api/admin/system-configs`
+- **AND** 使用响应中的 `data.list`、`data.page`、`data.page_size` 和 `data.total` 渲染列表
+- **AND** 展示配置 Key、模块、说明、值、控件提示、注册状态、只读状态、敏感状态和更新时间
+
+#### Scenario: 按模块筛选
+
+- **WHEN** 用户选择 `carrier_callback` 或 `c2b.payment`
+- **THEN** 查询请求携带对应的 `module` 参数
+- **AND** 页面从第一页展示筛选后的配置
+
+### Requirement: 动态配置编辑
+
+系统 SHALL 根据配置返回的 `control`、`value_type`、`enum_values`、`min` 和 `max` 元数据渲染编辑控件并进行前端基础校验；更新请求 SHALL 统一提交字符串形式的 `value`。
+
+#### Scenario: 更新可编辑配置
+
+- **WHEN** 用户修改非只读配置并提交
+- **THEN** 前端调用 `PUT /api/admin/system-configs/{key}`
+- **AND** 请求体为 `{ "key": "配置Key", "value": "字符串化配置值" }`
+- **AND** 成功后使用接口返回的配置数据更新列表
+
+#### Scenario: bool 和 int 配置
+
+- **WHEN** 配置类型分别为 `bool` 或 `int`
+- **THEN** 页面分别使用开关或数字输入控件
+- **AND** bool 提交 `true`/`false` 字符串，int 提交十进制数字字符串
+- **AND** int 值违反 `min` 或 `max` 时阻止提交
+
+#### Scenario: 枚举配置
+
+- **WHEN** 配置返回非空 `enum_values`
+- **THEN** 页面使用枚举选择控件
+- **AND** 只能提交允许的枚举值
+
+### Requirement: 只读和敏感配置保护
+
+系统 SHALL 禁止前端编辑只读配置；敏感配置 SHALL 展示接口返回的脱敏值，用户未主动输入新值时不得将该脱敏值再次提交。
+
+#### Scenario: 只读配置
+
+- **WHEN** 配置的 `readonly` 为 `true`
+- **THEN** 页面禁用编辑控件和保存操作
+
+#### Scenario: 敏感配置未修改
+
+- **WHEN** 敏感配置仅展示脱敏值且用户未输入新值
+- **THEN** 页面不提交该配置的更新请求