first

docs/deploy/delivery-notes.md

@@ -0,0 +1,138 @@
+# 安心验当前交付说明
+
+## 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. 构建正式包并发布