# 测试方案：软著说明书截图与代码汇总行数检查

测试方案文档路径：`工程分析/测试方案-2026-05-20-11-34-57.md`

## 静态检查

- 使用 `wc -l` 检查 `新撰写软著文档/3. 代码汇总.md` 行数不少于 1600。
- 检查 `新撰写软著文档/1. 软著说明书.md` 中图片引用均指向实际存在文件。
- 检查说明书文字不出现明显开发黑话，如接口、路由、payload、state 等。
- 检查 `git status`，确认软著目录未暂存。

## 构建检查

- 如本次未修改代码，仍运行 `npm run build` 确认当前项目可正常构建。

## 关键业务场景验证

- 截图覆盖登录、首页概况、项目库、DICOM 查看、逆向工作区、构件与位姿配置、逆向分割映射、系统管理等主要界面。
- 说明书章节覆盖账号创建/登录、核心管理界面、数据查看、导入导出、保存结果、系统管理和退出。

## 医学影像数据相关边界验证

- 说明书中对 DICOM、STL、NIfTI、逆向分割映射等能力按用户可见操作描述。
- 代码汇总中包含 DICOM/STL 解析预览、NIfTI/导出包、模型位姿、项目库、逆向工作区等核心逻辑片段。

## Word 与素材验证

- 使用 `unzip -t` 验证更新后的 `1. 软著说明书.docx` 和 `3. 代码汇总.docx`。
- 确认说明书 Word 中嵌入图片，而不是仅保留 Markdown 文本链接。
- 更新 `功能验证与素材清单.md`，记录截图文件及对应功能。

## 部署验证

- 验证 `http://127.0.0.1:4000/api/health`。
- 验证 `http://127.0.0.1:4000/` 返回 200。

## Git/Gitea 备份验证

- 本次工程分析文档 commit message 包含 `2026-05-20-11-34-57`。
- 推送 Gitea 成功后记录 commit。
- 确认软著材料目录没有进入 commit。

## 风险与回归关注点

- 截图可能包含演示账号与项目名，保持为演示环境信息。
- 不提交软著材料，避免与用户“软著撰写相关内容不需要放到 Gitea”的要求冲突。
- 不处理已有历史文档删除状态。

## 实际验证记录

- 说明书已扩写：`新撰写软著文档/1. 软著说明书.md` 从 109 行扩展到 161 行，功能说明覆盖 23 个章节。
- 真实截图已生成：`新撰写软著文档/images/` 下共有 8 张 PNG，尺寸均为 `1680 x 1050`。
- 说明书图片引用检查：8 个 Markdown 图片引用全部存在，无 `[插入图片]` 占位符残留。
- 说明书开发黑话检查：未命中 `接口`、`路由`、`payload`、`state`、`useState`、`useEffect`、`组件`、`函数` 等词。
- 逆向工作区截图处理：首次普通 headless Chrome 截图因 WebGL 上下文创建失败为空白，已改用软件 WebGL 模式重新截图，最终 `06-reverse-workspace.png` 和 `07-reverse-export-options.png` 正常显示。
- 代码汇总行数：`新撰写软著文档/3. 代码汇总.md` 为 8116 行，满足不少于 1600 行要求。
- Word 生成：已重新生成 `1. 软著说明书.docx` 与 `3. 代码汇总.docx`。
- Word 完整性：`unzip -t` 校验 `1. 软著说明书.docx` 与 `3. 代码汇总.docx` 均通过。
- Word 图片嵌入：`1. 软著说明书.docx` 中存在 `word/media/image1.png` 至 `word/media/image8.png`，确认图片已嵌入 Word。
- 构建检查：`npm run build` 通过；仍有 Vite 单 chunk 大小提示，不影响本次文档需求。
- 空白检查：`git diff --check` 通过。
- 服务检查：`http://127.0.0.1:4000/api/health` 返回正常，首页 `http://127.0.0.1:4000/` 返回 `HTTP/1.1 200 OK`。
- Git 暂存检查：软著目录 `新撰写软著文档/` 保持未暂存，不纳入 Gitea。