# 测试方案 - 2026-05-08-01-19-42

## 静态检查

- 执行 `npm run lint`，确认 TypeScript 类型检查通过。
- 执行 `npm run build`，确认生产构建通过。
- 执行 `git diff --check`，确认无空白错误。

## 集成验证

- `GET /api/projects/head-ct-demo` 正常返回项目与构件样式。
- `GET /api/projects/head-ct-demo/dicom-fusion-volume?start=0&end=<n>&mode=soft` 正常返回体数据。
- 本地服务重新部署后 `curl -I http://127.0.0.1:4000/` 返回 200。

## 关键业务场景验证

1. 模型库在放大或小高度场景下，右侧构件层级仍可滚动查看。
2. 左侧逆向工作区图标与模型库图标不同。
3. 逆向工作区模型位姿支持：
   - 重置旋转位姿。
   - 重置平移缩放位姿。
   - X/Y/Z ±90° 快捷旋转。
   - 非默认位姿重命名。
   - 单击最低刻度移动，长按连续移动。
4. DICOM 切片范围提供五个预存点位，并能触发缓存加载。
5. 融合视角中可看到 DICOM 边界框、模型边界框。
6. 模型旋转中心围绕 DICOM 体中心。
7. DICOM 透明度三档切换可见。
8. 模型切分开关、帧选择和切割面显示可用。

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

- 切片范围点位不超过 DICOM 总帧数。
- 切割帧范围限制在 `1~dicomCount`。
- DICOM 体数据缓存只缓存当前项目和当前模式下的数据，避免混用其他项目数据。

## 回归风险

- Three.js clipping plane 和边界框可能影响渲染性能。
- 预存五点会产生多次融合体请求，需要确认不会阻塞主界面交互。
- 模型旋转中心改为 DICOM 中心后，旧的模型位姿视觉效果会发生变化。

## 人工审核状态

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

## 执行结果

- `npm run lint`：通过。
- `npm run build`：通过，仅保留 Vite 大 chunk 体积提醒。
- `git diff --check`：通过。
- 重新部署：已通过 `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/dicom-fusion-volume?start=0&end=59&mode=soft`：正常返回 DICOM 融合体数据。
- 代码静态检索确认：
  - `重置默认位姿` 已移除。
  - `Workflow` 已用于逆向工作区侧栏图标。
  - `预存五点`、`模型切分`、`dicomOpacity`、`showBounds` 相关控制已写入逆向工作区。