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

工程分析/测试方案-2026-05-21-11-13-49.md

@@ -0,0 +1,75 @@
+# 测试方案：独立 Docker 程序目录与 Gitea 分支存储
+
+测试方案文档路径：`工程分析/测试方案-2026-05-21-11-13-49.md`
+
+## 静态检查
+
+- 检查 `~/Desktop/ReVoxelSeg_DICOM_Docker` 中不包含：
+  - `工程分析/`
+  - `新撰写软著文档/`
+  - `参考软著构建模板/`
+  - `WebSite/node_modules/`
+  - `WebSite/dist/`
+  - `WebSite/data/`
+  - `WebSite/exports/`
+- 检查根目录存在：
+  - `Dockerfile`
+  - `docker_compose.yaml`
+  - `docker_compose.nas.yaml`
+  - `README.md`
+  - `WebSite/package-lock.json`
+  - `Head_CT_DICOM/`
+  - `Head_CT_ReConstruct/`
+
+## 构建检查
+
+- `docker compose -f docker_compose.yaml config`
+- `docker compose -f docker_compose.nas.yaml config`
+- `docker compose -f docker_compose.yaml build`
+
+## 关键业务场景验证
+
+- 从独立目录启动后，`http://127.0.0.1:4000/api/health` 返回 `ok: true`。
+- 首页 `/` 返回 `200 OK`。
+- frpc 容器可以启动并读取内嵌配置。
+
+## 医学影像数据相关边界验证
+
+- 独立目录包含默认 DICOM/STL 数据，脱离主项目目录后仍可构建镜像。
+- 运行态 `data/` 与 `exports/` 挂载在独立目录根部，不覆盖默认演示数据。
+
+## 部署验证
+
+- 如当前已有主项目 Docker 服务占用 4000，验证前先停止旧 Compose 或避免重复启动。
+- 验证后可按需要恢复或保留独立目录 Docker 服务。
+
+## Git/Gitea 备份验证
+
+- 独立目录 Git 分支：`docker-standalone-20260521`。
+- 推送到 `http://192.168.31.5:5002/admin/REVOXELSEG_DICOM.git`。
+- 主项目工程分析记录另行提交，commit message 包含 `2026-05-21-11-13-49`。
+
+## 风险与回归关注点
+
+- 独立分支内容与 `main` 分支目录结构不同，使用者需要明确选择分支。
+- Docker 镜像体积受默认医学数据影响。
+- NAS Compose 绝对路径需要部署时与实际 QTS 路径一致。
+
+## 实际执行结果
+
+- 已创建独立目录：`/home/wkmgc/Desktop/ReVoxelSeg_DICOM_Docker`。
+- 独立目录根文件包含：`.dockerignore`、`.gitignore`、`Dockerfile`、`README.md`、`docker_compose.yaml`、`docker_compose.nas.yaml`。
+- 独立目录包含必要运行内容：`WebSite/`、`Head_CT_DICOM/`、`Head_CT_ReConstruct/`。
+- 独立目录不包含：`工程分析/`、`新撰写软著文档/`、`参考软著构建模板/`、`WebSite/node_modules/`、`WebSite/dist/`、`WebSite/data/`、`WebSite/exports/`。
+- `docker compose -f docker_compose.yaml config`：通过。
+- `docker compose -f docker_compose.nas.yaml config`：通过。
+- 已停止原主项目 Docker Compose 服务，避免 4000 端口与 FRPC 远端端口冲突。
+- 在独立目录执行 `docker compose -f docker_compose.yaml up -d --build`：通过。
+- `revoxelseg_web`：healthy，端口映射为 `0.0.0.0:4000->4000/tcp`。
+- `revoxelseg_frpc`：日志显示 `login to server success` 与 `[ReVoxelSeg_DICOM] start proxy success`。
+- `curl http://127.0.0.1:4000/api/health`：返回 `{"ok":true,"service":"revoxelseg-dicom"}`。
+- `curl http://127.0.0.1:4000/`：返回 `200 OK`。
+- `curl http://192.168.3.11:4000/`：返回 `200 OK`。
+- `curl https://revoxel.huijutec.cn/`：返回 `200 OK`。
+- 独立目录已初始化 Git 仓库，提交 `57415a1 2026-05-21-11-13-49 独立Docker程序包`。
+- Gitea 新分支已创建并推送：`docker-standalone-20260521`。