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

测试方案：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。