测试规划说明书
1. 文档信息
| 项目 |
内容 |
| 项目名称 |
订单全流程管理系统 |
| 文档版本 |
v1.0 |
| 编写日期 |
2026-05-28 |
| 文档目的 |
基于《确定版需求说明书》与《确定版功能任务完成清单》《未完成功能清单》，对系统全部功能模块进行测试规划，明确测试范围、优先级、用例覆盖与验收标准 |
| 参考文档 |
《确定版需求说明书.md》《确定版功能任务完成清单.md》《未完成功能清单.md》《开发细节/04-测试用例清单.md》 |
2. 测试目标
2.1 核心测试目标
基于《未完成功能清单》识别的 6 大本质缺口，本次测试的核心目标为：
| 编号 |
测试目标 |
对应缺口 |
验证方式 |
| T-1 |
验证订单从创建→审批→下发→履约→结算的完整数据闭环 |
数据闭环未闭合 |
端到端流程用例 |
| T-2 |
验证订单、任务、提醒、审批的状态机严格按规则流转 |
状态机未完全收敛 |
状态流转矩阵用例 |
| T-3 |
验证不同角色的字段级、按钮级、行级权限隔离 |
权限隔离未完全落地 |
多角色对比用例 |
| T-4 |
验证提醒、欠款、报表等规则由配置项驱动 |
配置驱动未完全实现 |
配置变更联动用例 |
| T-5 |
验证快递100、AI OCR、OSS、微信通知等外部能力的真实对接 |
外部能力未完全接通 |
集成/模拟用例 |
| T-6 |
验证四端前端页面的字段展示、按钮时机、空态/错误态符合需求 |
体验层未完全收口 |
UI 回归用例 |
2.2 测试完成度基线
基于《确定版功能任务完成清单》，当前系统整体完成度约 93%，以下为各模块完成度与测试重点：
| 模块 |
完成度 |
测试重点 |
| 订单中心 / 订单详情 / 订单轨迹 |
100% |
回归验证 |
| 审批中心 / 审批详情 |
100% |
回归验证 |
| 客户中心 |
100% |
回归验证 |
| 提醒中心 |
100% |
回归验证 |
| 权限中心 |
100% |
回归验证 |
| 报表统计 / 报表核对 |
100% |
回归验证 |
| 员工中心 |
100% |
回归验证 |
| 系统管理页 |
100% |
回归验证 |
| 订单业务流页面 |
96% |
重点测试：后端闭环 |
| AI 识别中心 |
97% |
重点测试：人工确认留痕 |
| 产品页面 |
95% |
重点测试：禁用产品下单校验 |
| 供应商 / 工厂页面 |
95% |
重点测试：模板差异化 |
| 业务员端主框架 |
100% |
回归验证 |
| 配置中心 |
92% |
重点测试：配置即时生效 |
| 司机端主框架 |
92% |
重点测试：状态联动与字段脱敏 |
| 审计看板 |
90% |
重点测试：操作覆盖面 |
| 管理层端主框架 |
95% |
重点测试：审批闭环 |
| 权限与可见性规则 |
92% |
重点测试：字段级隔离 |
| 秘书端 |
55% |
高风险：需全面测试 |
| 履约状态流转 |
45% |
高风险：需全面测试 |
| 取消流程（已通过/履约中） |
35% |
高风险：需全面测试 |
3. 测试范围
3.1 覆盖的端与前端模块
| 端 |
前端目录 |
测试范围 |
| WEB 管理后台 |
frontend/web-admin |
登录、系统管理、客户/产品/工厂维护、报表、配置、审计、权限、审批 |
| WEB 业务员端 |
frontend/web-sales |
登录、订单录入/列表/详情、提交审核、取消、提醒、客户识别 |
| 小程序管理层端 |
frontend/mini-manager |
登录、审批列表/详情、取消审批、下发文本、司机任务创建、经营看板 |
| 小程序司机端 |
frontend/mini-driver |
登录、任务列表/详情、接单、揽货、送达、图片上传、物流轨迹 |
| 后端 API |
backend/ |
全量接口测试 |
3.2 不在测试范围内
- 部署与运维（CI/CD、容器编排）
- 性能压测（本期以功能测试为主）
- 第三方服务的真实生产环境对接（使用沙箱/模拟环境）
4. 测试策略
4.1 测试层次
| 层次 |
说明 |
占比 |
| 接口测试 |
后端 API 的参数校验、状态流转、权限控制、业务规则 |
40% |
| 页面功能测试 |
四端前端页面的交互、展示、按钮状态、字段可见性 |
35% |
| 端到端流程测试 |
跨端完整业务流程串联 |
15% |
| 权限与安全测试 |
角色越权、字段脱敏、数据隔离 |
10% |
4.2 测试优先级定义
| 优先级 |
定义 |
执行策略 |
| P0 |
阻断性功能，不通过则无法上线 |
必须全部通过，失败则阻塞发布 |
| P1 |
核心功能，影响主要业务流程 |
应全部通过，个别失败需评估影响 |
| P2 |
体验增强功能，不影响主流程 |
可接受已知缺陷，下版本修复 |
5. 测试环境与数据
5.1 测试账号
| 角色 |
账号 |
权限范围 |
所属端 |
| 管理员 |
admin01 |
全量后台管理 |
web-admin |
| 管理层 |
manager01 |
审批、利润、报表、任务分配 |
mini-manager |
| 业务员 A |
sales01 |
本人订单、客户、提醒 |
web-sales |
| 业务员 B |
sales02 |
本人订单、客户、提醒 |
web-sales |
| 司机 A |
driver01 |
本人司机任务 |
mini-driver |
| 司机 B |
driver02 |
本人司机任务 |
mini-driver |
| 秘书 |
secretary01 |
AI 识别、录入辅助 |
web-admin |
5.2 测试数据要求
| 数据类型 |
最低要求 |
说明 |
| 客户 |
至少 3 个 |
含不同业务员归属、月结客户、已欠款客户 |
| 产品 |
至少 4 个 |
含 2 个分类（工业品/日用品）、含已禁用产品 |
| 工厂/供应商 |
至少 2 个 |
含不同模板类型 |
| 订单 |
覆盖全状态 |
草稿、待审核、已通过、已退回、取消申请中、履约中、已送达、已结算、已取消 |
| 司机任务 |
覆盖全状态 |
待接单、已接单、已揽货、已送达 |
| 系统配置 |
预置完整 |
物流超时天数、沉默客户周期、欠款起算口径、金额阈值 |
5.3 测试环境
| 项目 |
要求 |
| 后端服务 |
独立测试环境，与开发环境隔离 |
| 数据库 |
独立测试库，含预置基础数据 |
| OSS/文件服务 |
模拟或沙箱环境 |
| AI OCR 服务 |
模拟返回或沙箱环境 |
| 快递100 |
模拟返回或沙箱环境 |
| 微信订阅消息 |
模拟发送，验证消息记录写入 |
6. 按模块测试规划
6.1 登录鉴权与权限体系
完成度：86% | 优先级：P0
未完成/风险项
- 角色登录态与菜单/按钮权限的完整联动不足
- 权限码在授权后即时生效链路不完整
- 管理员/管理层/业务员/司机的角色能力边界尚未完全收敛
测试用例
| 编号 |
用例名称 |
前置条件 |
步骤 |
预期结果 |
优先级 |
| AUTH-001 |
正常登录 |
用户启用 |
输入正确账号/密码/角色登录 |
返回 token、用户信息、菜单、权限 |
P0 |
| AUTH-002 |
密码错误 |
用户存在 |
输入错误密码 |
返回错误码 40002 |
P0 |
| AUTH-003 |
角色不匹配 |
业务员账号 |
使用 manager 角色登录 |
返回错误码 40003 |
P0 |
| AUTH-004 |
停用用户登录 |
用户停用 |
登录 |
返回错误码 40003 |
P0 |
| AUTH-005 |
无 token 访问 |
无 |
请求受保护接口 |
返回错误码 40002 |
P0 |
| AUTH-006 |
过期 token 访问 |
token 过期 |
请求受保护接口 |
返回错误码 40002 |
P0 |
| AUTH-007 |
业务员越权看他人订单 |
sales01/sales02 均有订单 |
sales01 请求 sales02 订单详情 |
返回 40003 或 40004 |
P0 |
| AUTH-008 |
司机越权看他人任务 |
driver01/driver02 均有任务 |
driver01 请求 driver02 任务详情 |
返回 40003 或 40004 |
P0 |
| AUTH-009 |
司机看财务字段 |
司机任务存在 |
查看任务详情 |
不返回客户敏感信息、报价、成本、利润、回扣 |
P0 |
| AUTH-010 |
登录返回菜单树 |
任意角色 |
正常登录 |
返回的 menus 包含该角色可见的完整菜单树 |
P1 |
| AUTH-011 |
登录返回权限码 |
任意角色 |
正常登录 |
返回的 permissions 包含按钮级权限码 |
P1 |
| AUTH-012 |
角色授权后即时生效 |
管理员修改角色菜单 |
用户重新登录 |
菜单和按钮权限更新为最新配置 |
P1 |
6.2 系统用户、角色、菜单管理
完成度：95% | 优先级：P0
未完成/风险项
- 用户管理分页由前端切片实现，接口层未形成完整分页查询
- 删除、停用/启用切换操作未形成完整闭环
- 角色停用/启用流程与异常约束不够完整
- 菜单管理的
icon、sort_no、status、多级菜单能力偏基础
测试用例
| 编号 |
用例名称 |
前置条件 |
步骤 |
预期结果 |
优先级 |
| SYS-001 |
新增用户成功 |
管理员登录，角色已存在 |
新增账号/姓名/手机号/角色/初始密码 |
返回用户 ID，用户可登录 |
P0 |
| SYS-002 |
用户账号重复 |
已有 username |
新增同 username 用户 |
返回 40006 |
P0 |
| SYS-003 |
用户角色不存在 |
role_id 不存在或停用 |
新增或更新用户 |
返回 40004 |
P0 |
| SYS-004 |
停用用户 |
用户启用 |
管理员停用后该用户登录 |
停用成功，登录返回 40003 |
P0 |
| SYS-005 |
重置密码 |
用户存在 |
管理员重置，用户用新密码登录 |
新密码可登录，旧密码不可 |
P0 |
| SYS-006 |
新增角色成功 |
管理员登录 |
新增 role_name/role_code/状态 |
返回角色 ID，列表可查 |
P0 |
| SYS-007 |
角色编码重复 |
已有 role_code |
新增同编码角色 |
返回 40006 |
P0 |
| SYS-008 |
停用有启用用户的角色 |
角色下有启用用户 |
停用角色 |
返回 40007 或要求先处理用户 |
P1 |
| SYS-009 |
新增菜单成功 |
管理员登录 |
新增菜单名称/路径/权限编码 |
菜单树可查询到新菜单 |
P1 |
| SYS-010 |
菜单权限编码重复 |
已有 permission_code |
新增同编码菜单 |
返回 40006 |
P1 |
| SYS-011 |
菜单父级非法 |
将父级设为自身或子级 |
更新菜单 |
返回 40007 |
P1 |
| SYS-012 |
角色授权保存 |
角色/菜单存在 |
给角色配置 menu_ids 和 permission_codes |
保存成功，重新登录后权限生效 |
P0 |
| SYS-013 |
非管理员访问系统管理接口 |
业务员或司机登录 |
请求用户/角色/菜单管理接口 |
返回 40003 |
P0 |
| SYS-014 |
权限变更审计 |
修改角色授权 |
查询审计日志 |
有授权前后差异记录 |
P1 |
| SYS-015 |
用户列表分页 |
多用户数据 |
翻页查询 |
分页正确，数据不重复 |
P1 |
| SYS-016 |
用户列表筛选 |
多用户数据 |
按姓名/角色/状态筛选 |
返回符合条件数据 |
P1 |
6.3 客户管理
完成度：100%（页面）/ 60-65%（导入/去重） | 优先级：P0
未完成/风险项
- 客户导入能力未见完整代码闭环（模板、去重、失败行返回）
- 客户去重规则未完全按"姓名+手机号"强约束落地
- 月结信息、欠款信息的维护和展示不完整
测试用例
| 编号 |
用例名称 |
前置条件 |
步骤 |
预期结果 |
优先级 |
| CUS-001 |
新增客户成功 |
无重复客户 |
提交姓名/手机号等信息 |
返回客户 ID，数据库写入 |
P0 |
| CUS-002 |
姓名手机号重复 |
已有同姓名同手机号 |
再次新增 |
返回 40006 |
P0 |
| CUS-003 |
手机号为空 |
无 |
新增客户不填手机号 |
返回 40001 |
P0 |
| CUS-004 |
客户列表筛选 |
多客户数据 |
按姓名/手机号/业务员筛选 |
返回符合条件数据 |
P1 |
| CUS-005 |
客户详情 |
客户存在 |
请求详情 |
返回结算方式、账期、欠款、归属业务员 |
P1 |
| CUS-006 |
客户导入成功 |
有导入文件 |
调用导入接口 |
返回总数、成功数、失败数 |
P1 |
| CUS-007 |
客户导入去重 |
文件含重复姓名手机号 |
导入 |
重复记录计入 duplicate_count |
P1 |
| CUS-008 |
业务员客户范围 |
sales01 有客户 |
sales02 查询客户列表 |
不返回 sales01 私有客户 |
P0 |
| CUS-009 |
月结客户标识 |
客户存在 |
设置结算方式为月结 |
客户详情显示月结信息 |
P2 |
| CUS-010 |
客户欠款展示 |
客户有欠款记录 |
查看客户详情 |
显示欠款金额与明细 |
P1 |
6.4 产品与产品分类管理
完成度：95% | 优先级：P1
未完成/风险项
- 产品分类独立管理整体功能不完整
- 产品状态对订单下单的约束不足（禁用产品仍可下单）
- 产品快照机制未完全前置到所有场景
测试用例
| 编号 |
用例名称 |
前置条件 |
步骤 |
预期结果 |
优先级 |
| PROD-001 |
新增产品分类 |
管理员登录 |
新增分类 |
分类可在列表查询 |
P1 |
| PROD-002 |
分类编码重复 |
已有分类编码 |
新增同编码分类 |
返回 40006 |
P1 |
| PROD-003 |
停用分类 |
分类存在 |
停用分类 |
新建产品不可选择或提示禁用 |
P1 |
| PROD-004 |
新增产品成功 |
分类启用 |
新增产品 |
产品写入并关联分类 |
P1 |
| PROD-005 |
产品列表筛选 |
多产品 |
按名称/规格/分类/状态筛选 |
返回符合条件数据 |
P1 |
| PROD-006 |
产品详情 |
产品存在 |
请求详情 |
返回分类、成本、售价、状态 |
P1 |
| PROD-007 |
禁用产品下单 |
产品禁用 |
订单选择该产品提交 |
拦截或明确提示 |
P0 |
| PROD-008 |
产品快照 |
产品已用于订单 |
修改产品名称/成本 |
历史订单快照不变 |
P0 |
6.5 工厂/供应商管理与下发文本
完成度：95%（页面）/ 30%（模板差异化） | 优先级：P1
未完成/风险项
- 下发文本的"生成+确认+留痕"链路未完全闭环
- 工厂模板类型的业务差异未完全实现
- 下发文本历史记录表的实际持久化链路不完整
测试用例
| 编号 |
用例名称 |
前置条件 |
步骤 |
预期结果 |
优先级 |
| FAC-001 |
新增供应商成功 |
管理员登录 |
提交供应商信息 |
返回供应商 ID |
P1 |
| FAC-002 |
供应商列表筛选 |
多供应商 |
按名称/类型筛选 |
返回符合条件数据 |
P1 |
| FAC-003 |
生成下发文本 |
订单 approved |
生成下发文本 |
返回文本内容 |
P0 |
| FAC-004 |
确认下发工厂 |
订单 approved |
确认下发 |
状态变为 pending_factory，写审计日志 |
P0 |
| FAC-005 |
非 approved 确认下发 |
订单 draft |
确认下发 |
返回 40005 |
P0 |
| FAC-006 |
下发文本日志 |
已确认下发 |
查询下发历史 |
有下发记录，含时间、操作人 |
P1 |
| FAC-007 |
不同工厂模板差异化 |
配置不同模板 |
为不同工厂生成文本 |
文本格式按模板差异展示 |
P2 |
6.6 订单录入、提交、审批
完成度：88-96% | 优先级：P0
未完成/风险项
- 订单创建接口与需求字段存在缺口（派生字段、校验细节）
- 订单编辑/草稿保存的完整能力未完全实现
- 订单提交审核的完整校验不充分
- 审批页利润计算过程展示未完全落地
- 审批退回后业务员通知未完整落地
- 订单状态机仍不够严密
测试用例
| 编号 |
用例名称 |
前置条件 |
步骤 |
预期结果 |
优先级 |
| ORD-001 |
创建草稿订单 |
业务员登录、产品存在 |
填写客户/明细/费用提交 |
返回订单 ID，状态 draft |
P0 |
| ORD-002 |
新客户自动入库 |
客户库无该客户 |
创建订单 |
自动创建客户记录 |
P0 |
| ORD-003 |
利润计算 |
售100/成本60/回扣5/运费10/税费3/其他2 |
创建订单 |
利润=20，利润率=20% |
P0 |
| ORD-004 |
固定提成保存 |
输入固定提成 50 |
创建订单 |
commission_amount=50 |
P1 |
| ORD-005 |
明细为空 |
无明细 |
创建订单 |
返回 40001 |
P0 |
| ORD-006 |
数量非法 |
数量为 0 |
创建订单 |
返回 40001 |
P0 |
| ORD-007 |
提交审核成功 |
订单 draft |
提交审核 |
状态变为 pending_approve |
P0 |
| ORD-008 |
重复提交 |
订单已 pending_approve |
再次提交 |
返回 40005 |
P0 |
| ORD-009 |
管理层审批通过 |
订单 pending_approve |
管理层通过 |
状态变为 approved |
P0 |
| ORD-010 |
管理层审批退回 |
订单 pending_approve |
管理层退回并填意见 |
状态变为 rejected，业务员收到通知 |
P0 |
| ORD-011 |
生成下发文本 |
订单 approved |
生成下发文本 |
返回文本内容 |
P0 |
| ORD-012 |
确认下发工厂 |
订单 approved |
确认下发 |
状态变为 pending_factory |
P0 |
| ORD-013 |
非 approved 确认下发 |
订单 draft |
确认下发 |
返回 40005 |
P0 |
| ORD-014 |
订单列表筛选 |
多订单 |
按状态/客户/时间筛选 |
返回符合条件数据 |
P1 |
| ORD-015 |
订单详情字段权限-业务员 |
业务员登录 |
查看本人订单详情 |
不返回成本、利润等无权限字段 |
P0 |
| ORD-016 |
管理层订单详情 |
管理层登录 |
查看订单详情 |
返回完整财务字段 |
P0 |
| ORD-017 |
编辑草稿订单 |
订单 draft |
修改客户/明细/费用 |
保存成功，数据更新 |
P0 |
| ORD-018 |
保存并提交 |
订单 draft |
保存并提交审核 |
数据保存且状态变为 pending_approve |
P1 |
| ORD-019 |
利润计算过程展示 |
管理层审批 |
查看审批详情 |
展示完整的利润计算过程（售价-成本-回扣-运费-税费-其他） |
P1 |
| ORD-020 |
审批退回通知 |
订单被退回 |
业务员查看提醒中心 |
收到退回通知，含退回原因 |
P1 |
| ORD-021 |
禁用产品创建订单 |
产品已禁用 |
选择禁用产品创建订单 |
系统拦截或明确提示 |
P0 |
| ORD-022 |
订单状态流转完整性 |
订单从创建到完成 |
依次执行：草稿→审核→通过→下发→接单→揽货→送达→完成 |
每步状态正确流转，相关通知/审计/联动正确触发 |
P0 |
6.7 订单取消流程
完成度：35-80% | 优先级：P0（高风险区域）
未完成/风险项
- 草稿/待审核订单直接取消逻辑（完成度仅 55%）
- 已通过/履约中订单的特殊审批逻辑（完成度仅 35%）
- 取消原因/意见/前状态的审计留痕不完整
- 取消审批后的状态恢复链路不完整
测试用例
| 编号 |
用例名称 |
前置条件 |
步骤 |
预期结果 |
优先级 |
| CAN-001 |
草稿订单取消 |
订单 draft |
业务员提交取消 |
状态直接变为 canceled |
P0 |
| CAN-002 |
待审核订单取消 |
订单 pending_approve |
业务员提交取消 |
状态直接变为 canceled |
P0 |
| CAN-003 |
已审批订单取消申请 |
订单 approved |
业务员提交取消 |
状态 cancel_pending，记录取消前状态 |
P0 |
| CAN-004 |
履约中订单取消申请 |
订单 picked_up |
业务员提交取消 |
状态 cancel_fulfillment_pending |
P0 |
| CAN-005 |
取消审批通过 |
订单 cancel_pending |
管理层同意 |
状态 canceled |
P0 |
| CAN-006 |
取消审批拒绝 |
订单 cancel_pending 且原状态 approved |
管理层拒绝 |
状态恢复 approved |
P0 |
| CAN-007 |
已取消再次取消 |
订单 canceled |
提交取消 |
返回 40005 |
P0 |
| CAN-008 |
取消原因必填 |
可取消订单 |
不填原因提交 |
返回 40001 |
P0 |
| CAN-009 |
履约中取消审批通过 |
订单 cancel_fulfillment_pending |
管理层同意 |
状态 canceled，司机任务同步取消 |
P0 |
| CAN-010 |
履约中取消审批拒绝 |
订单 cancel_fulfillment_pending |
管理层拒绝 |
状态恢复为取消前状态（如 picked_up） |
P0 |
| CAN-011 |
取消留痕完整性 |
执行取消操作 |
查询审计日志 |
记录取消前状态、取消原因、操作人、操作时间 |
P0 |
| CAN-012 |
取消后通知 |
订单被取消 |
相关人员查看提醒 |
收到取消通知 |
P1 |
6.8 司机任务管理与履约
完成度：45-88% | 优先级：P0（高风险区域）
未完成/风险项
- 司机任务的创建、分配与订单状态联动不完整（履约状态流转完成度仅 45%）
- 司机接单、揽货、送达的业务约束不完整
- "提交前可撤回、提交后不可撤回"与图片必填约束未闭环
- COS/OSS 图片存储与附件管理未完全统一
测试用例
| 编号 |
用例名称 |
前置条件 |
步骤 |
预期结果 |
优先级 |
| TASK-001 |
管理层创建任务 |
订单可履约、司机存在 |
填写任务并保存 |
返回任务 ID，状态 pending |
P0 |
| TASK-002 |
司机任务列表 |
driver01 有任务 |
driver01 查看列表 |
只显示本人任务 |
P0 |
| TASK-003 |
任务详情脱敏 |
任务存在 |
司机查看详情 |
不显示客户敏感信息和财务字段 |
P0 |
| TASK-004 |
接单成功 |
任务 pending |
司机接单 |
状态 accepted，记录接单时间 |
P0 |
| TASK-005 |
重复接单 |
任务已 accepted |
再次接单 |
返回 40005 |
P0 |
| TASK-006 |
揽货成功 |
任务 accepted |
上传照片确认揽货 |
状态 picked_up，附件写入 |
P0 |
| TASK-007 |
揽货无照片 |
任务 accepted |
不上传照片确认 |
返回 40001 或业务错误 |
P0 |
| TASK-008 |
送达成功 |
任务 picked_up |
确认送达 |
状态 delivered，订单状态联动更新 |
P0 |
| TASK-009 |
非法状态流转 |
任务 pending |
直接送达 |
返回 40005 |
P0 |
| TASK-010 |
司机越权操作 |
driver01 操作 driver02 任务 |
接单/揽货/送达 |
返回 40003 |
P0 |
| TASK-011 |
揽货撤回 |
任务 accepted 已提交揽货 |
撤回揽货 |
提交前可撤回，提交后不可撤回 |
P1 |
| TASK-012 |
任务与订单状态联动 |
订单 approved → 创建任务 |
任务从创建到送达 |
每步任务状态变化同步更新订单状态 |
P0 |
| TASK-013 |
图片上传成功 |
OSS 可用 |
上传揽货图片 |
附件记录写入，关联任务 ID |
P0 |
| TASK-014 |
图片上传失败 |
OSS 异常 |
上传揽货图片 |
返回明确错误，不更新任务状态 |
P1 |
6.9 物流与 AI 辅助识别
完成度：88-97% | 优先级：P1
未完成/风险项
- 物流轨迹对接快递100的完整实现未落地
- 物流超时提醒的"一次性提醒"策略未完全实现
- AI 图片识别链路不完整（人工确认界面、相似订单判断）
- 识别失败/置信度过低的人工兜底流程未闭环
测试用例
| 编号 |
用例名称 |
前置条件 |
步骤 |
预期结果 |
优先级 |
| LOG-001 |
手动新增物流节点 |
订单存在 |
新增节点 |
logistics_trace 写入 |
P1 |
| LOG-002 |
物流轨迹查询 |
订单有节点 |
查询轨迹 |
按时间返回节点 |
P1 |
| LOG-003 |
物流超时提醒 |
首节点后 48 小时无流转 |
执行提醒检查 |
生成一次提醒 |
P0 |
| LOG-004 |
物流超时不重复提醒 |
已提醒 |
再次执行检查 |
不重复生成 |
P0 |
| LOG-005 |
快递100对接 |
配置快递100凭证 |
查询物流轨迹 |
返回快递100节点数据 |
P1 |
| AI-001 |
OCR 识别成功 |
图片存在，凭证有效 |
发起识别 |
保存 raw_result、confidence、suggested_result |
P1 |
| AI-002 |
OCR 识别失败 |
模拟服务异常 |
发起识别 |
返回 40009，记录异常 |
P1 |
| AI-003 |
人工修正 |
识别记录存在 |
提交 corrected_result |
保存修正结果，不覆盖原始结果 |
P1 |
| AI-004 |
识别结果人工确认 |
识别出疑似订单 |
页面确认 |
不自动审批、不自动合并 |
P1 |
| AI-005 |
置信度过低处理 |
confidence 低于阈值 |
查看识别结果 |
标记为需人工确认，不可直接入库 |
P1 |
6.10 提醒中心、欠款提醒、长时间未下单提醒
完成度：88-100% | 优先级：P0
未完成/风险项
- 欠款提醒的起算规则未完全落地（按订单日期/对账日期/发货日期配置）
- 欠款提醒"提醒对象为业务员"的规则未完全验证
- 长时间未下单提醒的金额阈值和沉默周期配置未形成业务闭环
测试用例
| 编号 |
用例名称 |
前置条件 |
步骤 |
预期结果 |
优先级 |
| ARR-001 |
delivered 模式生成欠款 |
配置 arrears_generate_mode=delivered |
订单送达 |
生成欠款记录 |
P0 |
| ARR-002 |
shipped 模式生成欠款 |
配置 arrears_generate_mode=shipped |
订单发货 |
生成欠款记录 |
P0 |
| ARR-003 |
未到节点不生成欠款 |
配置 delivered，订单 shipped |
检查欠款 |
不生成 |
P0 |
| ARR-004 |
结算关闭欠款 |
欠款 pending/overdue |
执行结算 |
状态 closed 或 paid，记录关闭时间 |
P0 |
| ARR-005 |
欠款超期提醒 |
欠款超过账期 |
执行提醒检查 |
生成业务员提醒 |
P0 |
| ARR-006 |
沉默客户提醒 |
客户超过周期未下单且金额达阈值 |
执行检查 |
生成提醒 |
P1 |
| ARR-007 |
沉默客户低金额不提醒 |
金额低于阈值 |
执行检查 |
不生成提醒 |
P1 |
| ARR-008 |
提醒已读 |
提醒存在 |
标记已读 |
状态 read |
P1 |
| ARR-009 |
欠款起算口径切换 |
配置起算口径为"对账日期" |
生成欠款 |
起算日期按对账日期计算 |
P1 |
| ARR-010 |
提醒对象为业务员 |
客户归属业务员 A |
生成欠款提醒 |
提醒发送给业务员 A 而非泛化通知 |
P0 |
| ARR-011 |
微信订阅消息通知 |
提醒生成 |
检查通知记录 |
写入微信订阅消息记录 |
P1 |
6.11 业绩统计报表
完成度：95-100% | 优先级：P1
未完成/风险项
- 报表口径统一仍有差异（按月/季/年、分类拆分、电商剔除）
- 报表导出能力可能仍是简化版本
- 报表图表与明细维度未完全实现
测试用例
| 编号 |
用例名称 |
前置条件 |
步骤 |
预期结果 |
优先级 |
| REP-001 |
月度统计 |
多订单跨月份 |
查询月报 |
按月份汇总正确 |
P1 |
| REP-002 |
季度统计 |
多订单跨季度 |
查询季报 |
按季度汇总正确 |
P1 |
| REP-003 |
年度统计 |
多订单跨年份 |
查询年报 |
按年份汇总正确 |
P1 |
| REP-004 |
分类统计 |
产品分类存在 |
查询报表 |
按分类金额汇总正确 |
P1 |
| REP-005 |
固定提成统计 |
订单有 commission_amount |
查询报表 |
提成金额按订单固定值汇总 |
P1 |
| REP-006 |
电商订单剔除 |
存在电商来源订单 |
查询报表 |
按规则剔除或可配置剔除 |
P1 |
| REP-007 |
报表导出 |
查询条件存在 |
点击导出 |
返回 file_url，文件内容与页面一致 |
P1 |
| REP-008 |
报表金额与数据库核对 |
已知订单数据 |
查询报表后人工核对 |
报表金额与数据库手工核对一致 |
P0 |
6.12 配置管理
完成度：92-95% | 优先级：P1
未完成/风险项
- 系统配置项仅覆盖基础字段，未形成统一配置中心体验
- 敏感配置的安全存储未完全体现
测试用例
| 编号 |
用例名称 |
前置条件 |
步骤 |
预期结果 |
优先级 |
| CFG-001 |
查询配置 |
配置存在 |
查询 config_key |
返回配置值 |
P1 |
| CFG-002 |
更新配置 |
管理员登录 |
更新欠款生成模式 |
保存成功，写审计日志 |
P1 |
| CFG-003 |
非管理员更新配置 |
业务员登录 |
更新配置 |
返回 40003 |
P0 |
| CFG-004 |
物流超时天数配置 |
管理员 |
修改超时天数 |
提醒检查按新天数执行 |
P1 |
| CFG-005 |
沉默客户周期配置 |
管理员 |
修改沉默周期 |
提醒检查按新周期执行 |
P1 |
| CFG-006 |
金额阈值配置 |
管理员 |
修改金额阈值 |
低于阈值的客户不触发提醒 |
P1 |
| CFG-007 |
配置即时生效 |
修改配置 |
不重启服务 |
新配置立即生效 |
P1 |
6.13 审计日志
完成度：88-90% | 优先级：P1
未完成/风险项
- 审计日志写入覆盖面不够全面（物流任务、提醒、导入、导出、AI 修正等未完全覆盖）
- 审计日志查询和前后值展示未完整落地
测试用例
| 编号 |
用例名称 |
前置条件 |
步骤 |
预期结果 |
优先级 |
| AUD-001 |
订单创建审计 |
创建订单 |
查询审计日志 |
有 create order 记录 |
P0 |
| AUD-002 |
审批审计 |
审批订单 |
查询审计日志 |
有 approve 记录 |
P0 |
| AUD-003 |
取消审计 |
取消订单 |
查询审计日志 |
有 cancel 记录，含取消原因 |
P0 |
| AUD-004 |
司机操作审计 |
接单/揽货/送达 |
查询审计日志 |
有对应记录 |
P0 |
| AUD-005 |
OSS 上传审计 |
上传附件 |
查询审计日志 |
有上传记录或文件记录 |
P1 |
| AUD-006 |
配置变更审计 |
修改系统配置 |
查询审计日志 |
有配置变更前后值记录 |
P1 |
| AUD-007 |
审计日志前后值对比 |
修改订单 |
查看审计详情 |
展示修改前后的值差异 |
P2 |
| AUD-008 |
审计日志筛选 |
多条日志 |
按操作类型/时间/操作人筛选 |
返回符合条件数据 |
P1 |
6.14 文件与 OSS
完成度：90% | 优先级：P1
测试用例
| 编号 |
用例名称 |
前置条件 |
步骤 |
预期结果 |
优先级 |
| FILE-001 |
获取上传凭证 |
用户登录 |
请求上传凭证 |
返回 upload_url、file_url、expire_at |
P1 |
| FILE-002 |
图片上传成功 |
OSS 可用 |
上传图片并保存附件 |
file_attachment 写入 image 元数据 |
P1 |
| FILE-003 |
视频上传成功 |
OSS 可用 |
上传视频并保存附件 |
file_attachment 写入 video 元数据 |
P2 |
| FILE-004 |
文件过大 |
设置上传限制 |
上传超限文件 |
返回 40008 或明确错误 |
P1 |
| FILE-005 |
OSS 失败 |
模拟 OSS 异常 |
上传 |
返回 40008，记录日志 |
P1 |
| FILE-006 |
附件关联 |
任务存在 |
上传任务附件 |
附件 biz_type/biz_id 正确 |
P1 |
7. 端到端流程测试
端到端测试覆盖完整的跨端业务流程，验证数据在多端之间的正确流转。
| 编号 |
流程名称 |
涉及端 |
测试步骤 |
预期结果 |
优先级 |
| E2E-001 |
业务员完整录单 |
web-sales |
登录→创建订单（含新客户）→提交审核 |
订单进入 pending_approve，新客户自动入库 |
P0 |
| E2E-002 |
管理层审批通过 |
mini-manager |
登录→查看待审批→查看利润→通过 |
订单进入 approved，审计记录生成 |
P0 |
| E2E-003 |
确认下发工厂 |
mini-manager |
生成文本→复制→确认下发 |
订单进入 pending_factory，下发日志生成 |
P0 |
| E2E-004 |
创建司机任务 |
web-admin / mini-manager |
创建并分配任务 |
任务生成，司机端可见 |
P0 |
| E2E-005 |
司机履约完成 |
mini-driver |
接单→上传照片揽货→确认送达 |
任务 delivered，订单状态联动更新 |
P0 |
| E2E-006 |
欠款生成 |
后端/页面 |
送达后检查欠款 |
根据配置模式生成欠款记录 |
P0 |
| E2E-007 |
报表查看导出 |
web-admin |
查询报表→核对→导出 |
页面和文件数据一致 |
P1 |
| E2E-008 |
订单取消全流程（草稿） |
web-sales |
创建草稿→取消 |
直接取消成功 |
P0 |
| E2E-009 |
订单取消全流程（已通过） |
web-sales + mini-manager |
提交取消申请→管理层审批→确认取消 |
状态经过 cancel_pending → canceled |
P0 |
| E2E-010 |
订单取消全流程（履约中） |
web-sales + mini-manager + mini-driver |
提交取消申请→管理层审批→确认取消 |
状态经过 cancel_fulfillment_pending → canceled，司机任务同步取消 |
P0 |
| E2E-011 |
审批退回重新提交 |
mini-manager + web-sales |
管理层退回→业务员修改→重新提交 |
退回通知到达，订单重新进入审核 |
P0 |
| E2E-012 |
提醒中心完整流程 |
web-sales / web-admin |
配置提醒规则→触发提醒→查看→标记已读 |
提醒生成、推送、展示、已读全链路通过 |
P1 |
8. 权限与安全测试
8.1 角色权限矩阵验证
优先级：P0
| 编号 |
测试场景 |
操作角色 |
操作内容 |
预期结果 |
| PERM-001 |
业务员查看他人订单 |
sales01 |
查看 sales02 的订单详情 |
拒绝（40003/40004） |
| PERM-002 |
业务员查看财务字段 |
sales01 |
查看本人订单详情 |
不返回成本、利润、回扣 |
| PERM-003 |
司机查看财务字段 |
driver01 |
查看任务详情 |
不返回客户敏感信息和财务字段 |
| PERM-004 |
司机查看他人任务 |
driver01 |
查看 driver02 的任务 |
拒绝 |
| PERM-005 |
管理层查看完整财务 |
manager01 |
查看审批详情 |
返回成本、利润、利润率、计算过程 |
| PERM-006 |
业务员访问系统管理 |
sales01 |
请求用户/角色管理接口 |
拒绝（40003） |
| PERM-007 |
司机访问系统管理 |
driver01 |
请求配置/审计接口 |
拒绝（40003） |
| PERM-008 |
管理层访问系统管理 |
manager01 |
请求用户管理接口 |
按角色权限返回（可能受限） |
| PERM-009 |
管理员全量权限 |
admin01 |
访问所有接口 |
全部允许 |
| PERM-010 |
秘书端 AI 操作 |
secretary01 |
发起 AI 识别、人工修正 |
允许 AI 相关操作，不允许订单审批 |
8.2 数据隔离验证
| 编号 |
测试场景 |
验证内容 |
预期结果 |
| ISO-001 |
业务员订单隔离 |
sales01 查询订单列表 |
仅返回本人创建的订单 |
| ISO-002 |
业务员客户隔离 |
sales01 查询客户列表 |
仅返回归属本人的客户 |
| ISO-003 |
司机任务隔离 |
driver01 查询任务列表 |
仅返回分配给本人的任务 |
| ISO-004 |
管理层查看全部订单 |
manager01 查询订单列表 |
返回所有业务员的订单 |
| ISO-005 |
管理员查看全部数据 |
admin01 查询各列表 |
返回全量数据 |
9. 状态机验证矩阵
优先级：P0
9.1 订单状态流转矩阵
| 当前状态 |
允许的目标状态 |
触发动作 |
不允许的目标状态 |
draft |
pending_approve |
业务员提交审核 |
approved, canceled(直接取消) |
draft |
canceled |
业务员直接取消 |
— |
pending_approve |
approved |
管理层审批通过 |
draft |
pending_approve |
rejected |
管理层审批退回 |
draft |
pending_approve |
canceled |
业务员直接取消 |
— |
approved |
cancel_pending |
业务员申请取消 |
draft, rejected |
approved |
pending_factory |
管理层确认下发 |
canceled(直接) |
pending_factory |
pending_driver_accept |
工厂确认接收 |
draft |
pending_driver_accept |
accepted |
司机接单 |
draft, approved |
accepted |
picked_up |
司机揽货（含照片） |
pending_driver_accept |
picked_up |
delivered |
司机确认送达 |
accepted |
picked_up |
cancel_fulfillment_pending |
业务员申请取消 |
— |
cancel_pending |
canceled |
管理层同意取消 |
— |
cancel_pending |
恢复原状态 |
管理层拒绝取消 |
— |
cancel_fulfillment_pending |
canceled |
管理层同意取消 |
— |
cancel_fulfillment_pending |
恢复原状态 |
管理层拒绝取消 |
— |
9.2 司机任务状态流转矩阵
| 当前状态 |
允许的目标状态 |
触发动作 |
pending |
accepted |
司机接单 |
accepted |
picked_up |
司机上传照片并确认揽货 |
picked_up |
delivered |
司机确认送达 |
9.3 测试方法
对每个状态流转：
- 验证合法流转成功
- 验证非法流转被拒绝（返回
40005）
- 验证状态变更后相关通知/审计/联动正确触发
- 验证并发状态变更的幂等性
10. 配置驱动规则验证
优先级：P1
| 编号 |
配置项 |
测试方法 |
预期效果 |
| CFG-R-001 |
logistics_timeout_days (物流超时天数) |
修改配置后检查提醒触发 |
按新天数判断超时 |
| CFG-R-002 |
inactive_customer_days (沉默客户天数) |
修改配置后检查提醒触发 |
按新天数判断沉默 |
| CFG-R-003 |
arrears_generate_mode (欠款生成模式) |
切换 shipped/delivered |
欠款在对应节点生成 |
| CFG-R-004 |
arrears_reminder_start_type (欠款起算口径) |
切换订单日期/对账日期/发货日期 |
欠款起算日期按配置计算 |
| CFG-R-005 |
inactive_order_amount_threshold (金额阈值) |
设置阈值后检查提醒 |
低于阈值不触发提醒 |
| CFG-R-006 |
report_category_mapping (报表分类映射) |
修改映射后查询报表 |
分类按新映射统计 |
| CFG-R-007 |
cancel_allowed_statuses (可取消状态) |
修改可取消状态列表 |
仅配置的状态可取消 |
11. 外部集成测试
优先级：P1
| 编号 |
集成点 |
测试方法 |
预期结果 |
| EXT-001 |
快递100物流查询 |
调用物流查询接口 |
返回物流节点数据，异常时降级处理 |
| EXT-002 |
AI OCR识别 |
上传图片调用识别 |
返回识别结果、置信度，异常时记录日志 |
| EXT-003 |
OSS文件上传 |
上传图片/视频 |
返回文件URL，附件记录写入 |
| EXT-004 |
OSS上传失败 |
模拟OSS异常 |
返回错误码，记录日志，不影响主流程 |
| EXT-005 |
微信订阅消息 |
触发提醒通知 |
写入消息发送记录 |
| EXT-006 |
微信 bind-openid |
绑定微信用户 |
openid 关联到系统用户 |
12. 回归测试清单
每次发布前必须执行以下回归测试：
| 类别 |
回归项 |
| 认证 |
登录、退出、token 过期、角色不匹配 |
| 系统管理 |
用户/角色/菜单 CRUD、授权刷新 |
| 订单流程 |
创建→提交→审批→下发→接单→揽货→送达 |
| 取消流程 |
草稿直接取消、待审核直接取消、已通过申请取消、履约中申请取消 |
| 司机任务 |
创建→接单→揽货→送达 |
| 权限越权 |
业务员越权 ×2、司机越权 ×2 |
| 文件上传 |
图片上传、视频上传 |
| AI 识别 |
OCR 成功、OCR 失败、人工修正 |
| 欠款 |
shipped 模式、delivered 模式 |
| 报表 |
统计核对、导出 |
| 审计 |
关键操作日志查询 |
13. 风险分析
| 风险项 |
风险等级 |
影响范围 |
应对策略 |
| 取消流程特殊审批逻辑完成度仅 35% |
高 |
订单主流程 |
优先测试，覆盖全部取消分支 |
| 履约状态流转完成度仅 45% |
高 |
司机履约全链路 |
重点测试状态联动与异常分支 |
| 秘书端完成度仅 55% |
中 |
AI 识别辅助流程 |
梳理秘书端专属流程并补齐 |
| 权限字段隔离不完整 |
高 |
数据安全 |
多角色对比测试，逐字段验证 |
| 外部服务（快递100/AI/OSS）集成不完整 |
中 |
物流/AI/文件功能 |
使用模拟环境验证降级逻辑 |
| 配置驱动规则未完全落地 |
中 |
提醒/欠款/报表 |
配置变更后逐一验证联动效果 |
| 订单状态机约束不严密 |
高 |
数据一致性 |
按状态矩阵逐项验证非法流转 |
| 报表统计口径差异 |
低 |
数据准确性 |
手工核对数据库与报表数据 |
14. 验收标准
| 类型 |
标准 |
| 阻断缺陷 |
0 个 |
| 严重缺陷 |
0 个 |
| 一般缺陷 |
已确认不影响上线或有明确修复计划 |
| P0 用例通过率 |
100% |
| P1 用例通过率 |
≥ 95% |
| 核心流程端到端用例 |
100% 通过 |
| 权限与数据安全用例 |
100% 通过 |
| 状态机合法/非法流转用例 |
100% 通过 |
| 报表金额核对 |
与数据库手工核对一致 |
| 审计日志 |
关键操作 100% 可追溯 |
15. 测试用例统计
| 模块 |
用例数 |
P0 |
P1 |
P2 |
| 登录鉴权与权限 |
12 |
8 |
4 |
0 |
| 系统用户/角色/菜单管理 |
16 |
8 |
8 |
0 |
| 客户管理 |
10 |
4 |
4 |
2 |
| 产品与分类管理 |
8 |
2 |
6 |
0 |
| 工厂/供应商与下发文本 |
7 |
3 |
3 |
1 |
| 订单录入/提交/审批 |
22 |
14 |
8 |
0 |
| 订单取消流程 |
12 |
10 |
2 |
0 |
| 司机任务与履约 |
14 |
10 |
3 |
1 |
| 物流与 AI 识别 |
10 |
2 |
8 |
0 |
| 提醒中心与欠款 |
11 |
5 |
6 |
0 |
| 业绩统计报表 |
8 |
1 |
7 |
0 |
| 配置管理 |
7 |
1 |
6 |
0 |
| 审计日志 |
8 |
3 |
4 |
1 |
| 文件与 OSS |
6 |
0 |
5 |
1 |
| 端到端流程 |
12 |
10 |
2 |
0 |
| 权限与安全 |
15 |
15 |
0 |
0 |
| 状态机验证 |
按矩阵展开 |
全量 |
— |
— |
| 配置驱动规则 |
7 |
0 |
7 |
0 |
| 外部集成 |
6 |
0 |
6 |
0 |
| 合计 |
~191 |
~96 |
~87 |
~6 |
注：状态机验证用例数取决于实际状态组合数量，按矩阵逐项展开后约 30-40 条子用例。
16. 测试执行计划
| 阶段 |
内容 |
预计周期 |
| 第一轮 |
P0 用例全量执行（订单主流程、取消流程、司机履约、权限越权、状态机） |
3 天 |
| 第二轮 |
P1 用例全量执行（客户/产品/工厂管理、报表、配置、审计、物流/AI） |
2 天 |
| 第三轮 |
P2 用例 + 端到端流程 + 配置驱动规则 + 外部集成 |
2 天 |
| 回归测试 |
按回归清单全量回归 |
1 天 |
| 验收确认 |
对照验收标准出具测试报告 |
1 天 |
17. 附录
17.1 订单状态全集
draft（草稿）
→ pending_approve（待审核）
→ approved（已通过）
→ pending_factory（待下发工厂）
→ pending_driver_accept（待司机接单）
→ accepted（已接单）
→ picked_up（已揽货）
→ delivered（已送达）
→ completed（已完成）
→ settled（已结算）
→ rejected（已退回）
→ [业务员修改后重新提交]
→ canceled（已取消）
特殊取消路径：
approved → cancel_pending → canceled / 恢复原状态
picked_up → cancel_fulfillment_pending → canceled / 恢复原状态
17.2 错误码参考
| 错误码 |
含义 |
40001 |
参数校验失败 |
40002 |
认证失败（无token/token过期） |
40003 |
权限不足 |
40004 |
资源不存在或无权访问 |
40005 |
状态不允许该操作 |
40006 |
数据重复（唯一约束冲突） |
40007 |
业务约束不满足 |
40008 |
文件上传失败 |
40009 |
AI 识别服务异常 |
17.3 利润计算公式
利润 = 销售金额 - 成本金额 - 回扣 - 运费 - 税费 - 其他费用
利润率 = 利润 ÷ 销售金额 × 100%
taiyi
e636b8da17