# 测试方案-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 监听要在组件卸载时清理，防止重复绑定。