2026-05-21-14-35-20 合并Docker部署Release记录

工程分析/需求分析-2026-05-21-14-35-20.md

@@ -0,0 +1,56 @@
+# 需求分析：合并 Docker 三版本 Gitea Release
+
+开始时间：2026-05-21-14-35-20
+
+## 原始需求摘要
+
+用户认为当前在 Gitea 中分别发布“机器直接部署版本”“NAS 直接部署版本”“通用版本”三个 Release 过于杂乱，希望将三个发布合并成一个 Release，同时通过附件名称区分不同部署包。
+
+## 业务目标
+
+- Gitea Releases 页面只保留一个面向 Docker 部署的整合发布项。
+- 整合发布项内包含三个部署附件：本机直接部署版、威联通 NAS 直接部署版、通用版。
+- 三个附件通过文件名清晰区分部署场景。
+- 保留已有 tag/分支作为源码锚点，降低回滚和追溯风险。
+
+## 输入与输出
+
+输入：
+
+- 独立 Docker 程序仓库：`/home/wkmgc/Desktop/ReVoxelSeg_DICOM_Docker`
+- 现有三个发布 tag：
+  - `revoxelseg-docker-machine-v2026.05.21`
+  - `revoxelseg-docker-nas-v2026.05.21`
+  - `revoxelseg-docker-generic-v2026.05.21`
+- Gitea 仓库：`admin/REVOXELSEG_DICOM`
+
+输出：
+
+- 一个新的整合 Release。
+- 三个独立命名的 `.tar.gz` 附件。
+- 删除旧的三个分散 Release 记录。
+- 本次工程分析文档与经验记录备份 commit。
+
+## 影响范围
+
+- Gitea Release 展示与附件组织方式。
+- 独立 Docker 仓库 tag 与发布附件，不改业务代码。
+- 主工程 `工程分析/` 文档。
+
+## 关键约束
+
+- 不把 `工程分析/`、软著材料等非部署内容放入 Docker 发布附件。
+- 通用版附件不得包含当前环境固定 FRPC 地址、token、端口、域名等信息。
+- 不提交或回滚工作区内与本次无关的历史删除、未跟踪医学数据、软著目录。
+- 发布整理完成后继续验证本机 `4000` 服务和公网域名可访问。
+
+## 风险点
+
+- 大体积附件上传失败或上传不完整。
+- 删除旧 Release 前若新 Release 未成功上传附件，会导致页面暂时缺少可下载包。
+- Gitea API 失败时需要保留旧 Release，避免发布物丢失。
+
+## 默认假设
+
+- 用户要求“合并成一个发布”指删除三个旧 Release 页面记录，但保留对应 tag/分支用于追溯。
+- 一个整合 Release 的 tag 使用 `revoxelseg-docker-all-v2026.05.21`。