anxinyan/docs/deploy/deploy-plan.md

安心验部署说明

1. 项目结构

• server-api 技术栈：PHP 8 + webman + MySQL + Redis
• user-app 技术栈：uni-app + Vue 3 + TypeScript 产物：
  • H5
  • 微信小程序
• admin-web 技术栈：Vue 3 + Vite + TypeScript + Element Plus

2. 当前已确认域名

• 用户端 H5：m.anxinjianyan.com
• 后端 API：api.anxinjianyan.com
• 管理后台：admin.anxinjianyan.com

说明：

• H5 页面根地址会用于生成报告页、验真页、扫码跳转链接
• API 域名会用于 H5、后台、小程序请求

3. 本地常用命令

后端

cd /Users/wushumin/www/biyou/anxinyan/server-api
php start.php start -d
php start.php reload -d
php tools/smoke_check.php
php tools/release_audit.php

用户端 H5

cd /Users/wushumin/www/biyou/anxinyan/user-app
npm run dev:h5
npm run type-check
npm run build:h5

管理后台

cd /Users/wushumin/www/biyou/anxinyan/admin-web
npm run build

小程序配置同步

cd /Users/wushumin/www/biyou/anxinyan/user-app
npm run sync:mp-config
npm run build:mp-weixin

4. 部署顺序建议

1. 导入数据库结构与种子数据
2. 执行 schema 升级脚本
3. 配置后端 .env
4. 在后台完成系统配置
5. 构建并部署 admin-web
6. 构建并部署 user-app H5
7. 同步小程序 AppID 并构建小程序包
8. 跑 smoke_check.php
9. 执行人工履约链路验收

5. 当前必须执行的 schema 升级

已存在脚本：

• php tools/schema_upgrade_warehouses.php
• php tools/schema_upgrade_order_shipping_targets.php
• php tools/schema_upgrade_order_return_flow.php
• php tools/schema_upgrade_manual_reports.php
• php tools/schema_upgrade_user_login_sms.php

建议在正式环境按上述顺序执行一次。

6. 后台必须配置的分组

• 小程序配置
• H5 配置
• 短信配置
• 微信支付 / 商户平台配置

其中：

• H5 根地址必须指向正式域名
• 小程序 AppID 必须同步到 manifest.json
• 支付证书和商户密钥必须在后台上传或保存

7. 部署后必须验证的主链路

• 用户下单
• 用户提交寄送运单
• 后台标记鉴定中心签收
• 后台发起补料
• 用户补料
• 后台发布报告
• 用户确认寄回地址
• 后台登记回寄运单
• 后台标记用户签收
• 用户报告验真

8. 当前状态

当前代码库已经具备：

• 用户端主流程
• 后台订单履约主流程
• 多仓库 / 改派仓库
• 补料任务
• 报告发布与验真
• 寄回地址确认
• 回寄运单登记
• 用户签收闭环

剩余工作更偏向：

• 正式环境配置
• 测试数据清理
• 人工验收
• 上线前口径确认