one-pipe-system/openspec/changes/add-payment-configuration-management/proposal.md

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 类型与展示可能需要补齐文档字段和脱敏语义