2026-05-04-05-41-22 增强3D实体预览和位姿控制

工程分析/测试方案-2026-05-04-05-41-22.md

@@ -0,0 +1,73 @@
+# 测试方案 - 2026-05-04-05-41-22
+
+## 静态检查
+
+- 执行 `npm run lint`，确认 TypeScript 类型检查通过。
+- 执行 `npm run build`，确认生产构建通过。
+
+## 集成测试
+
+- 调用 STL preview API：
+  - `limit=6000`
+  - `limit=16000`
+  - `limit=36000`
+- 确认返回顶点数量随实体化程度增加，且响应不报错。
+- 调用 DICOM preview API，确认连续请求不同 slice 时均可返回合理 `slice/total/width/height`。
+
+## 关键业务场景验证
+
+### 3D 模型页
+
+- 默认进入后模型可见。
+- 实体化程度从“预览”切换到“标准/精细”后，模型表面更连续，而不是纯点云感。
+- 开启“整体白色实体”后，显示效果接近参考图的灰白实体模型。
+- 调整旋转 X/Y/Z、平移 X/Y/Z、缩放后，模型位姿即时变化。
+- 点击重置后，位姿恢复默认。
+- 隐藏/显示单个 STL、调整颜色、透明度仍正常。
+- WebGL 不可用时二维兜底仍可见，不出现空白画布。
+
+### DICOM 切片页
+
+- 长按上箭头时，切片编号连续增加，图像连续变化。
+- 长按下箭头时，切片编号连续减少，图像连续变化。
+- 快速连续切换时，不出现旧请求覆盖新切片的错帧。
+- 到达首帧/末帧时不越界。
+
+### 逆向工作区
+
+- 顶部全局 header 仍显示“逆向工作区”。
+- 页面内容区不再重复显示第二个“逆向工作区”。
+- 页面内容区不再出现上方重复“当前项目：xxx”副标题。
+- 项目标签行字号变大，且显示当前项目、DICOM 数量、STL 数量。
+
+## 医学影像数据相关边界验证
+
+- DICOM 连续切片时保留当前 plane、mode、rotation 状态。
+- STL 实体化程度不改变各构件的原始相对空间关系，只改变抽样密度和显示材质。
+- 位姿控制作用于整体模型 group，不改变单个 STL 的相对拼装位置。
+
+## 回归风险
+
+- 高实体化程度可能提升渲染压力，需要在 UI 中保留“预览”档位。
+- DICOM 连续请求可能造成响应乱序，需要请求序号保护。
+- 逆向工作区删除标题后仍需保证用户知道当前处于哪个页面，依赖全局 header。
+
+## 人工审核状态
+
+用户已回复“确认方案”，按本测试方案执行验证。
+
+## 执行结果
+
+- `npm run lint`：通过。
+- `npm run build`：通过；Vite 仍提示 bundle 超过 500 kB，为现有 Three.js/Recharts 依赖带来的非阻断警告。
+- STL preview API 验证：
+  - `limit=6000`：返回 `5795` 个抽样三角面、`52155` 个顶点数值。
+  - `limit=16000`：返回 `8692` 个抽样三角面、`78228` 个顶点数值。
+  - `limit=36000`：返回 `17384` 个抽样三角面、`156456` 个顶点数值。
+- DICOM 连续切片 API 验证：`slice=120~124` 均返回 `512x512`、`total=300`，文件名按 `121.dcm` 到 `125.dcm` 连续变化。
+- 无头 Chrome 前端验证：
+  - 3D 模型页存在“模型显示、预览、标准、精细、白色实体、整体位姿、旋转 X、平移 Z、缩放”等控件。
+  - WebGL 不可用场景仍生成二维预览 canvas，尺寸 `1172x567`。
+  - 逆向工作区正文不再重复页面标题：`逆向工作区` 只出现 1 次。
+  - `当前项目：头部 CT 模型逆向体素化演示` 只出现 1 次，并保留 `DICOM 300`、`STL 9`。
+- 已重新部署到 `http://192.168.3.11:4000/`，tmux 会话：`revoxelseg-dicom`。