2026-05-20-00-19-47 同步位姿并填充实体映射

工程分析/测试方案-2026-05-20-00-19-47.md

@@ -0,0 +1,59 @@
+# 测试方案-2026-05-20-00-19-47
+
+## 测试方案文档路径
+
+`工程分析/测试方案-2026-05-20-00-19-47.md`
+
+## 静态检查
+
+- 在 `WebSite/` 下执行 `npm run lint`。
+
+## 构建检查
+
+- 在 `WebSite/` 下执行 `npm run build`。
+
+## 关键业务场景验证
+
+- 打开逆向工作区，确认右侧仍为“逆向分割映射视图”。
+- 拖动中部模型位姿的 X/Y/Z 平移滑条，右侧 Overlay 位置即时变化。
+- 拖动 X/Y/Z 旋转滑条，右侧 Overlay 截面形态即时变化。
+- 拖动缩放滑条，右侧 Overlay 大小即时变化。
+- 右侧 Overlay 应显示连续实心色块，而不是零散表面三角面/点云。
+- 调整构件颜色、透明度、显示隐藏后，右侧实心 Mask 即时联动。
+- 拖动右侧 Slice Navigator，DICOM Base Layer 与实心 Mask 共同切换。
+
+## 医学影像数据相关边界验证
+
+- STL preview 不可用时，Base Layer 仍显示 DICOM。
+- 构件交线无法闭合时，不应导致页面报错。
+- 切片序号需要 clamp 到合法范围。
+- 位姿拖动时不应重新请求 STL preview，只应重绘 Overlay。
+
+## 部署验证
+
+- 重启 `tmux` 会话 `revoxelseg-dicom`。
+- 验证：
+  - `curl http://127.0.0.1:4000/api/health`
+  - `curl -I http://127.0.0.1:4000/`
+
+## Git/Gitea 备份验证
+
+- 显式暂存本次相关代码和文档。
+- 创建包含时间戳和描述的 commit。
+- 推送到 Gitea `origin/main`。
+
+## 回归关注点
+
+- 不影响左侧三维融合视图。
+- 不影响中部构件层级保存。
+- 不影响 `.nii` / `.nii.gz` 导出按钮。
+
+## 实际执行结果
+
+- `npm run lint`：通过。
+- `npm run build`：通过；Vite 保留既有 chunk 体积提示，不影响构建产物生成。
+- 部署：已重启 `tmux` 会话 `revoxelseg-dicom`，服务日志显示 `ReVoxelSeg DICOM server ready at http://0.0.0.0:4000/`。
+- `curl http://127.0.0.1:4000/api/health`：通过，返回 `{"ok":true,"service":"revoxelseg-dicom"}`。
+- `curl -I http://127.0.0.1:4000/`：通过，返回 `HTTP/1.1 200 OK`。
+- `curl http://127.0.0.1:4000/api/projects/head-ct-demo`：通过，确认示例项目含 300 张 DICOM 与 9 个 STL 构件。
+- `curl` 验证 DICOM preview 与 STL preview 接口：通过，右侧 Base/Overlay 所需数据可正常返回。