REVOXELSEG_DICOM/工程分析/测试方案-2026-05-07-18-42-53.md

测试方案 - 2026-05-07-18-42-53

静态检查

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

单元或集成测试

• 使用现有 API 和页面构建流程做集成验证：
  • GET /api/projects 返回项目数据且包含共享 moduleStyles。
  • PATCH /api/projects/:projectId/module-styles 可保存构件 ID。
  • 重新读取项目后构件 ID 保持一致。

关键业务场景验证

1. 项目库 3D 模型构件层级修改 ID 后，进入逆向工作区可视化工具栏显示同一 ID。
2. 逆向工作区修改 ID 后，返回项目库 3D 模型显示同一 ID。
3. 可视化工具栏不再显示 Metadata。
4. 融合视角下方只有一个 DICOM 切片范围滑条，不再暴露起点/终点输入。
5. 位姿控制区域标题显示“模型位姿”。

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

• 切片范围滑条最小值不小于 1，最大值不超过 DICOM 总切片数。
• API 请求仍使用合理 start/end，避免空体数据。
• 构件 ID 限定为 1~255，防止与背景 0 冲突。

回归风险

• 共享 moduleStyles 可能影响已有颜色、透明度、显示隐藏控制。
• 融合体请求频繁变化可能导致加载状态更新较频繁。

人工审核状态

用户已声明本次不需要二次人工确认，按默认执行确认规则直接执行。

执行结果

• npm run lint：通过。
• npm run build：通过，仅保留 Vite 大 chunk 体积提醒。
• 重新部署：已通过 tmux 重启 revoxelseg-dicom 服务，运行在 http://0.0.0.0:4000/。
• curl -I http://127.0.0.1:4000/：返回 HTTP/1.1 200 OK。
• GET /api/projects/head-ct-demo：返回默认项目，包含 9 个 STL 构件的 moduleStyles。
• PATCH /api/projects/head-ct-demo/module-styles：可修改构件 ID 和可见性。
• 构件 ID 边界：提交 partId=0 后服务端返回 partId=1，符合不可修改为 0 的约束。