# 安心验当前交付说明

## 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](/Users/wushumin/www/biyou/anxinyan/docs/deploy/fulfillment-smoke-checklist.md) 执行人工验收
8. 清理测试数据
9. 构建正式包并发布