2026-05-21-00-43-44 修复ZIP STL导入反馈

工程分析/测试方案-2026-05-21-00-43-44.md

@@ -0,0 +1,51 @@
+# 测试方案-2026-05-21-00-43-44
+
+## 测试方案文档路径
+
+`工程分析/测试方案-2026-05-21-00-43-44.md`
+
+## 静态检查
+
+- 执行 `cd WebSite && npm run lint`，确认 TypeScript 类型检查通过。
+- 使用 `rg` 检查导入错误反馈和 ZIP 处理路径。
+
+执行结果：`npm run lint` 已通过。
+
+## 构建检查
+
+- 执行 `cd WebSite && npm run build`，确认生产构建通过。
+
+执行结果：`npm run build` 已通过；Vite 仅提示既有 chunk 体积超过 500 kB。
+
+## 关键业务场景验证
+
+- 使用 `3279-STL.zip` 调用项目导入接口，确认返回 200 且 `modelCount` 与 ZIP 内 STL 数量一致。
+- 前端导入失败时顶部进度区域显示失败状态和错误原因。
+- 前端导入成功时顶部进度区域显示完成状态。
+
+执行结果：使用 `3279-STL.zip` 对项目 `project-mpea0n3e-akbpn` 导入成功，接口返回 200，`modelCount: 26`，`stlFiles` 已包含 ZIP 内 26 个 STL。
+
+## 医学影像数据相关边界验证
+
+- ZIP 中所有 `.stl` 文件写入项目级 `WebSite/data/uploads/<projectId>/STL`。
+- 导入后 `project.stlFiles` 包含 ZIP 内模型文件名。
+- 导入失败不会污染默认 `Head_CT_ReConstruct/`。
+- 临时测试项目和上传目录验证后清理。
+
+## 部署验证
+
+- 重启 `tmux` 会话 `revoxelseg-dicom`。
+- 验证：
+  - `curl http://127.0.0.1:4000/api/health`
+  - `curl -I http://127.0.0.1:4000/`
+
+## Git/Gitea 备份验证
+
+- `git status --short` 确认暂存范围不包含 `3279-STL.zip`、解压模型或无关历史删除。
+- commit message 包含 `2026-05-21-00-43-44`。
+- 推送 Gitea 成功。
+
+## 风险与回归关注点
+
+- ZIP 内大型 STL 不应同时全部进入内存。
+- 前端错误信息不能只显示在左侧项目栏底部，应在导入进度卡上直接可见。