SOP-603：端口充值审批

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

文档元数据

文档类型：SOP / Checklist
适用场景：外采端口充值审批流程测试
配置文件：20260129_create_porter_recharge_review_template.sql
创建者：财务 / 运营 / QA
最近更新时间：2026-01-30
相关接口定义：参考 crm.swagger.json 中 FlowService 与 CashService 模块（特别是 POST /api/v1/flows、GET /api/v1/flows、POST /api/v1/cash/porter_recharge）

工作流概述

流程图

graph LR
    A[发起申请] --> B[财务审批]
    B --> C[自动生效]
    C --> D[更新端口余额]

审批角色

步骤	审批人	说明
财务审批	往来会计 / 总账会计 / 税务会计 / 财务主管 / 财务总监	端口充值由财务单步审批

前置条件

条件	检查方式
已使用有权限的用户登录	登录成功，能加载左侧导航
有可用的外采端口	端口标签页面可选择端口
用户有端口充值权限	能看到"外采端口充值"按钮
已准备充值凭证	支持上传图片（最多 3 张）

任务矩阵

任务 T1：进入端口标签页面

入口：广告账户页 → 端口 Tab

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

任务 T2：填写端口充值表单

入口：端口充值对话框

Action Steps	Input / Payload	预期结果	验证方式	证据	状态	下游任务
步骤1：选择端口	选择目标外采端口	端口字段显示已选端口	检查字段显示	截图	`[ ]`	步骤 2
步骤2：填写金额	输入 `5000`	金额输入框显示 5000	检查输入框值	截图	`[ ]`	步骤 3
步骤3：上传凭证	上传充值凭证图片	上传成功显示缩略图	检查上传区域	截图	`[ ]`	步骤 4
步骤4：填写备注	输入"端口充值测试"	备注字段显示输入内容	检查字段显示	截图	`[ ]`	步骤 5
步骤5：提交审批	点击"提交审批"	显示成功提示	弹出"提交成功"提示	截图	`[ ]`	任务 T3

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

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

Action Steps	Input / Payload	预期结果	验证方式	证据	状态	下游任务
步骤1：进入工作流列表	打开工作流列表页面	列表出现新工作流	列表含"SOP-603 端口充值"记录	截图	`[ ]`	步骤 2
步骤2：进入工作流详情	点击新工作流 ID	进入工作流详情	详情页显示端口、金额、凭证信息	截图	`[ ]`	任务 T4

任务 T4：财务审批流程

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

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

任务 T5：验证端口余额更新

入口：端口标签页面

Action Steps	Input / Payload	预期结果	验证方式	证据	状态	下游任务
步骤1：刷新端口列表	返回端口标签页	端口余额更新	核对充值前后余额变化	截图	`[ ]`	任务 T6

任务 T6：验证审批记录与日志

入口：工作流详情 / 审批记录

Action Steps	Input / Payload	预期结果	验证方式	证据	状态	下游任务
步骤1：查看审批记录	打开审核历史	显示审批人、时间、结果	审批记录完整	截图	`[ ]`	—

API 参考

接口	方法	描述
`/api/v1/cash/porter_recharge`	POST	提交端口充值申请
`/api/v1/flows`	POST	创建工作流
`/api/v1/flows`	GET	获取工作流列表
`/api/v1/flows/{id}`	GET	获取工作流详情
`/api/v1/flows/{id}/approve`	POST	审批工作流

测试数据示例

成功案例

请求参数：

{
  "porterId": 1,
  "amount": 5000,
  "proofs": ["https://example.com/proof.png"],
  "remark": "端口充值测试"
}

预期响应：

{
  "id": "flow-id-example",
  "type": "porter_recharge",
  "name": "端口充值",
  "status": "pending",
  "creator": {...},
  "approvers": [
    {
      "role": "财务",
      "status": "pending"
    }
  ],
  "createdAt": "2026-01-30T09:38:00Z"
}

失败案例

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

场景2：未选择端口 - 错误提示："请选择端口" - HTTP 状态码：400

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

异常处理

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

进度采集模板

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

任务ID	任务名称	状态
T1	进入端口标签页面	⬜
T2	填写端口充值表单	⬜
T3	查看工作流列表与详情	⬜
T4	财务审批流程	⬜
T5	验证端口余额更新	⬜
T6	验证审批记录与日志	⬜

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