2026-05-20-12-09-47 完善软著逐章配图与系统视频

工程分析/测试方案-2026-05-20-12-09-47.md

@@ -0,0 +1,67 @@
+# 测试方案：章节配图与系统使用视频验证
+
+测试方案文档路径：`工程分析/测试方案-2026-05-20-12-09-47.md`
+
+## 静态检查
+
+- 统计 `新撰写软著文档/1. 软著说明书.md` 中 `## X.` 章节数量。
+- 检查每个 `## X.` 章节内均有至少一个 Markdown 图片引用。
+- 检查所有图片引用文件存在。
+- 检查无 `[插入图片]` 占位符残留。
+- 检查 `新撰写软著文档/系统使用视频/系统使用视频.mp4` 存在且大小不为 0。
+- 使用 `ffprobe` 或 `ffmpeg` 检查视频时长与编码信息。
+
+## 构建检查
+
+- 在 `WebSite/` 执行 `npm run build`。
+
+## 关键业务场景验证
+
+- 截图覆盖登录、总体概况、项目库、DICOM 浏览、DICOM 信息、STL 模型、构件层级、分割结果、逆向工作区、融合视角、可视化工具栏、位姿导入、映射视图、保存结果、导出选项、系统管理和退出。
+- 视频覆盖从登录到项目浏览、进入逆向工作区、导入 `head-ct-demo-pose-data.json`、查看映射视图和打开导出选项。
+
+## 医学影像数据相关边界验证
+
+- 视频和截图使用默认演示项目，不执行破坏性数据操作。
+- 位姿导入使用指定 JSON 文件并确认界面出现导入成功状态。
+- 逆向工作区截图与视频使用软件 WebGL 兜底，避免三维视图空白。
+
+## Word 与素材验证
+
+- 重新生成 `1. 软著说明书.docx`。
+- 使用 `unzip -t` 验证 Word 完整性。
+- 使用 `unzip -l` 检查 Word 内嵌图片数量不少于章节数。
+- 更新 `功能验证与素材清单.md`。
+
+## 部署验证
+
+- 验证 `http://127.0.0.1:4000/api/health`。
+- 验证 `http://127.0.0.1:4000/` 返回 200。
+- 重新部署后复验服务。
+
+## Git/Gitea 备份验证
+
+- commit message 包含 `2026-05-20-12-09-47`。
+- 推送 Gitea 成功后记录 commit。
+- 确认 `新撰写软著文档/` 未被暂存或提交。
+
+## 风险与回归关注点
+
+- 不把视频、截图和软著 Word 纳入 Gitea。
+- 不提交 `head-ct-demo-pose-data.json`。
+- 不处理已有历史工程分析文档删除状态。
+
+## 实际验证记录
+
+- 说明书章节检查：`新撰写软著文档/1. 软著说明书.md` 中共有 23 个 `## X.` 章节。
+- 图片覆盖检查：23 个章节均已配置图片引用，引用文件全部存在；`新撰写软著文档/images/` 中共有 23 张 `chapter-*.png` 章节图。
+- 占位与技术痕迹检查：未发现 `[插入图片]`、接口、路由、payload、state、useState、useEffect、组件、函数等不适合软著说明书正文的残留表达。
+- DICOM 信息截图处理：`chapter-09-dicom-info.png` 中患者姓名与患者编号显示区域已遮盖脱敏。
+- 视频文件检查：`新撰写软著文档/系统使用视频/系统使用视频.mp4` 为 H.264，1280x800，276 帧，时长 46.000000 秒，大小 826695 字节。
+- 位姿导入检查：第 16 章截图与视频素材使用 `head-ct-demo-pose-data.json`，界面显示“位姿数据已导入并保存”。
+- Word 完整性检查：`unzip -t 新撰写软著文档/1. 软著说明书.docx` 通过。
+- Word 图片嵌入检查：`unzip -l 新撰写软著文档/1. 软著说明书.docx | rg word/media | wc -l` 返回 23。
+- 素材清单检查：`新撰写软著文档/功能验证与素材清单.md` 已更新 23 张章节截图、视频文件、位姿来源和脱敏说明。
+- 构建检查：`WebSite/ npm run build` 通过，Vite 仅提示 chunk size warning。
+- 重新部署检查：已重启 `tmux` 会话 `revoxelseg-dicom`，服务日志显示 `ReVoxelSeg DICOM server ready at http://0.0.0.0:4000/`。
+- 服务检查：`http://127.0.0.1:4000/api/health` 返回 200，`http://127.0.0.1:4000/` 返回 200。