# 需求分析：默认 DICOM/STL 数据纳入 Gitea

开始时间：`2026-05-20-11-51-05`

## 原始需求摘要

用户要求将 `Head_CT_DICOM/` 与 `Head_CT_ReConstruct/` 也加入 Gitea，因为它们是系统默认项目数据，新环境构建和演示时需要直接可用。

## 业务目标

- 默认演示项目的数据资产随代码仓库一起交付。
- 新环境克隆仓库后，无需额外复制 DICOM 和 STL 目录即可加载默认项目。
- 保持当前默认项目 `head-ct-demo` 的 DICOM 300 张、STL 9 个构件完整可用。

## 输入与输出

输入：

- `Head_CT_DICOM/`：默认 DICOM 序列，当前 300 个文件，约 154M。
- `Head_CT_ReConstruct/`：默认 STL 重建模型，当前 9 个文件，约 241M。
- `.gitignore` 当前明确忽略上述两个目录。

输出：

- 调整 `.gitignore`，不再忽略默认医学数据资产。
- 新增 `.gitattributes`，将 `.dcm` 与 `.stl` 标记为二进制文件。
- 将 `Head_CT_DICOM/` 与 `Head_CT_ReConstruct/` 纳入 Git/Gitea。

## 影响范围

- 仓库体积会明显增加，新增约 395M 默认数据资产。
- 新环境部署时默认项目数据可直接扫描并载入。
- 不修改前后端业务代码。
- 不纳入 `新撰写软著文档/`、参考模板、位姿素材等软著相关本地材料。

## 关键约束

- 仅提交本次相关数据资产、ignore/attributes 配置和工程分析文档。
- 避免提交历史工程分析文档删除状态和无关未跟踪文件。
- DICOM/STL 为二进制资产，应避免 Git 文本 diff。
- 推送前需确认 Gitea 能接受较大体积提交。

## 风险点

- 仓库体积增加后，首次 clone/pull 时间会变长。
- 若远端 Gitea 对单文件或仓库包大小有限制，push 可能失败。
- DICOM 数据属于医学影像数据，后续正式生产数据入库前必须确认脱敏和授权；本次按用户说明作为默认演示项目纳入。

## 默认假设

- 用户已明确要求将两个默认数据目录加入 Gitea，本次不改用外部对象存储或 Git LFS。
- 当前默认演示数据是允许进入内部 Gitea 的项目资产。
- 保留现有目录名和文件名，避免影响后端默认扫描逻辑。