131 lines
2.6 KiB
Markdown
131 lines
2.6 KiB
Markdown
# 安心验部署说明
|
||
|
||
## 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. 本地常用命令
|
||
|
||
### 后端
|
||
|
||
```bash
|
||
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
|
||
|
||
```bash
|
||
cd /Users/wushumin/www/biyou/anxinyan/user-app
|
||
npm run dev:h5
|
||
npm run type-check
|
||
npm run build:h5
|
||
```
|
||
|
||
### 管理后台
|
||
|
||
```bash
|
||
cd /Users/wushumin/www/biyou/anxinyan/admin-web
|
||
npm run build
|
||
```
|
||
|
||
### 小程序配置同步
|
||
|
||
```bash
|
||
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. 当前状态
|
||
|
||
当前代码库已经具备：
|
||
|
||
- 用户端主流程
|
||
- 后台订单履约主流程
|
||
- 多仓库 / 改派仓库
|
||
- 补料任务
|
||
- 报告发布与验真
|
||
- 寄回地址确认
|
||
- 回寄运单登记
|
||
- 用户签收闭环
|
||
|
||
剩余工作更偏向：
|
||
|
||
- 正式环境配置
|
||
- 测试数据清理
|
||
- 人工验收
|
||
- 上线前口径确认
|