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

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 页面不提交该配置的更新请求