2026-05-24-09-58-56 恢复Docker部署并清理发布分支

工程分析/需求分析-2026-05-24-09-58-56.md

@@ -0,0 +1,56 @@
+# 需求分析-2026-05-24-09-58-56
+
+## 开始时间
+
+2026-05-24-09-58-56
+
+## 原始需求摘要
+
+用户要求阅读当前项目并了解整体内容；确认 Gitea 备份仓库 `https://gitea.huijutec.cn/admin/REVOXELSEG_DICOM`；恢复误删的 `Docker部署/` 文件夹；判断 Gitea 中除 `main` 以外的四个 Docker 发布辅助分支是否仍有影响，若不影响当前发布项“ReVoxelSeg DICOM Docker 部署包 v2026.05.21”服务则删除；最后重新部署项目并验证 `https://revoxel.huijutec.cn/` 是否可以正常访问和使用。
+
+## 业务目标
+
+- 恢复主工程中的 Docker 部署资料，保证本机、NAS 与公网隧道部署说明可追溯。
+- 清理不再需要的远端发布辅助分支，避免 Gitea 分支列表混乱，同时保留发布标签、Release 和附件可用性。
+- 重新启动当前服务并验证本机健康接口、页面入口和公网域名。
+- 按工程协作约束记录本次分析、方案、测试与经验，并提交 Gitea 备份。
+
+## 输入与输出
+
+- 输入：
+  - 当前本地仓库 `/home/wkmgc/Desktop/ReVoxelSeg_DICOM`。
+  - Gitea 仓库地址及用户提供的账号信息。
+  - 既有 Docker 发布包与历史工程分析记录。
+- 输出：
+  - 恢复后的 `Docker部署/` 目录。
+  - 本次 `需求分析`、`实现方案`、`测试方案` 文档。
+  - 追加后的 `工程分析/经验记录.md`。
+  - 包含时间戳的 Git/Gitea 备份 commit。
+  - 重新部署后的服务验证结果。
+
+## 影响范围
+
+- 本地文件：`Docker部署/`、`工程分析/需求分析-2026-05-24-09-58-56.md`、`工程分析/实现方案-2026-05-24-09-58-56.md`、`工程分析/测试方案-2026-05-24-09-58-56.md`、`工程分析/经验记录.md`。
+- 远端仓库：可能删除 `docker-standalone-20260521`、`release/docker-machine-20260521`、`release/docker-nas-20260521`、`release/docker-generic-20260521` 四个分支。
+- 运行服务：`WebSite` 构建产物、`tmux` 会话 `revoxelseg-dicom`、本机 `4000` 端口、公网域名 `https://revoxel.huijutec.cn/`。
+
+## 关键约束
+
+- 必须先执行 `工程分析/代码编纂工作流.md`。
+- 最终执行前需再次确认已读 `工程分析/经验记录.md`。
+- 文档备份 commit message 必须包含 `2026-05-24-09-58-56` 与简要描述。
+- 只暂存本次相关文件，避免把既有未确认删除的历史文档或运行态文件混入提交。
+- 部署优先使用 `WebSite && npm run build && npm run serve -- --host 0.0.0.0 --port 4000`，长期运行优先沿用 `tmux` 会话 `revoxelseg-dicom`。
+
+## 风险点
+
+- 当前工作区除 `Docker部署/` 外，还存在多份历史 `工程分析/*-2026-05-*` 文件删除状态，需避免误提交。
+- 删除远端分支属于不可逆清理操作，需先确认发布 Release/Tag/附件不依赖分支指针。
+- 本地 `origin` 指向 `http://192.168.31.5:5002/...`，用户提供的备份仓库为 `https://gitea.huijutec.cn/...`，提交与推送需确认目标一致。
+- 公网访问依赖反向代理、FRP 或现有外部链路，仅本机 `tmux` 服务启动不一定能修复公网链路。
+
+## 待确认问题或默认假设
+
+- 默认假设：用户已授权在确认无影响后删除四个 Docker 发布辅助分支，但不删除 `main`、tag、Release 和 Release 附件。
+- 默认假设：恢复 `Docker部署/` 可优先从当前 Git 历史或远端 `main` 中取回，不需要重写部署方案。
+- 默认假设：本次不恢复或提交既有历史 `工程分析` 文档删除状态，除非后续验证发现这些删除会影响本次工作流核心文档。