52 lines
2.4 KiB
Markdown
52 lines
2.4 KiB
Markdown
# 需求分析：独立 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`。
|