REVOXELSEG_DICOM/工程分析/测试方案-2026-05-21-00-05-04.md

测试方案-2026-05-21-00-05-04

测试方案文档路径

工程分析/测试方案-2026-05-21-00-05-04.md

静态检查

• 执行 cd WebSite && npm run lint，确认 TypeScript 类型检查通过。
• 使用 rg 检查旧的 fileToBase64 和 JSON 导入链路是否已移除或不再用于项目资产导入。

执行结果：npm run lint 已通过；项目库导入已不再使用 fileToBase64 或 Promise.all(files.map(...base64))。

构建检查

• 执行 cd WebSite && npm run build，确认生产构建通过。

执行结果：npm run build 已通过；Vite 仅提示既有 chunk 体积超过 500 kB。

关键业务场景验证

• 项目库 DICOM 影像导入时显示文件数、上传百分比和进度条。
• 项目库 3D 模型导入时显示文件数、上传百分比和进度条。
• 上传完成到服务端解压/解析期间显示“服务器处理中”状态。
• 已有 DICOM/STL 时仍先弹出覆盖提醒。
• 文件选择器允许普通 DICOM/STL，也允许 .zip、.tar、.tar.gz、.tgz、.gz。

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

• 导入 ZIP 中的 STL 文件后，项目 modelCount 和 stlFiles 更新。
• 导入 ZIP/TAR.GZ 中的 DICOM 文件后，项目 dicomCount 更新，并生成 DICOM 信息缓存。
• 压缩包中无关文件不会进入项目资产目录。
• 路径穿越条目不会写出上传目标目录。
• 导入后清理 DICOM/STL/Fusion 缓存，避免旧预览残留。

执行结果：使用临时项目上传包含 会厌.stl 的 ZIP，接口返回 modelCount: 1、stlFiles: ["会厌.stl"]；验证后已删除临时项目和临时上传目录。

部署验证

• 重启 tmux 会话 revoxelseg-dicom。
• 验证：
  • curl http://127.0.0.1:4000/api/health
  • curl -I http://127.0.0.1:4000/
  • curl http://127.0.0.1:4000/api/projects 中默认项目仍为 DICOM 300、STL 9。

执行结果：服务已用新代码临时重启并通过 /api/health、首页响应验证；当前运行态中默认项目已被用户导入过肝脏 STL，因此最终不以 STL 9 作为强制断言，恢复演示环境仍可回到默认数据。

Git/Gitea 备份验证

• git status --short 确认暂存范围不包含无关历史删除或软著材料。
• commit message 包含 2026-05-21-00-05-04。
• 推送到 Gitea main 成功。

风险与回归关注点

• 大文件上传进度是上传阶段进度，不代表服务端解压完全结束。
• multer 内存缓存仍会占用服务端内存，后续如需超大数据集，应改为磁盘临时文件流式处理。
• STL 预览在导入成功后的渲染精度仍需控制，避免一次性加载过多超大构件。