REVOXELSEG_DICOM/工程分析/测试方案-2026-05-24-17-29-17.md

测试方案-2026-05-24-17-29-17

测试方案文档路径

工程分析/测试方案-2026-05-24-17-29-17.md

静态检查

• 执行 cd WebSite && npm run lint，确认 TypeScript 类型检查通过。
• 搜索 preventDefault 相关调用，确认需要阻止页面滚动的场景使用非被动原生 wheel 监听，不再在 passive-prone touch/wheel 合成事件中调用。

构建检查

• 执行 cd WebSite && npm run build。
• 确认 Vite 生产构建成功，前端 bundle 可生成。

关键业务场景验证

• 逆向工作区切换构件层级可见性时，映射视图区出现加载进度条，完成后显示当前可见构件 overlay。
• 项目库 DICOM 影像保留滚轮缩放、拖拽移动、左转、右转和位置重置能力。
• 逆向分割映射视图保留滚轮缩放、拖拽移动和位置重置能力。

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

• 构件隐藏到 0 个可见项时不显示加载进度，并提示当前没有可见 STL 构件。
• 大 STL 构件加载过程中不能用旧预览覆盖新可见状态。
• 本次不改动 DICOM/STL 原始数据和 NIfTI 导出算法，仅验证显示反馈不影响已有流程。

部署验证

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

Git/Gitea 备份验证

• 仅暂存本次相关前端、Docker 文档和工程分析文件。
• 提交 message 包含 2026-05-24-17-29-17。
• 推送到 Gitea main 后检查本地分支与远端同步。

风险与回归关注点

• 浏览器控制台仍可能有第三方库内部 passive 事件提示，需要通过源码搜索和实际交互继续定位。
• 加载进度 UI 不能遮挡核心 DICOM 区域或造成布局跳动。
• 原生 wheel 监听要在组件卸载时清理，防止重复绑定。