# Change: 新增支付配置管理规范 ## Why `docs/mvp/支付配置.md` 已经定义了后台支付配置的 MVP 接口契约,但当前仓库缺少对应的 OpenSpec 能力说明。 现有前端实现仍以 `wechat-config` 命名该能力,且字段范围与读取语义和文档并不完全一致,例如文档包含统一的 `ali_*` 字段组、敏感字段脱敏规则和“当前生效配置”查询语义。如果不先把能力范围和契约写入 spec,后续 API、类型和页面实现会继续失同步。 ## What Changes - 新增 `payment-configuration-management` capability,覆盖支付配置列表、创建、详情、更新和当前生效配置查询。 - 定义统一的支付配置字段模型: - 基础字段:`id`、`name`、`description`、`provider_type`、`is_active`、`created_at`、`updated_at` - 渠道扩展字段:`wx_*`、`miniapp_*`、`oa_*`、`ali_*`、`fy_*` - 定义读取场景下的敏感字段脱敏规则和“已配置/未配置”状态展示语义。 - 明确 `provider_type` 枚举、分页筛选参数,以及更新接口按需提交字段的语义。 ## Impact - Affected specs: - `payment-configuration-management` - Affected code: - `src/api/modules/wechatConfig.ts` - `src/types/api/wechatConfig.ts` - `src/views/settings/wechat-config/index.vue` - `src/views/settings/wechat-config/detail.vue` - `src/views/dashboard/analysis/widget/ActiveWechatConfig.vue` - Dependencies: - `docs/mvp/支付配置.md` - 后端 `/api/admin/wechat-configs` 相关接口契约 - Breaking changes: - 不引入新的路由级破坏性变更,但前端现有 `wechat-config` 类型与展示可能需要补齐文档字段和脱敏语义