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

测试方案 - 2026-05-04-05-41-22

静态检查

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

集成测试

• 调用 STL preview API：
  • limit=6000
  • limit=16000
  • limit=36000
• 确认返回顶点数量随实体化程度增加，且响应不报错。
• 调用 DICOM preview API，确认连续请求不同 slice 时均可返回合理 slice/total/width/height。

关键业务场景验证

3D 模型页

• 默认进入后模型可见。
• 实体化程度从“预览”切换到“标准/精细”后，模型表面更连续，而不是纯点云感。
• 开启“整体白色实体”后，显示效果接近参考图的灰白实体模型。
• 调整旋转 X/Y/Z、平移 X/Y/Z、缩放后，模型位姿即时变化。
• 点击重置后，位姿恢复默认。
• 隐藏/显示单个 STL、调整颜色、透明度仍正常。
• WebGL 不可用时二维兜底仍可见，不出现空白画布。

DICOM 切片页

• 长按上箭头时，切片编号连续增加，图像连续变化。
• 长按下箭头时，切片编号连续减少，图像连续变化。
• 快速连续切换时，不出现旧请求覆盖新切片的错帧。
• 到达首帧/末帧时不越界。

逆向工作区

• 顶部全局 header 仍显示“逆向工作区”。
• 页面内容区不再重复显示第二个“逆向工作区”。
• 页面内容区不再出现上方重复“当前项目：xxx”副标题。
• 项目标签行字号变大，且显示当前项目、DICOM 数量、STL 数量。

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

• DICOM 连续切片时保留当前 plane、mode、rotation 状态。
• STL 实体化程度不改变各构件的原始相对空间关系，只改变抽样密度和显示材质。
• 位姿控制作用于整体模型 group，不改变单个 STL 的相对拼装位置。

回归风险

• 高实体化程度可能提升渲染压力，需要在 UI 中保留“预览”档位。
• DICOM 连续请求可能造成响应乱序，需要请求序号保护。
• 逆向工作区删除标题后仍需保证用户知道当前处于哪个页面，依赖全局 header。

人工审核状态

用户已回复“确认方案”，按本测试方案执行验证。

执行结果

• npm run lint：通过。
• npm run build：通过；Vite 仍提示 bundle 超过 500 kB，为现有 Three.js/Recharts 依赖带来的非阻断警告。
• STL preview API 验证：
  • limit=6000：返回 5795 个抽样三角面、52155 个顶点数值。
  • limit=16000：返回 8692 个抽样三角面、78228 个顶点数值。
  • limit=36000：返回 17384 个抽样三角面、156456 个顶点数值。
• DICOM 连续切片 API 验证：slice=120~124 均返回 512x512、total=300，文件名按 121.dcm 到 125.dcm 连续变化。
• 无头 Chrome 前端验证：
  • 3D 模型页存在“模型显示、预览、标准、精细、白色实体、整体位姿、旋转 X、平移 Z、缩放”等控件。
  • WebGL 不可用场景仍生成二维预览 canvas，尺寸 1172x567。
  • 逆向工作区正文不再重复页面标题：逆向工作区 只出现 1 次。
  • 当前项目：头部 CT 模型逆向体素化演示 只出现 1 次，并保留 DICOM 300、STL 9。
• 已重新部署到 http://192.168.3.11:4000/，tmux 会话：revoxelseg-dicom。