2026-05-07-18-11-12 增加模型库和可视化工具栏

工程分析/测试方案-2026-05-07-18-11-12.md

@@ -0,0 +1,51 @@
+# 测试方案 - 2026-05-07-18-11-12
+
+## 静态检查
+
+1. `git status --short --branch`
+2. `cd WebSite && npm run build`
+3. `cd WebSite && npm run lint`
+
+## 单元或集成测试
+
+当前项目没有独立单元测试体系，本次采用构建、类型检查、API 冒烟和页面运行验证。
+
+## 关键业务场景验证
+
+1. 左侧导航显示 `模型库`。
+2. 点击 `模型库` 默认进入项目库 3D 模型页。
+3. 项目库构件层级：
+   - 点击单个构件眼睛，模型可隐藏/显示。
+   - 顶部眼睛可全隐藏/全显示。
+   - 每个构件显示 `ID`。
+   - ID 可修改为 1 到 255。
+   - ID 修改为 0 时应被限制为 1。
+4. 逆向工作区：
+   - `分割 Mask` 文案变为 `可视化工具栏`。
+   - 工具栏包含模型显示、整体位姿保存/选择、构件层级。
+   - 模型显示档位切换后场景仍可加载。
+   - 保存位姿后可在选择框中切回。
+   - 构件眼睛、颜色、透明度可影响融合视角中的模型显示。
+
+## 医学影像数据相关边界验证
+
+- 本次不修改 DICOM 解析和融合体接口。
+- 回归确认 `/api/projects` 和 `/api/projects/head-ct-demo/dicom-fusion-volume` 可访问。
+
+## 回归风险
+
+- 逆向工作区模型样式状态变化会触发 Three.js 重建，可能带来短暂加载。
+- 左侧新增导航项可能影响当前 header 文案和 activeView 判断。
+- 项目库构件 ID 目前未持久化，刷新页面后回到默认 1 到 N。
+
+## 人工审核状态
+
+- 本次免二次确认。
+
+## 执行记录
+
+- `npm run lint`：通过，实际执行 `tsc --noEmit`。
+- `npm run build`：通过。
+- 重新部署后 `curl -I http://127.0.0.1:4000/`：返回 `HTTP/1.1 200 OK`。
+- `GET /api/projects`：正常返回默认项目，包含 9 个 STL 文件。
+- `GET /api/projects/head-ct-demo/dicom-fusion-volume?start=0&end=10&mode=soft`：正常返回 DICOM 融合体数据。