# 测试方案：合并 Docker 三版本 Gitea Release

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

## 静态检查

- 检查独立 Docker 仓库存在三个 release tag。
- 检查通用版 tag 中不包含固定 FRPC 服务端、token、远端端口、当前公网域名或内网访问地址。
- 检查生成附件中包含 `Dockerfile`、`docker_compose.yaml`、`README.md`、`WebSite/`、默认 DICOM 与 STL 数据。

## 构建检查

- 本次不重新构建镜像，沿用当前已验证的 Docker 独立程序内容。
- 使用 `tar -tzf` 检查三份压缩包结构可读。

## 关键业务场景验证

- Gitea 整合 Release 创建成功。
- 整合 Release 中能看到三个命名不同的附件。
- 旧三个分散 Release 记录被清理，避免 Releases 页面重复。

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

- 附件中保留默认 `Head_CT_DICOM/` 与 `Head_CT_ReConstruct/`，确保新环境可直接部署演示数据。
- 通用版不含当前固定公网 FRPC 配置，避免错误复用到其他医学影像部署环境。

## 部署验证

- 验证本机服务健康接口：`http://127.0.0.1:4000/api/health`。
- 验证公网入口：`https://revoxel.huijutec.cn/`。

## Git/Gitea 备份验证

- 确认整合 tag 已推送。
- 确认 Gitea Release API 返回整合 Release 与三个附件。
- 主工程只提交本次工程分析文档和经验记录。

## 风险与回归关注点

- 旧 Release 删除应在新 Release 附件上传完成后执行。
- 大附件上传完成后必须通过 API 查询附件名称和数量，不只依赖命令退出码。
- 文档提交时避免把历史删除和未跟踪软著、医学数据混入 commit。

## 实际验证结果

- 已生成三个附件：
  - `ReVoxelSeg_DICOM_Docker_machine_direct_v2026.05.21.tar.gz`，约 190MB。
  - `ReVoxelSeg_DICOM_Docker_nas_direct_v2026.05.21.tar.gz`，约 190MB。
  - `ReVoxelSeg_DICOM_Docker_generic_v2026.05.21.tar.gz`，约 190MB。
- `tar -tzf` 校验三份附件均包含根目录 `Dockerfile`、`docker_compose.yaml`、`README.md`、`WebSite/`、`Head_CT_DICOM/`、`Head_CT_ReConstruct/`。
- 对通用版 tag 使用 `git grep -I` 搜索固定环境字符串，未发现 `82.157.255.195`、`en.xjtu.edu.cn`、`10008`、`revoxel.huijutec.cn`、`192.168.3.11`、`192.168.31.7`。
- 已创建并推送整合 tag：`revoxelseg-docker-all-v2026.05.21`。
- 已创建 Gitea 整合 Release：
  - `https://gitea.huijutec.cn/admin/REVOXELSEG_DICOM/releases/tag/revoxelseg-docker-all-v2026.05.21`
  - Release ID：`44`
- 已上传三个附件，Gitea API 读回资产列表数量为 3：
  - `ReVoxelSeg_DICOM_Docker_generic_v2026.05.21.tar.gz`
  - `ReVoxelSeg_DICOM_Docker_machine_direct_v2026.05.21.tar.gz`
  - `ReVoxelSeg_DICOM_Docker_nas_direct_v2026.05.21.tar.gz`
- 上传通用包时曾出现一次 `502`，`curl --retry` 自动重传后成功。
- 已删除旧三个分散 Release 记录：
  - `revoxelseg-docker-machine-v2026.05.21`，原 Release ID `41`。
  - `revoxelseg-docker-nas-v2026.05.21`，原 Release ID `42`。
  - `revoxelseg-docker-generic-v2026.05.21`，原 Release ID `43`。
- Gitea API 复查 Docker 发布相关条目，仅剩整合 Release：`revoxelseg-docker-all-v2026.05.21`。
- Docker 运行验证：
  - `revoxelseg_web` 状态为 `Up ... (healthy)`，端口 `0.0.0.0:4000->4000`。
  - `revoxelseg_frpc` 状态为 `Up`。
- 服务验证：
  - `http://127.0.0.1:4000/api/health` 返回 `{"ok":true,"service":"revoxelseg-dicom"}`。
  - `https://revoxel.huijutec.cn/` 返回 `HTTP/2 200`。