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

工程分析/实现方案-2026-05-20-11-51-05.md

@@ -0,0 +1,60 @@
+# 实现方案：默认医学数据资产入库
+
+实现方案文档路径：`工程分析/实现方案-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`。