2026-05-21-14-19-12 记录Docker三版本Release发布

工程分析/测试方案-2026-05-21-14-19-12.md

@@ -0,0 +1,72 @@
+# 测试方案：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`。