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

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