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