2026-05-20-11-51-05 默认医学数据入库

工程分析/测试方案-2026-05-20-11-51-05.md

@@ -0,0 +1,61 @@
+# 测试方案：默认 DICOM/STL 数据入库验证
+
+测试方案文档路径：`工程分析/测试方案-2026-05-20-11-51-05.md`
+
+## 静态检查
+
+- 使用 `du -sh Head_CT_DICOM Head_CT_ReConstruct` 记录目录体积。
+- 使用 `find Head_CT_DICOM -type f | wc -l` 确认 DICOM 文件数。
+- 使用 `find Head_CT_ReConstruct -type f | wc -l` 确认 STL 文件数。
+- 使用 `git check-ignore` 确认两个目录不再被 `.gitignore` 忽略。
+- 使用 `git diff --check` 确认文本配置和文档无空白错误。
+- 使用 `git diff --cached --name-status` 检查暂存内容不包含软著材料和无关历史删除。
+
+## 构建检查
+
+- 在 `WebSite/` 执行 `npm run build`，确认项目仍可构建。
+
+## 关键业务场景验证
+
+- 重新部署后访问 `http://127.0.0.1:4000/api/projects/head-ct-demo`。
+- 验证默认项目返回：
+  - `dicomCount = 300`
+  - `modelCount = 9`
+  - `dicomPath = Head_CT_DICOM`
+  - `modelPath = Head_CT_ReConstruct`
+- 验证 `/api/health` 正常。
+- 验证首页返回 200。
+
+## 医学影像数据相关边界验证
+
+- DICOM/STL 文件作为二进制资产纳入 Git，避免文本 diff。
+- 不修改文件名和目录结构，避免破坏后端默认扫描。
+- 记录新增数据资产约 395M，提示 clone/pull 时间增加。
+
+## 部署验证
+
+- 使用 `tmux` 会话 `revoxelseg-dicom` 重新启动服务。
+- 查看 `tmux capture-pane` 确认服务监听 `http://0.0.0.0:4000/`。
+
+## Git/Gitea 备份验证
+
+- commit message 包含 `2026-05-20-11-51-05`。
+- 推送到 Gitea 成功后记录 commit。
+- 若 push 失败，记录远端错误和本地 commit 状态。
+
+## 风险与回归关注点
+
+- 本次会显著增大仓库体积。
+- 不把 `新撰写软著文档/`、`参考软著构建模板/`、`head-ct-demo-pose-data.json` 混入提交。
+- 不处理已有历史 `工程分析/*2026-05-04/05-08*` 删除状态。
+
+## 实际验证记录
+
+- 数据体积：`Head_CT_DICOM` 约 154M，`Head_CT_ReConstruct` 约 241M，合计约 395M。
+- 文件数量：`Head_CT_DICOM` 为 300 个文件，`Head_CT_ReConstruct` 为 9 个文件。
+- 忽略规则：移除 `.gitignore` 中 `Head_CT_DICOM/` 与 `Head_CT_ReConstruct/` 忽略规则后，`git check-ignore` 对示例 DICOM/STL 无命中。
+- 二进制属性：新增 `.gitattributes`，配置 `*.dcm binary` 与 `*.stl binary`。
+- 构建检查：`npm run build` 通过；仍有 Vite 单 chunk 大小提示，不影响本次数据入库。
+- 空白检查：`git diff --check` 通过。
+- 服务检查：`http://127.0.0.1:4000/api/health` 返回正常，首页返回 `HTTP/1.1 200 OK`。
+- 默认项目接口：`/api/projects/head-ct-demo` 返回 `dicomCount=300`、`modelCount=9`、`dicomPath=Head_CT_DICOM`、`modelPath=Head_CT_ReConstruct`、`stlFiles=9`。