57 lines
3.5 KiB
Markdown
57 lines
3.5 KiB
Markdown
# 需求分析-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` 中取回，不需要重写部署方案。
|
||
- 默认假设：本次不恢复或提交既有历史 `工程分析` 文档删除状态，除非后续验证发现这些删除会影响本次工作流核心文档。
|