# 需求分析-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 公网部署。
- 默认假设本次仅做部署、验证和工程分析文档维护，不做功能代码变更。