2026-05-21-11-13-49 记录独立Docker程序包分支

工程分析/需求分析-2026-05-21-11-13-49.md

@@ -0,0 +1,51 @@
+# 需求分析：独立 Docker 程序目录与 Gitea 分支存储
+
+开始时间：2026-05-21-11-13-49
+
+## 原始需求摘要
+
+用户要求将完整 Docker 程序放到 `~/Desktop/ReVoxelSeg_DICOM_Docker`，后续即使没有原始 `ReVoxelSeg_DICOM` 文件夹，也能直接在 `ReVoxelSeg_DICOM_Docker` 中运行。该独立目录不需要包含 `工程分析/`、软著撰写材料以及其他无关内容。用户还要求将 Docker Compose 文件放在程序根目录，并在 Gitea 新开一个分支进行存储。
+
+## 业务目标
+
+形成一个可单独复制、可单独部署、可单独在 Gitea 分支维护的 Docker 运行包，降低迁移到新机器或 NAS 的操作复杂度。
+
+## 输入与输出
+
+输入：
+
+- 当前主项目中的 `WebSite/` 程序源码。
+- 默认演示数据 `Head_CT_DICOM/` 与 `Head_CT_ReConstruct/`。
+- 现有 Docker 部署配置。
+
+输出：
+
+- 独立目录：`~/Desktop/ReVoxelSeg_DICOM_Docker`。
+- 根目录 Dockerfile、`.dockerignore`、`docker_compose.yaml`、`docker_compose.nas.yaml`、`README.md`。
+- 独立目录可通过 Docker Compose 构建和启动。
+- Gitea 新分支保存该独立 Docker 程序包。
+
+## 影响范围
+
+- 新增桌面独立目录，不改变原主项目业务代码。
+- 主项目仅新增本次工程分析记录。
+- Gitea 新分支采用独立程序包内容，不携带 `工程分析/`、软著材料、参考模板、测试压缩包等内容。
+
+## 关键约束
+
+- 独立目录必须自包含默认演示 DICOM/STL 数据。
+- 独立目录不应包含 `WebSite/node_modules`、`WebSite/dist`、`WebSite/data`、`WebSite/exports` 等运行态或构建产物。
+- 根目录无法同时存在两个完全同名的 `docker_compose.yaml`，因此默认使用 `docker_compose.yaml` 表示本机版，`docker_compose.nas.yaml` 表示威联通 NAS 版。
+- Gitea 分支不能混入当前主仓库中既有的历史删除和未跟踪杂项。
+
+## 风险点
+
+- 独立分支若使用同一个 Gitea 仓库，会与 `main` 分支内容结构不同；使用者需要明确切换到 Docker 独立分支。
+- Docker 镜像仍包含默认医学演示数据，构建上下文和镜像体积较大。
+- frpc 公网访问依赖远端服务端与 NPM 反向代理配置，本地只能验证分支、构建和本地服务。
+
+## 默认假设
+
+- 新分支命名为 `docker-standalone-20260521`。
+- 本机 Compose 文件名为 `docker_compose.yaml`。
+- NAS Compose 文件名为 `docker_compose.nas.yaml`。