2026-05-21-14-19-12 记录Docker三版本Release发布

工程分析/需求分析-2026-05-21-14-19-12.md

@@ -0,0 +1,62 @@
+# 需求分析：Gitea Releases 发布三种 Docker 部署版本
+
+开始时间：2026-05-21-14-19-12
+
+## 原始需求摘要
+
+用户要求在 `https://gitea.huijutec.cn/admin/REVOXELSEG_DICOM/releases` 发布三个版本：
+
+- 机器直接部署版本。
+- NAS 直接部署版本。
+- 通用版本，删除其中具体的 FRPC 反向代理地址、token、端口和域名信息，使其适配其他需求和环境。
+
+## 业务目标
+
+让使用者可以直接从 Gitea Release 页面下载对应部署版本，分别用于当前本机、威联通 NAS 和通用 Docker 环境部署，减少手动挑选 Compose 文件和替换敏感配置的操作。
+
+## 输入与输出
+
+输入：
+
+- 独立 Docker 程序包目录：`~/Desktop/ReVoxelSeg_DICOM_Docker`。
+- 已推送 Gitea 分支：`docker-standalone-20260521`。
+- 当前机器版和 NAS 版 Compose 配置。
+
+输出：
+
+- Gitea Release：机器直接部署版本。
+- Gitea Release：NAS 直接部署版本。
+- Gitea Release：通用版本。
+- 对应 Git tag 与 release 分支。
+- 工程分析记录和经验记录。
+
+## 影响范围
+
+- 独立 Docker 程序包仓库会新增发布分支和 tag。
+- Gitea Releases 页面新增三个 Release。
+- 主项目仅提交本次工程分析文档。
+
+## 关键约束
+
+- 三个 Release 下载后的根目录都应有 `docker_compose.yaml`。
+- 机器版保留当前本机和 FRPC 具体配置。
+- NAS 版使用 NAS/QTS 绝对路径和当前 FRPC 具体配置。
+- 通用版不能包含具体 FRPC 服务地址、token、远端端口和域名，应使用 `.env.example` 和环境变量占位。
+- 不重复提交软著材料、工程分析目录到独立 Docker 版本中。
+
+## 风险点
+
+- Gitea Release 依赖 tag；若 tag 重名需先检查并避免覆盖已有发布。
+- Gitea 自动源码包包含完整默认 DICOM/STL 数据，下载体积较大。
+- 通用版移除具体 FRPC 配置后，用户必须自行填写 `.env` 或修改 Compose 才能启用公网映射。
+
+## 默认假设
+
+- 使用三个 tag：
+  - `revoxelseg-docker-machine-v2026.05.21`
+  - `revoxelseg-docker-nas-v2026.05.21`
+  - `revoxelseg-docker-generic-v2026.05.21`
+- 为避免 Release 之间源码结构混淆，分别创建轻量发布分支：
+  - `release/docker-machine-20260521`
+  - `release/docker-nas-20260521`
+  - `release/docker-generic-20260521`