2026-05-20-23-28-51 项目库映射交互与导入提示优化

工程分析/测试方案-2026-05-20-23-28-51.md

@@ -0,0 +1,54 @@
+# 测试方案-2026-05-20-23-28-51
+
+## 测试方案文档路径
+
+`工程分析/测试方案-2026-05-20-23-28-51.md`
+
+## 静态检查
+
+- 执行 `cd WebSite && npm run lint`，确保 TypeScript 类型检查通过。
+- 使用 `rg` 检查项目库是否仍残留不需要的黑色 side Overlay 面板调用。
+
+执行结果：`npm run lint` 已通过；项目库当前使用 `overlayPlacement="none"` 外置 Overlay 摘要。
+
+## 构建检查
+
+- 执行 `cd WebSite && npm run build`，确认生产构建通过。
+
+执行结果：`npm run build` 已通过；Vite 仅提示既有 chunk 体积超过 500 kB。
+
+## 关键业务场景验证
+
+- 逆向工作区位姿平移 Z 的 `-` 首次点击不再造成工具栏滚动条上跳。
+- 项目库和逆向工作区竖向 Slice Navigator 圆形滑块居中在轨道上。
+- 项目库逆向分割结果页顶部可点击“导出项目及结果”，菜单不被下方边界裁切。
+- 项目库 Overlay Label Map 显示在导出按钮下方，使用浅色信息格风格。
+- “逆向分割结果”标题与 `已保存` 状态同一行展示。
+- 项目已有 DICOM/STL 时点击导入会提示覆盖风险。
+
+## 医学影像数据相关边界验证
+
+- 导入 DICOM 后上传目录生成 DICOM 信息缓存。
+- `/api/projects/:projectId/dicom-info` 对上传项目优先返回缓存内容。
+- 覆盖导入仍只写入 `WebSite/data/uploads/<projectId>/...`，不影响 `Head_CT_DICOM/` 和 `Head_CT_ReConstruct/`。
+
+## 部署验证
+
+- 重启 tmux 会话 `revoxelseg-dicom`：
+  - `cd WebSite`
+  - `npm run serve -- --host 0.0.0.0 --port 4000`
+- 验证：
+  - `curl http://127.0.0.1:4000/api/health`
+  - `curl -I http://127.0.0.1:4000/`
+
+## Git/Gitea 备份验证
+
+- `git status --short` 确认暂存范围不包含无关历史删除或软著材料。
+- commit message 包含 `2026-05-20-23-28-51`。
+- `git push origin main` 成功。
+
+## 风险与回归关注点
+
+- Overlay 外置后仍要随切片、构件显示、颜色、透明度实时变化。
+- 位姿按钮防滚动跳动不能破坏长按连续微调。
+- DICOM 信息缓存不能在项目覆盖导入后返回旧内容。