REVOXELSEG_DICOM/工程分析/需求分析-2026-06-23-12-07-35.md

需求分析-2026-06-23-12-07-35

开始时间

2026-06-23-12-07-35

原始需求摘要

用户要求阅读整个工作区，并部署当前程序，使其可以通过 http://192.168.3.11:4000/ 被访问。

业务目标

• 确认当前仓库结构、部署约束、运行脚本和历史经验。
• 在不修改业务源码的前提下完成一次当前版本构建。
• 使用长期运行方式启动前后端一体服务。
• 确认本机与局域网目标地址均可访问。

输入与输出

• 输入：当前工作区 /home/wkmgc/Desktop/ReVoxelSeg_DICOM、WebSite/package.json 脚本、WebSite/server.ts 服务入口、DICOM/STL 默认演示数据、已有 tmux 和端口状态。
• 输出：运行在 0.0.0.0:4000 的 ReVoxelSeg DICOM 服务、验证通过的 http://127.0.0.1:4000/ 与 http://192.168.3.11:4000/ 访问结果、本次工程分析文档和备份提交。

影响范围

• 运行态：WebSite/dist/ 构建产物、tmux 会话 revoxelseg-dicom、4000 端口监听进程。
• 文档：新增本次 需求分析、实现方案、测试方案，并在完成后追加 工程分析/经验记录.md。
• 不修改业务源码、医学影像数据、STL 模型数据、运行态状态和导出结果。

关键约束

• 必须先执行 工程分析/代码编纂工作流.md。
• 必须阅读 工程分析/工程整体分析.md 和 工程分析/经验记录.md。
• 最终执行方案前需再次确认已读 工程分析/经验记录.md。
• 部署优先使用：
  • cd WebSite
  • npm run build
  • npm run serve -- --host 0.0.0.0 --port 4000
• 长期运行优先沿用 tmux 会话 revoxelseg-dicom。
• Git/Gitea 备份 commit message 必须包含时间戳和简要描述。

风险点

• 4000 端口可能被旧服务或 Docker 容器占用。
• tmux 会话中可能残留旧命令，需要确认实际启动的是当前构建版本。
• 目标 IP 192.168.3.11 必须属于当前机器网卡，否则局域网地址无法访问。
• 如果只验证 /api/health，可能遗漏首页 HTML 或前端资源访问异常。
• 不能将医学数据、运行态产物或无关工作区变更混入备份提交。

待确认问题或默认假设

• 默认假设当前工作区代码即为用户希望部署的版本。
• 默认假设用户要求的是本机 tmux 方式部署，而不是 Docker/FRPC 公网部署。
• 默认假设本次仅做部署、验证和工程分析文档维护，不做功能代码变更。