wx_service/docs/expiry/DEPLOYMENT.md

保质期小程序部署说明

1. 准备

1. 复制环境变量模板：

cp .env.example .env

2. 按实际环境填写 .env：数据库、Redis、AI、七牛、小程序 AppID、API 域名。
3. 确认域名解析到部署机：

• api.example.com -> 服务器公网 IP

2. 数据库初始化

mysql -h <host> -u <user> -p <db_name> < docs/sql/expiry.sql

3. 一键部署（Docker Compose）

docker compose -f docker-compose.prod.yml up -d --build

4. Nginx HTTPS 配置

1. 修改 deploy/nginx/wx_service_https.conf 中 server_name 与证书路径。
2. 挂载证书目录（例如 /etc/letsencrypt）。
3. 重载 Nginx：

docker exec wx_service_nginx nginx -s reload

5. 验证

1. 健康检查：

curl -i https://api.example.com/healthz
curl -i https://api.example.com/api/expiry/healthz

2. 接口联调：

BASE_URL=https://api.example.com TOKEN=<session_key> scripts/expiry/run_integration_tests.sh

6. 小程序侧配置

1. manifest.json 配置正式 appid。
2. 在小程序后台添加服务器域名：

• request 合法域名：https://api.example.com

3. 发布前执行：

# 在前端仓库 expiry_uniapp 中
npm install
npm run build -- wx

7. 回滚

docker compose -f docker-compose.prod.yml down
# 回滚到上一版本镜像后再 up -d