SOP-601：外采帐户充值审批

标准 SOP 测试文档；每个任务（Task ID）代表一个独立的测试步骤，便于人工/自动化测试按序号完成并记录进度。

文档元数据

文档类型：SOP / Checklist
适用场景：外采帐户充值流程测试
配置文件：external_recharge_prod.yaml
创建者：运营 / QA / 自动化工程
最近更新时间：2026-01-30
相关接口定义：参考 crm.swagger.json 中 FlowService 模块（特别是 POST /api/v1/flows、GET /api/v1/flows）

工作流概述

流程图

graph LR
    A[发起申请] --> B[媒介审批]
    B --> C[生效]

审批角色

步骤	审批人	说明
媒介审批	媒介 / 媒介经理	外采充值申请由媒介审批

前置条件

条件	检查方式
已使用有权限的用户登录	登录成功，能加载左侧导航
有可用的外采帐户	广告账户页外采 Tab 可见外采账户
用户有充值权限	能看到"充值"按钮
外采端口余额充足	充值额度可被覆盖

任务矩阵

任务 T1：进入外采账户充值页面

入口：广告账户页 → 外采 Tab

Action Steps	Input / Payload	预期结果	验证方式	证据	状态	下游任务
步骤1：进入广告账户页	打开广告账户页面	页面展示广告账户页	页面加载成功且无报错	截图	`[ ]`	步骤 2
步骤2：切换到外采 Tab	点击"外采"标签	展示外采账户列表	列表显示外采账户信息	截图	`[ ]`	步骤 3
步骤3：点击"充值"按钮	选择目标外采账户，点击充值	弹出广告账户充值单对话框	对话框标题为"广告账户充值单"	截图	`[ ]`	任务 T2

任务 T2：填写外采充值表单

入口：广告账户充值单对话框

Action Steps	Input / Payload	预期结果	验证方式	证据	状态	下游任务
步骤1：确认客户和账户信息	查看客户名称和广告账户信息	显示正确的客户和账户	界面显示客户名称、广告账户名称和编号	截图	`[ ]`	步骤 2
步骤2：查看余额信息	查看各类余额（资金池、挂账、垫款等）	余额信息正确显示	检查界面显示的余额数据	截图	`[ ]`	步骤 3
步骤3：填写充值金额	在"充值金额"输入框输入 `3000`	金额输入框显示 3000	检查输入框值	截图	`[ ]`	步骤 4
步骤4：确认广告政策标签	查看广告政策标签（如外来政策5.00%）	政策标签正确显示	检查标签显示（可调整）	截图	`[ ]`	步骤 5
步骤5：上传充值证明	点击"使用充值证明截图"展开并上传凭证	上传成功显示缩略图	检查上传区域	截图	`[ ]`	步骤 6
步骤6：点击充值按钮	点击绿色"充值"按钮	显示成功提示并创建审批流程	弹出"提交成功"提示	截图	`[ ]`	任务 T3

任务 T3：查看工作流列表与详情

入口：审批中心 → 我发起的 / 工作流

Action Steps	Input / Payload	预期结果	验证方式	证据	状态	下游任务
步骤1：进入工作流列表	打开工作流列表页面	列表出现新工作流	列表含"外采帐户充值审批"记录	截图	`[ ]`	步骤 2
步骤2：进入工作流详情	点击新工作流 ID	进入工作流详情	详情页显示申请人、金额、客户、帐户信息	截图	`[ ]`	任务 T4

任务 T4：媒介审批流程

入口：审批中心 → 待我审批

Action Steps	Input / Payload	预期结果	验证方式	证据	状态	下游任务
步骤1：查找待审批记录	筛选 SOP-601	列表出现待审批记录	列表显示状态"媒介审批"	截图	`[ ]`	步骤 2
步骤2：查看审批详情	打开审批详情页	显示申请明细	详情包含金额、帐户、凭证	截图	`[ ]`	步骤 3
步骤3：执行审批	媒介人员点击"通过"	工作流状态变为"生效"	刷新后状态更新	截图	`[ ]`	任务 T5

任务 T5：验证充值结果

入口：广告账户页 → 外采 Tab

Action Steps	Input / Payload	预期结果	验证方式	证据	状态	下游任务
步骤1：查看帐户余额	返回外采账户列表查看余额	帐户余额增加	核对充值前后余额变化	截图	`[ ]`	—

API 参考

接口	方法	描述
`/api/v1/flows`	POST	创建工作流
`/api/v1/flows`	GET	获取工作流列表
`/api/v1/flows/{id}`	GET	获取工作流详情
`/api/v1/flows/{id}/approve`	POST	审批工作流

测试数据示例

成功案例

请求参数：

{
  "type": "external_recharge_prod",
  "data": {
    "amount": 3000,
    "use_external": true,
    "remark": "外采充值测试",
    "proof": ["https://example.com/proof.png"]
  }
}

预期响应：

{
  "id": "flow-id-example",
  "type": "external_recharge_prod",
  "name": "外采帐户充值审批",
  "status": "pending",
  "creator": {...},
  "approvers": [
    {
      "role": "媒介",
      "status": "pending"
    }
  ],
  "createdAt": "2026-01-27T09:38:00Z"
}

失败案例

场景1：未填写金额 - 错误提示："充值金额不能为0或空" - HTTP 状态码：400

场景2：未上传凭证 - 错误提示："请上传充值证明" - HTTP 状态码：400

场景3：非外采帐户 - 错误提示："帐户类型不支持外采充值" - HTTP 状态码：400

异常处理

异常场景	预期行为	处理方法
页面未加载	显示加载指示器或错误提示	刷新页面，检查网络连接
表单验证失败	显示红色错误提示	检查必填项（充值金额、充值证明）
工作流创建失败	显示错误提示消息	检查后端日志，验证请求参数
审批按钮不可见	当前用户无审批权限	使用媒介账号登录
余额未变化	充值未生效	检查审批状态是否为"生效"

进度采集模板

可将以下模板复制到 Excel 中，用于记录测试进度：

任务ID	任务名称	状态
T1	进入外采账户充值页面	⬜
T2	填写外采充值表单	⬜
T3	查看工作流列表与详情	⬜
T4	媒介审批流程	⬜
T5	验证充值结果	⬜

Keys	Action
`?`	Open this help
`n`	Next page
`p`	Previous page
`s`	Search