anxinyan/docs/deploy/delivery-notes.md

安心验当前交付说明

1. 当前交付范围

本阶段已覆盖以下端与能力：

• 用户端 H5
• 用户端小程序共用代码
• 管理后台
• 履约主流程
• 报告验真与下载
• 用户消息通知

本阶段不纳入：

• 上门鉴定复杂预约
• 积分商城
• 内容社区
• 直播 / 短视频
• 裂变分销
• 官网
• 商家后台

2. 已完成模块

用户端

• 登录
  • 手机号 + 密码
  • 手机号 + 验证码
• 发起鉴定
  • 选择服务方式
  • 选择商品信息
  • 补充购买信息
  • 上传鉴定资料
  • 订单确认
• 订单中心
  • 列表页
  • 详情页
  • 寄送页
  • 补料页
• 报告中心
  • 报告列表
  • 报告详情
  • 报告验真
• 消息中心
• 工单中心
• 地址管理
• 我的 / 设置

后台

• 管理员登录
• 订单中心
• 鉴定作业台
• 商品资料中心
• 报告中心
• 消息中心
• 客服与售后
• 用户管理
• 仓库中心
• 权限中心
• 系统配置

3. 已完成履约链路

送检链路

• 下单确认时选择寄回地址
• 订单创建后锁定送检仓库
• 用户可在寄送前切换检测中心
• 用户提交寄送运单
• 后台标记鉴定中心签收

鉴定链路

• 鉴定
• 补料发起
• 用户补料
• 报告生成
• 报告发布

寄回链路

• 用户确认寄回地址
• 后台登记回寄运单
• 用户端查看回寄物流
• 后台标记用户签收
• 消息中心同步回寄与签收通知

4. 历史兼容处理

当前代码已兼容以下历史数据问题：

• 老订单没有 order_return_addresses 快照时
  • 用户端订单详情会自动回退展示默认地址
  • 后台登记回寄运单时会自动用默认地址补写快照
• 历史 verify_qrcode_url 不是图片链接时
  • 用户端报告详情会直接本地生成二维码 SVG
• 历史 display_status 与当前真实履约状态不一致时
  • 用户端和后台订单列表会优先按真实物流状态推导展示

5. 当前仍建议人工重点确认

• 老订单回寄状态是否符合实际业务预期
• 订单列表中 待寄回 / 物品已寄回 / 已完成 的显示是否满足运营口径
• 管理后台权限是否满足正式分工
• 支付、短信、小程序正式配置是否完整

6. 当前已知上线前必须处理项

根据 php tools/release_audit.php 当前结果，当前仍剩以下未完成项：

• 小程序正式配置仍为空：
  • mini_program.app_id
  • mini_program.app_secret
  • mini_program.original_id

已完成但需要运维知晓的变更：

• 后端 .env 已切换为生产开关：
  • APP_ENV=production
  • APP_DEBUG=false
• 前端生产 API 域名已替换为正式域名
• 测试管理员已停用
• 默认超级管理员密码已旋转，不再使用初始密码

7. 建议的最终上线动作

1. 跑 tools/release_audit.php
2. 在后台补齐小程序正式配置
3. 执行 cd user-app && npm run sync:mp-config
4. 再次运行 tools/release_audit.php
5. 修正审计结果中的剩余 FAIL
6. 跑 tools/smoke_check.php
7. 按 fulfillment-smoke-checklist.md 执行人工验收
8. 清理测试数据
9. 构建正式包并发布