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

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