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