# 测试方案-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 不应同时全部进入内存。
- 前端错误信息不能只显示在左侧项目栏底部，应在导入进度卡上直接可见。