# 测试方案：默认 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`。
- Git/Gitea：数据入库 commit `9611695 2026-05-20-11-51-05 默认医学数据入库` 已成功推送到 `origin/main`，新增 pack 写入约 190.05 MiB。
- 重新部署：已重启 `tmux` 会话 `revoxelseg-dicom`，服务输出 `ReVoxelSeg DICOM server ready at http://0.0.0.0:4000/`。
- 部署后复验：`/api/health` 正常，首页返回 `HTTP/1.1 200 OK`，默认项目仍返回 `dicomCount=300`、`modelCount=9`、`stlFiles=9`。