REVOXELSEG_DICOM/工程分析/测试方案-2026-05-25-14-00-24.md

测试方案-2026-05-25-14-00-24

测试方案文档路径

工程分析/测试方案-2026-05-25-14-00-24.md

静态检查

• 检查 TypeScript 类型是否通过 Vite 构建。
• 检查新增导出和 API 函数没有破坏现有 ProjectExportTarget、ModelPoseValue、AutoMatchRequest 使用。
• 检查 ZIP 内路径不包含项目名根目录。

构建检查

• 在 WebSite/ 执行：
  • npm run build

关键业务场景验证

• 请求 /api/projects/:projectId/export-bundle 导出分割、位姿等内容，确认响应为 .zip。
• 使用 unzip -l 查看 ZIP，确认存在 manifest.json、segmentation/labels.json，分类模式下存在 segmentation-parts/{类别名}.nii.gz。
• 前端导出按钮点击后确认顶部进度条出现并完成后自动消失。
• 新增 /api/reverse-pipeline 在默认不导出时返回 JSON；在指定导出内容时返回 ZIP。

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

• 分割导出应继续使用当前 DICOM 体数据和当前位姿。
• 可见类别导出时仅导出可见构件；所有类别导出时导出全部构件。
• 分类导出的单构件 .nii.gz 文件命名可直接对应类别，类别映射 JSON 同包提供。

部署验证

• 重启 tmux 会话 revoxelseg-dicom 中的服务。
• 验证：
  • http://127.0.0.1:4000/api/health
  • http://127.0.0.1:4000/
  • https://revoxel.huijutec.cn/

Git/Gitea 备份验证

• git status --short 确认本次改动范围。
• commit message 包含 2026-05-25-14-00-24。
• 推送至 Gitea 后确认 origin/main 更新。

风险与回归关注点

• ZIP 下载文件名需要兼容中文项目名。
• 批处理 API 的临时项目目录需要在不入库时清理，避免磁盘堆积。
• 自动匹配失败不能导致已上传临时文件残留或项目状态异常。
• 导出进度条不能遮挡和阻塞其他功能。