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

工程分析/需求分析-2026-05-20-11-51-05.md

@@ -0,0 +1,53 @@
+# 需求分析：默认 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 的项目资产。
+- 保留现有目录名和文件名，避免影响后端默认扫描逻辑。