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

测试方案 - 2026-05-04-05-20-16

静态检查

• 执行 npm run lint，确认 TypeScript 类型检查通过。
• 执行 npm run build，确认生产构建通过。

集成验证

• 调用 /api/projects/head-ct-demo/dicom-preview 验证：
  • plane=axial
  • plane=sagittal
  • plane=coronal
  • mode=bone
• 调用 /api/projects/head-ct-demo/dicom-archive 验证压缩包响应头和文件名。
• 调用 /api/projects/head-ct-demo/models/:fileName/preview 验证 STL 预览顶点数据非空。

关键业务场景验证

• 项目库 DICOM 视图：

  • 长按上下箭头能连续改变切片。
  • 三个面切换后图像显示完整。
  • 左/右旋转 90 度后画布方向变化。
  • 下载当前 PNG 命名包含项目、平面、切片、模式、旋转角度。
  • 下载 DICOM 压缩包可触发。

• 项目库 3D 模型视图：

  • 模型加载进度可见。
  • 加载完成后模型可见，而不是空白画布。
  • 颜色、透明度、显示/隐藏状态仍可影响渲染。

• 逆向工作区：

  • 顶部不再显示 Head_CT_DICOM ↔ Head_CT_ReConstruct。
  • 当前项目上下文仍可见。

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

• DICOM 序列按文件名自然排序。
• 矢状面/冠状面重建裁切保留边距，避免把真实人体区域裁掉。
• 显示模式与三平面组合时返回的 total、slice、width、height 合理。

回归风险

• DICOM 预览缓存键应包含平面、模式和切片，避免错图。
• PNG 下载应和当前旋转状态一致。
• 3D 模型抽样数量不能过高导致页面阻塞。

人工审核状态

用户已明确本次测试方案无需二次确认，记录后直接执行。

执行结果

• npm run lint：通过。
• npm run build：通过；Vite 提示 bundle 超过 500 kB，为 Three.js/Recharts 等现有依赖带来的体积警告，不阻断构建。
• GET /api/projects/head-ct-demo/dicom-preview?plane=axial&slice=150&mode=default：通过，返回 512x512，total=300，文件名 151.dcm。
• GET /api/projects/head-ct-demo/dicom-preview?plane=sagittal&slice=256&mode=bone：通过，返回 300x421，total=512。
• GET /api/projects/head-ct-demo/dicom-preview?plane=coronal&slice=256&mode=soft：通过，返回 300x512，total=512。
• HEAD /api/projects/head-ct-demo/dicom-archive：通过，返回 Content-Type: application/gzip，文件名 head-ct-demo-Head_CT_DICOM-300-files.tar.gz。
• GET /api/projects/head-ct-demo/models/会厌.stl/preview?limit=1200：通过，返回 1159 个抽样三角面、10431 个顶点数值。
• 无头 Chrome 前端验证：登录后进入项目库 3D 模型页，在 WebGL 不可用场景自动生成二维兜底预览，canvas 尺寸 1236x567，像素采样 nonBackground=67，确认不是空白画布。
• 已重启部署到 http://192.168.3.11:4000/，tmux 会话：revoxelseg-dicom。