# 服务器 Agent 交付包

## 这个目录给谁

给服务器内 Agent 或负责部署的人使用。

## 里面有什么

- `SERVER_AGENT_DEPLOYMENT_HANDOFF.md`：部署主说明，按这个执行。
- `PRODUCTION_QA_AGENT_CHECKLIST.md`：生产 QA 验收清单。
- `PRODUCTION_RUNBOOK.md`：生产运行手册。
- `BACKUP_RESTORE.md`：备份恢复说明。
- `CAPACITY_AND_SECURITY_PLAN.md`：并发容量、安全红线和压测门槛。
- `RELEASE_BASELINE_GROUPS.md`：当前工作区分组说明。
- `.env.production.example`：生产环境变量模板，不含真实密钥。
- `docker-compose.yml`：生产 Compose 配置参考。
- `Makefile`：部署、迁移、检查、备份命令入口。

## 服务器 Agent 必须拿到什么

这个目录只是交接说明，不是完整项目源码。服务器 Agent 必须拿到以下两者之一：

1. 当前这台机器上的完整项目目录。
2. 已提交并推送到 Git 仓库的最新代码。

如果服务器 Agent 只拉取旧的 `main` 分支，而当前改动没有提交/推送，部署结果会是旧版本。

## 建议发给服务器 Agent 的一句话

请使用完整仓库最新代码，按 `handoff/server-agent/SERVER_AGENT_DEPLOYMENT_HANDOFF.md` 部署生产环境，然后按 `handoff/server-agent/CAPACITY_AND_SECURITY_PLAN.md` 做容量与安全验收，再按 `handoff/server-agent/PRODUCTION_QA_AGENT_CHECKLIST.md` 完成全链路 QA。生产域名是 `https://bigdata.dtacloud.cn`，小程序生产 API 依赖 `https://bigdata.dtacloud.cn/api`。

## 不要上传到 Git 或群里的内容

- `.env.production` 真实文件
- 微信支付 pem/p12/zip 证书
- 阿里云 AccessKey
- 微信 AppSecret
- JWT/session 密钥
- 数据库密码
