anxinyan/docs/deploy/fulfillment-smoke-checklist.md

安心验履约链路冒烟检查表

目标

确认用户端、后台、消息中心围绕以下主链路已经闭环：

1. 用户下单
2. 用户寄送商品并提交运单
3. 鉴定中心签收
4. 鉴定中 / 补料
5. 报告出具
6. 用户确认寄回地址
7. 后台登记回寄运单
8. 用户签收回寄商品

自动检查

先执行：

cd /Users/wushumin/www/biyou/anxinyan/server-api
php tools/smoke_check.php

预期：

• 输出 SMOKE_OK
• app 与 admin 关键接口全部通过
• 报告详情接口包含 verify_qrcode_url

人工检查

1. 新建订单

• 用户端发起一笔新订单
• 在确认订单页必须可以选择“寄回地址”
• 未选择寄回地址时，不能提交订单
• 订单创建成功后，订单详情应显示：
  • 收货仓库
  • 寄回地址
  • 下单资料

2. 用户寄送

• 订单状态应为 待寄送 或 已提交运单
• 用户寄送页应只展示“寄往鉴定中心”物流
• 提交运单后：
  • 订单详情提示改为“等待鉴定中心签收”
  • 订单列表状态应显示 已提交运单

3. 鉴定中心签收

• 后台订单详情点击“标记鉴定中心签收”
• 订单状态应变为 鉴定中心已收货
• 用户端订单详情同步显示已签收

4. 补料

• 后台发起补料后：
  • 用户端订单状态应显示 等待您补充资料
  • 鉴定作业台任务状态应显示 待用户补料
  • 不得出现 已退回 这类容易误解成回寄商品的文案

5. 报告出具

• 后台发布报告后：
  • 用户端报告中心出现报告
  • 报告详情页显示验真二维码
  • 订单状态应显示 待寄回
  • 消息中心收到“报告已出具”

6. 用户确认寄回地址

• 订单详情页 寄回给您 区块应显示地址
• 老订单若没有寄回快照，应自动回退显示用户默认地址
• 用户可在回寄前修改寄回地址

7. 后台登记回寄运单

• 后台订单详情点击“登记回寄运单”
• 若订单没有寄回地址快照，但用户有默认地址，应能自动补写后继续登记
• 登记成功后：
  • 订单状态应显示 物品已寄回
  • 用户端订单详情显示回寄物流
  • 消息中心收到“鉴定物品已寄回”

8. 标记用户签收

• 后台订单详情点击“标记用户签收”
• 完成后：
  • 订单状态应显示 已完成
  • 回寄物流状态应为 用户已签收
  • 消息中心收到“回寄商品已签收”
  • 用户端订单详情应提示本次订单已完成

当前已实现的关键点

• 下单确认时选择寄回地址
• 订单详情展示寄回地址与回寄物流
• 后台登记回寄运单
• 后台标记用户签收
• 回寄消息通知联动
• 用户端与后台订单状态口径统一
• 报告详情二维码显示

仍建议重点人工确认

• 历史老订单在没有寄回地址快照时的展示是否符合预期
• completed 状态下，列表页是否准确区分：
  • 物品已寄回
  • 已完成
• 用户消息中心的回寄通知点击跳转是否总是进入正确订单
• 报告页二维码在 H5 与小程序环境下都能正常扫描