# 测试方案：Gitea Releases 发布三种 Docker 部署版本

测试方案文档路径：`工程分析/测试方案-2026-05-21-14-19-12.md`

## 静态检查

- 检查三个版本 tag 是否存在。
- 检查三个 Release 是否存在。
- 检查通用版不包含具体 FRPC 地址、token、远端端口和域名。
- 检查三种版本根目录均有 `docker_compose.yaml`。

## 构建检查

- 对机器版执行 `docker compose -f docker_compose.yaml config`。
- 对 NAS 版执行 `docker compose -f docker_compose.yaml config`。
- 对通用版执行 `docker compose --env-file .env.example -f docker_compose.yaml config`。

## 关键业务场景验证

- 当前独立 Docker 服务仍可通过 `/api/health` 正常响应。
- `https://revoxel.huijutec.cn/` 当前入口仍可访问。
- Release 下载用户可依据 README 使用对应 Compose 启动。

## 医学影像数据相关边界验证

- 发布分支仍包含默认 `Head_CT_DICOM/` 和 `Head_CT_ReConstruct/`。
- 发布分支不包含 `data/`、`exports/`、`WebSite/node_modules/`、`WebSite/dist/` 等运行态和构建产物。

## 部署验证

- 不重新启动服务；保持当前独立 Docker 服务运行。
- 使用 `curl http://127.0.0.1:4000/api/health` 验证服务状态。
- 使用 `curl https://revoxel.huijutec.cn/` 验证公网入口。

## Git/Gitea 备份验证

- 推送三个发布分支和三个 tag。
- 使用 Gitea API 创建三个 Release。
- 使用 Gitea API 查询 Release 列表确认发布成功。
- 主项目工程分析记录 commit message 包含 `2026-05-21-14-19-12`。

## 风险与回归关注点

- 通用版删除具体 FRPC 信息后不能直接公网访问，需使用者自行填写 `.env`。
- Gitea Release 的源码包较大，下载时间与网络有关。
- 不应把 Gitea 管理员密码写入任何文件或 Release 正文。

## 实际执行结果

- 已创建并推送发布分支：
  - `release/docker-machine-20260521`
  - `release/docker-nas-20260521`
  - `release/docker-generic-20260521`
- 已创建并推送 tag：
  - `revoxelseg-docker-machine-v2026.05.21`，目标提交 `57415a1`
  - `revoxelseg-docker-nas-v2026.05.21`，目标提交 `ce78e3e`
  - `revoxelseg-docker-generic-v2026.05.21`，目标提交 `3ad83a6`
- 机器版 `docker_compose.yaml` 配置校验通过。
- NAS 版 `docker_compose.yaml` 配置校验通过。
- 通用版 `docker_compose.yaml` 配置校验通过。
- 通用版启用 `--profile frpc` 后配置校验通过。
- 通用版全目录检查未发现固定 FRPC 服务地址、固定 token、远端端口 `10008`、固定公网域名或本机固定内网地址。
- 已通过 Gitea API 创建 Release：
  - `ReVoxelSeg DICOM Docker 机器直接部署版 v2026.05.21`
  - `ReVoxelSeg DICOM Docker NAS 直接部署版 v2026.05.21`
  - `ReVoxelSeg DICOM Docker 通用版 v2026.05.21`
- Gitea API 查询确认三个 Release 均存在：
  - `https://gitea.huijutec.cn/admin/REVOXELSEG_DICOM/releases/tag/revoxelseg-docker-machine-v2026.05.21`
  - `https://gitea.huijutec.cn/admin/REVOXELSEG_DICOM/releases/tag/revoxelseg-docker-nas-v2026.05.21`
  - `https://gitea.huijutec.cn/admin/REVOXELSEG_DICOM/releases/tag/revoxelseg-docker-generic-v2026.05.21`
- 当前独立 Docker 服务健康检查通过：`/api/health` 返回 `ok: true`。
- 当前公网入口 `https://revoxel.huijutec.cn/` 返回 `200 OK`。