2026-06-04-09-46-36 部署并验证局域网 4000 服务

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

@@ -0,0 +1,50 @@
+# 需求分析-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` 作为局域网访问地址。