2026-05-21-00-58-25 增加WebGL降级并更新测试文档

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

@@ -0,0 +1,63 @@
+# 测试方案-2026-05-21-00-58-25
+
+测试方案文档路径：`工程分析/测试方案-2026-05-21-00-58-25.md`
+
+## 静态检查
+
+- `cd WebSite && npm run lint`
+- 检查 TypeScript 类型、组件属性和 API 调用签名。
+
+## 构建检查
+
+- `cd WebSite && npm run build`
+- 确认 Vite 生产构建无错误。
+
+## 关键业务场景验证
+
+- 登录、总体概况、项目库三类数据页、逆向工作区、系统管理工作区可访问。
+- 项目库导入 DICOM/STL 的入口、覆盖提醒、进度/失败反馈可见。
+- 逆向分割结果视图、二维映射视图、Overlay Label Map、位置重置和切片导航布局符合当前功能。
+- 用户管理新增、编辑、改密、冲突提示和删除限制逻辑无明显异常。
+
+## 医学影像数据相关边界验证
+
+- 默认项目有 DICOM/STL 时可预览，不存在资产时给出导入提示。
+- 大体积/压缩包导入失败时主操作区保留错误，不造成浏览器无反馈。
+- 导出项目及结果响应头文件名符合“项目名_时间”语义。
+
+## 软著材料验证
+
+- 说明书每个 `## X.` 章节均有图片引用。
+- 图片文件存在且为最新重新拍摄。
+- 代码汇总 Markdown 行数不少于 1600 行。
+- 能重新生成 `.docx` 文件。
+
+## 部署验证
+
+- `http://127.0.0.1:4000/api/health`
+- `http://127.0.0.1:4000/`
+
+## Git/Gitea 备份验证
+
+- 只暂存本次代码和工程分析文档。
+- 不暂存 `新撰写软著文档/`、`3279-STL.zip`、默认医学数据或历史无关删除。
+- `git push` 成功后记录 commit。
+
+## 风险与回归关注点
+
+- 三维/WebGL 页面加载可能较慢，截图前需等待稳定。
+- 软著截图必须避免局部裁剪和敏感信息暴露。
+- 修复导入或缓存逻辑时要避免跨项目串用旧资产。
+
+## 实际执行结果
+
+- `npm run lint`：通过。
+- `npm run build`：通过，仅保留 Vite 大包体积提示。
+- `/api/health`：通过。
+- 项目列表接口：确认默认项目与用户项目可读取。
+- 临时 ZIP/STL 导入回归：创建临时项目、上传含 `tiny.stl` 的 ZIP、返回 `modelCount=1` 后删除临时项目，通过。
+- 重名用户接口回归：新增 `admin` 同名账号返回 409 与 `账号已存在`，通过。
+- 导出响应头抽查：`export-bundle?targets=stl` 返回 `filename*` 中文文件名，通过。
+- 浏览器自动化：登录、项目库、DICOM 信息、3D 模型、逆向分割结果、逆向工作区、保存、导出面板、系统管理、退出均可访问；SwiftShader WebGL 模式无 React fatal 错误。
+- WebGL 异常模式：验证三维融合视图显示降级提示，页面未崩溃。
+- 软著材料：23 个章节、23 个图片引用、23 张 `chapter-*.png` 均为 1680x1050；说明书 docx 中 23 个图片位置；代码汇总 10810 行；系统使用视频已刷新为约 48 秒 MP4。