# 腾讯云部署说明

本文档记录当前后端部署到腾讯云函数 SCF，并连接腾讯云数据库 MySQL 与 COS 的最小流程。

## 1. 数据库初始化

先确认 `server/.env` 或部署环境变量中已配置数据库：

```env
DB_HOST=
DB_PORT=3306
DB_USER=root
DB_PASSWORD=
DB_NAME=jw_beauty
```

本地直连公网数据库时，需要在腾讯云数据库的安全组/白名单中放行本机公网 IP。若本地无法直连，也可以临时通过支持 SOCKS5 的代理建立本地 TCP 隧道，再覆盖 `DB_HOST` 和 `DB_PORT` 执行初始化。

```bash
cd server
npm install
npm run db:init
```

初始化会创建业务表，并写入临时后台账号。生产环境首次登录后应立即更换默认密码。

## 2. SCF 函数配置

当前函数 `jw-beauty-api` 是腾讯云 HTTP 函数。HTTP 函数部署包根目录需要包含可执行的 `scf_bootstrap`，由它启动 HTTP 服务。

本项目的 HTTP 函数启动文件：

```text
scf_bootstrap
```

`scf_bootstrap` 会执行：

```bash
node scripts/local-server.js
```

HTTP 服务监听端口使用环境变量 `PORT`，建议配置为 `9000`。

如果以后改为普通事件函数，入口才使用：

```text
index.main_handler
```

触发器：

```text
HTTP 触发器或函数 URL
```

触发器需要透传：

```text
method
path
headers
queryStringParameters
body
```

## 3. 环境变量

参考模板：

```text
server/.env.production.example
```

生产必须配置：

```env
NODE_ENV=production
TENCENT_SECRET_ID=
TENCENT_SECRET_KEY=
TENCENT_REGION=ap-guangzhou
DB_HOST=
DB_PORT=3306
DB_USER=
DB_PASSWORD=
DB_NAME=jw_beauty
COS_BUCKET=jw-bucket-1426323813
COS_REGION=ap-guangzhou
WECHAT_APPID=
WECHAT_SECRET=
JWT_SECRET=
ADMIN_JWT_SECRET=
ADMIN_USERNAME=admin
ADMIN_PASSWORD=
```

不要提交真实 `.env`、密钥、数据库密码或微信密钥。

## 4. 数据库网络

SCF 与腾讯云数据库建议使用同地域、同 VPC 内网连接。

如果使用公网地址，需要确认：

- 数据库已开启公网访问。
- 安全组允许 SCF 出口或本机出口访问数据库端口。
- `DB_PORT` 与控制台展示端口一致。

## 5. COS 固件

固件文件先上传到 COS，然后在后台登记对象 key。

相关接口：

```http
GET  /api/v1/admin/firmware
POST /api/v1/admin/firmware
POST /api/v1/admin/firmware/:firmware_id/status
GET  /api/v1/firmware/latest
```

小程序调用 `GET /api/v1/firmware/latest` 时，后端会返回短期有效的 COS 签名下载 URL。

## 6. 前端 API 地址

SCF HTTP 地址确认后，更新：

```text
miniprogram/config/env.js
admin-console/src/config/env.js
```

把 `test` 或 `prod` 改为腾讯云函数 HTTPS 地址。

微信小程序正式联调还需要在微信公众平台配置 `request 合法域名`。

## 7. 管理后台 H5 部署到 COS

管理后台构建产物位于：

```text
admin-console/dist/build/h5
```

先确认 `admin-console/src/config/env.js` 已指向测试或生产 API，再执行：

```bash
cd admin-console
npm install
npm run build:h5
```

如需直接上传到 COS，可复用 `server/.env` 中的 COS 凭证：

```bash
cd admin-console
npm run deploy:cos
```

默认上传前缀：

```text
admin/
```

可通过环境变量覆盖：

```bash
ADMIN_COS_PREFIX=admin-test/ npm run deploy:cos
```

## 8. 部署后验证

建议按顺序验证：

```http
GET  /health
POST /api/v1/admin/login
GET  /api/v1/admin/dashboard
POST /api/v1/admin/devices
GET  /api/v1/admin/devices
GET  /api/v1/admin/firmware
```

再进入小程序验证：登录、扫码绑定、BLE 连接、绑定确认、普通模式护理、护理记录同步。