Files
2026-09-12 11:27:50 +08:00

2.2 KiB

ADDED Requirements

Requirement: 代理自充允许范围配置项

超级管理员维护的代理自充允许范围 SHALL 作为受控系统配置项,通过既有系统配置页面读取与更新,前端 MUST NOT 新增专用接口或专用页面。

Scenario: 通过系统配置读取允许范围

  • WHEN 超级管理员进入系统配置页面
  • THEN 前端 MUST 调用 GET /api/admin/system-configs 获取配置列表
  • AND 后端注册的代理自充允许范围配置项 MUST 依据返回元数据渲染
  • AND 前端 MUST NOT 为读取允许范围调用专用接口

Scenario: 以枚举控件编辑允许范围

  • GIVEN 允许范围配置项返回非空 enum_values
  • WHEN 超级管理员编辑该项
  • THEN 页面 MUST 使用枚举选择控件渲染允许范围
  • AND 页面 MUST 以字符串化 value 调用 PUT /api/admin/system-configs/{key}
  • AND 页面 MUST 在提交前校验取值属于 enum_values
  • AND 允许范围枚举值 MUST 以中文标签展示,包括仅微信支付、仅支付宝支付与同时支持微信与支付宝

Scenario: 不硬编码配置 Key

  • WHEN 前端实现允许范围配置项的展示与编辑
  • THEN 前端 MUST NOT 硬编码该配置项的 config_key
  • AND 前端 MUST 依据 config_keymodulevalue_typecontrolenum_values 等元数据驱动渲染
  • AND 该配置项归属 c2b.payment 模块,前端 MUST NOT 扩展模块枚举取值

Scenario: 代理自充设置菜单带入模块筛选

  • GIVEN 当前登录账号为超级管理员
  • WHEN 用户点击「代理自充设置」菜单
  • THEN 前端 MUST 跳转到系统配置页面并携带 module=c2b.payment
  • AND 系统配置页面 MUST 使用该 query 初始化模块筛选并据此查询配置列表
  • AND 非超级管理员 MUST NOT 看到该菜单

Scenario: 允许范围对代理与平台不可见

  • WHEN 当前登录账号不是超级管理员
  • THEN 前端 MUST NOT 向代理与平台账号展示允许范围配置的入口或当前值
  • AND 代理与平台账号 MUST 只能通过 GET /api/admin/agent-self-recharge-payment-methods 获取实际可用方式