# 需求分析：独立 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`。