REVOXELSEG_DICOM/工程分析/需求分析-2026-06-04-09-46-36.md

需求分析-2026-06-04-09-46-36

开始时间

2026-06-04-09-46-36

原始需求摘要

用户要求部署当前 ReVoxelSeg DICOM 程序，并希望通过 http://192.168.3.11:4000/ 访问。

业务目标

• 使用项目约定的 WebSite 一体服务完成重新部署。
• 服务监听 0.0.0.0:4000，确保局域网地址 192.168.3.11:4000 可访问。
• 完成构建、健康检查、首页访问和部署状态验证。

输入与输出

• 输入：当前工作区代码、WebSite/package.json 部署脚本、已有 tmux 会话和本机网络环境。
• 输出：运行在 4000 端口的 WebSite 服务、可访问的局域网地址、部署验证结果和文档备份 commit。

影响范围

• 运行态影响：WebSite/dist/ 构建产物、tmux 会话 revoxelseg-dicom 中的 Node 服务。
• 文档影响：新增本次需求分析、实现方案、测试方案，并追加经验记录。
• 不涉及源码逻辑、医学影像数据、STL 数据和导出算法变更。

关键约束

• 必须执行 工程分析/代码编纂工作流.md。
• 部署优先使用：
  • cd WebSite
  • npm run build
  • npm run serve -- --host 0.0.0.0 --port 4000
• 长期运行优先沿用 tmux 会话 revoxelseg-dicom。
• 部署后至少验证 /api/health 和首页。
• 文档备份 commit message 必须包含 2026-06-04-09-46-36。

风险点

• 4000 端口可能已有旧服务或其他进程占用，需要先识别并重启到当前版本。
• 若构建失败，不能直接复用旧服务冒充新部署。
• 若本机可访问但局域网地址不可访问，可能是监听地址、防火墙或网络链路问题。
• 构建产物和运行态文件不应混入文档备份 commit。

待确认问题或默认假设

• 默认当前工作区代码就是用户希望部署的版本。
• 默认无需修改源码，只做构建、启动、验证和工程分析文档备份。
• 默认使用本机实际网卡地址 192.168.3.11 作为局域网访问地址。