# 安心验部署说明

## 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. 当前状态

当前代码库已经具备：

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

剩余工作更偏向：

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