dingdanquanliucheng/开发细节/04-测试用例清单.md

测试用例清单

1. 测试说明

1.1 测试范围

范围	内容
接口测试	认证、订单、审批、客户、产品、工厂、司机任务、物流、AI、提醒、报表、配置、审计
页面测试	Vue 业务员端、Vue 管理后台、管理层小程序、司机小程序
流程测试	订单主流程、取消流程、司机履约、欠款生成、提醒、报表导出
权限测试	业务员、管理层、司机、管理员
异常测试	参数错误、状态非法、越权、第三方失败、上传失败

1.2 测试账号

角色	账号建议	权限范围
管理员	admin01	全量后台管理
管理层	manager01	审批、利润、报表、任务分配
业务员 A	sales01	本人订单、客户、提醒
业务员 B	sales02	本人订单、客户、提醒
司机 A	driver01	本人司机任务
司机 B	driver02	本人司机任务

1.3 测试数据

数据	要求
客户	至少 2 个不同业务员客户，含月结客户
产品	至少 2 个分类，含工业品、日用品或自定义分类
工厂	至少 2 个不同模板类型工厂
订单	草稿、待审核、已通过、取消申请中、履约中、已送达、已结算
司机任务	待接单、已接单、已揽货、已送达

2. 认证与权限测试

用例编号	用例名称	前置条件	步骤	预期结果
AUTH-001	正常登录	用户启用	输入正确账号、密码、角色登录	返回 token、用户信息、菜单、权限
AUTH-002	密码错误	用户存在	输入错误密码登录	返回 40002
AUTH-003	角色不匹配	业务员账号存在	使用 manager 角色登录	返回 40003
AUTH-004	停用用户登录	用户状态停用	登录	返回 40003
AUTH-005	无 token 访问	无	请求受保护接口	返回 40002
AUTH-006	过期 token 访问	token 过期	请求受保护接口	返回 40002
AUTH-007	业务员越权看他人订单	sales01、sales02 均有订单	sales01 请求 sales02 订单详情	返回 40003 或 40004
AUTH-008	司机越权看他人任务	driver01、driver02 均有任务	driver01 请求 driver02 任务详情	返回 40003 或 40004
AUTH-009	司机看财务字段	司机任务存在	查看任务详情	不返回客户敏感信息、报价、成本、利润、回扣

3. 客户管理测试

用例编号	用例名称	前置条件	步骤	预期结果
CUS-001	新增客户成功	无重复客户	提交姓名、手机号等信息	返回客户 ID，数据库写入
CUS-002	姓名手机号重复	已有同姓名同手机号	再次新增	返回 40006
CUS-003	手机号为空	无	新增客户不填手机号	返回 40001
CUS-004	客户列表筛选	多客户数据	按姓名、手机号、业务员筛选	返回符合条件数据
CUS-005	客户详情	客户存在	请求详情	返回结算方式、账期、欠款、归属业务员
CUS-006	客户导入成功	OSS 有导入文件	调用导入接口	返回总数、成功数、失败数
CUS-007	客户导入去重	文件含重复姓名手机号	导入	重复记录计入 duplicate_count
CUS-008	业务员客户范围	sales01 有客户	sales02 查询客户列表	不返回 sales01 私有客户

4. 产品与分类测试

用例编号	用例名称	前置条件	步骤	预期结果
PROD-001	新增产品分类	管理员登录	新增分类	分类可在列表查询
PROD-002	分类编码重复	已有分类编码	新增同编码分类	返回 40006
PROD-003	停用分类	分类存在	停用分类	新建产品不可选择或提示禁用
PROD-004	新增产品成功	分类启用	新增产品	产品写入并关联分类
PROD-005	产品列表筛选	多产品	按名称、规格、分类、状态筛选	返回符合条件数据
PROD-006	产品详情	产品存在	请求详情	返回分类、成本、售价、状态
PROD-007	禁用产品下单	产品禁用	订单选择该产品提交	拦截或明确提示
PROD-008	产品快照	产品已用于订单	修改产品名称/成本	历史订单快照不变

5. 订单主流程测试

用例编号	用例名称	前置条件	步骤	预期结果
ORD-001	创建草稿订单	业务员登录、产品存在	填写客户、明细、费用提交	返回订单 ID，状态 draft
ORD-002	新客户自动入库	客户库无该客户	创建订单	自动创建客户
ORD-003	利润计算	销售 100、成本 60、回扣 5、运费 10、税费 3、其他 2	创建订单	利润 20，利润率 20%
ORD-004	固定提成保存	输入固定提成 50	创建订单	commission_amount=50
ORD-005	明细为空	无明细	创建订单	返回 40001
ORD-006	数量非法	数量为 0	创建订单	返回 40001
ORD-007	提交审核成功	订单为 draft	提交审核	状态变为 pending_approve
ORD-008	重复提交	订单已 pending_approve	再次提交	返回 40005
ORD-009	管理层审批通过	订单 pending_approve	管理层通过	状态变为 approved
ORD-010	管理层审批退回	订单 pending_approve	管理层退回并填写意见	状态变为 rejected，业务员收到通知
ORD-011	生成下发文本	订单 approved	生成下发文本	返回文本内容
ORD-012	确认下发工厂	订单 approved	确认下发	状态变为 pending_factory
ORD-013	非 approved 确认下发	订单 draft	确认下发	返回 40005
ORD-014	订单列表筛选	多订单	按状态、客户、时间筛选	返回符合条件数据
ORD-015	订单详情字段权限	业务员登录	查看本人订单详情	不返回成本、利润等无权限字段
ORD-016	管理层订单详情	管理层登录	查看订单详情	返回完整财务字段

6. 订单取消流程测试

用例编号	用例名称	前置条件	步骤	预期结果
CAN-001	草稿订单取消	订单 draft	业务员提交取消	状态直接 canceled
CAN-002	待审核订单取消	订单 pending_approve	业务员提交取消	状态直接 canceled
CAN-003	已审批订单取消申请	订单 approved	业务员提交取消	状态 cancel_pending，记录取消前状态
CAN-004	履约中订单取消申请	订单 picked_up	业务员提交取消	状态 cancel_pending
CAN-005	取消审批通过	订单 cancel_pending	管理层同意	状态 canceled
CAN-006	取消审批拒绝	订单 cancel_pending 且原状态 approved	管理层拒绝	状态恢复 approved
CAN-007	已取消再次取消	订单 canceled	提交取消	返回 40005
CAN-008	取消原因必填	可取消订单	不填原因提交	返回 40001

7. 司机任务与履约测试

用例编号	用例名称	前置条件	步骤	预期结果
TASK-001	管理层创建任务	订单可履约、司机存在	填写任务并保存	返回任务 ID，状态 pending
TASK-002	司机任务列表	driver01 有任务	driver01 查看列表	只显示本人任务
TASK-003	任务详情脱敏	任务存在	司机查看详情	不显示客户敏感信息和财务字段
TASK-004	接单成功	任务 pending	司机接单	状态 accepted，记录接单时间
TASK-005	重复接单	任务已 accepted	再次接单	返回 40005
TASK-006	揽货成功	任务 accepted	上传照片确认揽货	状态 picked_up，附件写入
TASK-007	揽货无照片	任务 accepted	不上传照片确认	返回 40001 或业务错误
TASK-008	送达成功	任务 picked_up	确认送达	状态 delivered，订单状态联动
TASK-009	非法送达	任务 pending	直接送达	返回 40005
TASK-010	司机越权操作	driver01 操作 driver02 任务	接单/揽货/送达	返回 40003

8. 文件与 OSS 测试

用例编号	用例名称	前置条件	步骤	预期结果
FILE-001	获取上传凭证	用户登录	请求上传凭证	返回 upload_url、file_url、expire_at
FILE-002	图片上传成功	OSS 可用	上传图片并保存附件	file_attachment 写入 image 元数据
FILE-003	视频上传成功	OSS 可用	上传视频并保存附件	file_attachment 写入 video 元数据
FILE-004	文件过大	设置上传限制	上传超限文件	返回 40008 或明确错误
FILE-005	OSS 失败	模拟 OSS 异常	上传	返回 40008，记录日志
FILE-006	附件关联	任务存在	上传任务附件	附件 biz_type/biz_id 正确

9. 物流与 AI 测试

用例编号	用例名称	前置条件	步骤	预期结果
LOG-001	手动新增物流节点	订单存在	新增节点	logistics_trace 写入
LOG-002	物流轨迹查询	订单有节点	查询轨迹	按时间返回节点
LOG-003	物流超时提醒	首节点后 48 小时无流转	执行提醒检查	生成一次提醒
LOG-004	物流超时不重复提醒	已提醒	再次执行检查	不重复生成
AI-001	OCR 识别成功	OSS 图片存在，阿里云凭证有效	发起识别	保存 raw_result、confidence、suggested_result
AI-002	OCR 识别失败	模拟阿里云失败	发起识别	返回 40009，记录异常
AI-003	人工修正	识别记录存在	提交 corrected_result	保存修正结果，不覆盖原始结果
AI-004	识别结果人工确认	识别出疑似订单	页面确认	不自动审批、不自动合并

10. 欠款与提醒测试

用例编号	用例名称	前置条件	步骤	预期结果
ARR-001	delivered 模式生成欠款	配置 arrears_generate_mode=delivered	订单送达	生成欠款记录
ARR-002	shipped 模式生成欠款	配置 arrears_generate_mode=shipped	订单发货	生成欠款记录
ARR-003	未到节点不生成欠款	配置 delivered，订单 shipped	检查欠款	不生成
ARR-004	结算关闭欠款	欠款 pending/overdue	执行结算	状态 closed 或 paid，记录关闭时间
ARR-005	欠款超期提醒	欠款超过账期	执行提醒检查	生成业务员提醒
ARR-006	沉默客户提醒	客户超过周期未下单且金额达阈值	执行检查	生成提醒
ARR-007	沉默客户低金额不提醒	金额低于阈值	执行检查	不生成提醒
ARR-008	提醒已读	提醒存在	标记已读	状态 read

11. 报表测试

用例编号	用例名称	前置条件	步骤	预期结果
REP-001	月度统计	多订单跨月份	查询月报	按月份汇总正确
REP-002	季度统计	多订单跨季度	查询季报	按季度汇总正确
REP-003	年度统计	多订单跨年份	查询年报	按年份汇总正确
REP-004	分类统计	产品分类存在	查询报表	按分类金额汇总正确
REP-005	固定提成统计	订单有 commission_amount	查询报表	提成金额按订单固定值汇总
REP-006	电商订单剔除	存在电商来源订单	查询报表	按规则剔除或可配置剔除
REP-007	报表导出	查询条件存在	点击导出	返回 file_url，文件内容与页面一致

12. 系统配置与审计测试

用例编号	用例名称	前置条件	步骤	预期结果
CFG-001	查询配置	配置存在	查询 config_key	返回配置值
CFG-002	更新配置	管理员登录	更新欠款生成模式	保存成功，写审计日志
CFG-003	非管理员更新配置	业务员登录	更新配置	返回 40003
AUD-001	订单创建审计	创建订单	查询审计日志	有 create order 记录
AUD-002	审批审计	审批订单	查询审计日志	有 approve 记录
AUD-003	取消审计	取消订单	查询审计日志	有 cancel 记录
AUD-004	司机操作审计	接单/揽货/送达	查询审计日志	有对应记录
AUD-005	OSS 上传审计	上传附件	查询审计日志	有上传记录或文件记录

13. 系统管理测试

用例编号	用例名称	前置条件	步骤	预期结果
SYS-001	新增用户成功	管理员登录，角色已存在	新增账号、姓名、手机号、角色、初始密码	返回用户 ID，用户可正常登录
SYS-002	用户账号重复	已存在 username	新增同 username 用户	返回 40006
SYS-003	用户角色不存在	role_id 不存在或停用	新增或更新用户	返回 40004
SYS-004	停用用户	用户启用	管理员停用用户后，该用户登录	停用成功，登录返回 40003
SYS-005	重置密码	用户存在	管理员重置密码，用户用新密码登录	新密码可登录，旧密码不可登录
SYS-006	新增角色成功	管理员登录	新增 role_name、role_code、状态	返回角色 ID，角色列表可查询
SYS-007	角色编码重复	已存在 role_code	新增同 role_code 角色	返回 40006
SYS-008	停用有启用用户的角色	角色下存在启用用户	停用角色	返回 40007 或要求先处理用户
SYS-009	新增菜单成功	管理员登录	新增菜单名称、路径、权限编码	菜单树可查询到新菜单
SYS-010	菜单权限编码重复	已存在 permission_code	新增同编码菜单	返回 40006
SYS-011	菜单父级非法	将菜单父级设置为自身或子级	更新菜单	返回 40007
SYS-012	角色授权保存	角色、菜单存在	给角色配置 menu_ids 和 permission_codes	保存成功，重新登录后菜单和按钮权限生效
SYS-013	非管理员访问系统管理接口	业务员或司机登录	请求用户/角色/菜单管理接口	返回 40003
SYS-014	权限变更审计	修改角色授权	查询审计日志	有授权前后差异记录

14. 页面端到端测试

用例编号	用例名称	端	步骤	预期结果
E2E-001	业务员完整录单	Vue 业务员端	登录、创建订单、提交审核	订单进入待审核
E2E-002	管理层审批通过	小程序管理层端	登录、查看待审批、通过	订单进入 approved
E2E-003	确认下发工厂	小程序管理层端	生成文本、复制、确认下发	订单进入 pending_factory
E2E-004	创建司机任务	管理后台/管理层端	创建并分配任务	司机端可见
E2E-005	司机履约完成	小程序司机端	接单、揽货、送达	任务 delivered，订单联动
E2E-006	欠款生成	后端/页面	送达后检查欠款	欠款生成
E2E-007	报表查看导出	Vue 管理后台	查询报表、导出	页面和文件一致

15. 回归测试清单

每次发布前必须执行：

• 登录、退出、token 过期。
• 用户、角色、菜单和授权刷新。
• 订单创建、提交、审批、取消、下发确认。
• 司机任务创建、接单、揽货、送达。
• 权限越权检查：业务员、司机至少各 2 条。
• OSS 图片上传、视频上传。
• AI OCR 成功和失败。
• 欠款生成模式 shipped 和 delivered。
• 报表统计和导出。
• 审计日志查询。

16. 验收通过标准

类型	标准
阻断缺陷	0 个
严重缺陷	0 个
一般缺陷	已确认不影响上线或有明确修复计划
核心流程用例	100% 通过
权限与数据安全用例	100% 通过
报表金额核对	与数据库手工核对一致
审计日志	关键操作 100% 可追溯