# 实现方案：默认医学数据资产入库

实现方案文档路径：`工程分析/实现方案-2026-05-20-11-51-05.md`

## 修改目标

将默认项目依赖的 `Head_CT_DICOM/` 和 `Head_CT_ReConstruct/` 纳入 Git/Gitea，使新环境克隆仓库后能够直接加载默认演示项目。

## 涉及路径

- `.gitignore`
- `.gitattributes`
- `Head_CT_DICOM/`
- `Head_CT_ReConstruct/`
- `工程分析/需求分析-2026-05-20-11-51-05.md`
- `工程分析/实现方案-2026-05-20-11-51-05.md`
- `工程分析/测试方案-2026-05-20-11-51-05.md`
- `工程分析/经验记录.md`

## 技术路线

1. 统计两个默认数据目录的文件数量与体积，记录入测试方案。
2. 调整 `.gitignore`，移除 `Head_CT_DICOM/` 和 `Head_CT_ReConstruct/` 的忽略规则。
3. 新增 `.gitattributes`，将 `*.dcm` 和 `*.stl` 作为二进制文件处理。
4. 使用 `git add` 精确暂存默认数据目录、配置文件和本次工程分析文档。
5. 检查暂存内容，确认不包含软著材料、历史删除状态或无关文件。
6. 提交并推送到 Gitea。
7. 构建并重新部署项目，验证默认项目接口返回 DICOM/STL 数量正常。

## 执行步骤

- 读取 `工程分析/经验记录.md` 后执行最终修改。
- 使用 `du`、`find`、`git status` 检查数据目录状态。
- 修改 `.gitignore` 与 `.gitattributes`。
- 运行 `npm run build`。
- 验证 `/api/health`、首页和 `/api/projects/head-ct-demo`。
- 精确提交并推送。
- 重启 `tmux` 会话 `revoxelseg-dicom`。

## 兼容性与回滚方案

- 目录名保持不变，后端默认项目扫描逻辑无需修改。
- 回滚时可恢复 `.gitignore` 忽略规则，并从 Git 历史中移除或停止跟踪默认数据；但历史大文件仍会存在于旧提交中。
- 若 Gitea push 因大小限制失败，应保留本地 commit 并记录失败原因，再考虑 Git LFS、压缩包发布或对象存储。

## 预计文件变更

- 修改 `.gitignore`。
- 新增 `.gitattributes`。
- 新增 300 个 DICOM 文件。
- 新增 9 个 STL 文件。
- 新增本次工程分析三份文档。
- 追加 `工程分析/经验记录.md`。

## 提交与部署策略

- commit message 包含 `2026-05-20-11-51-05` 和“默认医学数据入库”描述。
- 推送默认远端 `origin/main`。
- 软著相关目录 `新撰写软著文档/` 不暂存、不提交。
- 部署优先使用 `tmux` 会话 `revoxelseg-dicom` 与 `npm run serve -- --host 0.0.0.0 --port 4000`。