REVOXELSEG_DICOM/工程分析/测试方案-2026-05-20-15-54-46.md

# 测试方案：逆向工作区布局、缩放平移、复位与拉伸验证

测试方案文档路径：`工程分析/测试方案-2026-05-20-15-54-46.md`

## 静态检查

- 确认 `DICOM 切片位置` 为白底外置控件，并位于二维影像右侧。
- 确认 `Base DICOM` / `Overlay Label Map` 不再作为深色大块控件压在影像内部。
- 确认 `VoxelizationMappingView` 支持 zoom/pan 状态和位置重置。
- 确认 `FusionThreeView` 支持视图复位 token。
- 确认三维拉伸按钮仅在 XYZ 旋转均为 90 度倍数时启用。
- 确认主布局右侧视图宽度提升，三列底部更接近对齐。

## 构建检查

- 在 `WebSite/` 执行 `npm run lint`。
- 在 `WebSite/` 执行 `npm run build`。

## 关键业务场景验证

- 右侧二维影像可滚轮缩放。
- 右侧二维影像可鼠标拖拽平移。
- 点击“位置重置”后二维影像恢复居中、1 倍缩放。
- 点击三维融合视图复位按钮后相机恢复默认视角。
- 旋转角度不是 90 度倍数时，拉伸按钮不可用。
- 旋转角度满足 90 度倍数时，可触发 X/Y/Z 方向等比例拉伸并更新模型 scale。

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

- 不修改 DICOM/STL 原始数据。
- 不改变切片映射算法和导出接口。
- 二维缩放和平移只影响浏览显示，不改变 Label Map 坐标。
- 手动拉伸属于位姿参数调整，保存/导出沿用当前位姿。

## 部署验证

- 验证 `http://127.0.0.1:4000/api/health`。
- 验证 `http://127.0.0.1:4000/` 返回 200。

## Git/Gitea 备份验证

- commit message 包含 `2026-05-20-15-54-46`。
- 推送 Gitea 成功后记录 commit。
- 确认未暂存历史删除状态、软著材料和运行态文件。

## 风险与回归关注点

- 右侧控件白底化后要保持与深色影像区边界清晰。
- CSS transform 顺序需要同时覆盖 Base DICOM 与 Overlay，避免错位。
- Three.js 复位不能打断现有 OrbitControls。
- 当前实现为等比例 `scale` 调整，不提供非等比轴向拉伸。

## 执行结果

- `npm run lint`：通过，TypeScript 无报错。
- `npm run build`：通过，Vite 完成生产构建；仅保留当前项目已有的大 chunk 体积提示。
- 静态确认：右侧 `DICOM 切片位置` 已改为白底外置卡片，`Overlay Label Map` 状态与构件列表已位于影像外部。
- 静态确认：`VoxelizationMappingView` 已加入滚轮缩放、鼠标拖拽平移和 `位置重置`。
- 静态确认：`FusionThreeView` 已加入 `位置重置`，三维模型默认 Z 偏移已取消。
- 静态确认：主布局改为左窄、中等、右宽的三列比例，并用 `flex-1` 包裹三维/二维视图以改善底部对齐。
- 静态确认：已加入 X/Y/Z 等比例自动拉伸按钮，旋转 X/Y/Z 均为 90° 整数倍且数据加载完成时可用。
- 部署验证：已重建 `tmux` 会话 `revoxelseg-dicom`，执行 `npm run serve -- --host 0.0.0.0 --port 4000`。
- `curl -fsS http://127.0.0.1:4000/api/health`：通过，返回 `{"ok":true,"service":"revoxelseg-dicom",...}`。
- `curl -I -fsS http://127.0.0.1:4000/`：通过，返回 `HTTP/1.1 200 OK`。