# 服务器 Agent 完整部署包说明

这个压缩包是给服务器 Agent 使用的完整部署包，包含当前工作区的后端、Web、部署编排和运维文档。解压后可直接按 Docker Compose 方式部署生产候选环境。

## 包内主要内容

- `backend/`：后端源码、数据库迁移、Prisma schema、后端测试脚本。
- `web/`：Next.js Web 源码、Cloudflare Pages 配置、Playwright 测试。
- `deploy/`：Caddy、Prometheus、Alertmanager、Grafana 配置。
- `docs/`：生产部署、QA、容量、安全、备份恢复文档。
- `docker-compose.yml`、`Makefile`、`.env.production.example`：服务器部署入口。
- `handoff/server-agent/`：给服务器 Agent 的交接说明与验收清单。

## 服务器上执行顺序

```bash
unzip dlbdi-server-agent-full-*.zip
cd dlbdi-server-agent-full-*
shasum -a 256 ../dlbdi-server-agent-full-*.zip
cp .env.production.example .env.production
```

在 `.env.production` 中填入真实生产值，尤其是数据库密码、JWT 密钥、短信、微信支付、对象存储和告警密钥。不要把真实 `.env.production` 或微信支付证书上传回 Git、群聊或公开网盘。

```bash
make audit-production

# 已有服务升级先备份；全新空服务器可跳过。
make backup

# make deploy 会构建镜像、停止旧服务、跑数据库迁移、再启动新服务。
make deploy
```

健康检查：

```bash
curl -fsS https://bigdata.dtacloud.cn/api/health
curl -fsS https://bigdata.dtacloud.cn/api/health/deep
curl -fsS https://bigdata.dtacloud.cn/api/metrics && exit 1 || test "$?" -eq 22
```

生产 QA 请继续按：

- `handoff/server-agent/SERVER_AGENT_DEPLOYMENT_HANDOFF.md`
- `handoff/server-agent/PRODUCTION_QA_AGENT_CHECKLIST.md`
- `handoff/server-agent/CAPACITY_AND_SECURITY_PLAN.md`

## 已排除内容

- `node_modules/`
- `.next/`、`.vercel/` 等构建缓存
- `.git/`
- `secrets/`
- `.env`
- `.env.production`
- 微信支付证书、Cloudflare/Wrangler 本地登录态
- 上传文件、备份文件、本地临时 QA 产物
