Files
REVOXELSEG_DICOM/工程分析/实现方案-2026-06-04-09-46-36.md

60 lines
2.2 KiB
Markdown

# 实现方案-2026-06-04-09-46-36
## 实现方案文档路径
`工程分析/实现方案-2026-06-04-09-46-36.md`
## 修改目标
完成一次无源码变更的重新部署,让用户可以通过 `http://192.168.3.11:4000/` 访问当前程序。
## 涉及路径
- `WebSite/`
- `WebSite/package.json`
- `工程分析/需求分析-2026-06-04-09-46-36.md`
- `工程分析/实现方案-2026-06-04-09-46-36.md`
- `工程分析/测试方案-2026-06-04-09-46-36.md`
- `工程分析/经验记录.md`
## 技术路线
1. 检查工作区状态、部署脚本、已有 `tmux` 会话和 `4000` 端口占用。
2.`WebSite` 执行 `npm run build`,生成最新生产构建。
3. 使用或重建 `tmux` 会话 `revoxelseg-dicom`,在其中启动:
`npm run serve -- --host 0.0.0.0 --port 4000`
4. 验证本机健康检查、本机首页和局域网首页。
5. 追加经验记录,并仅提交本次工程分析文档与经验记录。
## 执行步骤
- 执行前再次确认已读 `工程分析/经验记录.md`
- 若存在旧 `revoxelseg-dicom` 会话,先发送 `Ctrl-C` 停止旧服务,再启动新服务。
- 若不存在该会话,则创建新的 detached `tmux` 会话。
- 使用 `curl` 验证:
- `http://127.0.0.1:4000/api/health`
- `http://127.0.0.1:4000/`
- `http://192.168.3.11:4000/api/health`
- `http://192.168.3.11:4000/`
- 检查 `tmux` 会话和端口监听状态,确认服务长期运行。
## 兼容性与回滚方案
- 若新服务启动失败,保留构建和启动日志,停止新会话后回滚到上一次可用部署命令。
- 若端口被非本项目进程占用,先记录占用来源,再决定是否停止或改端口。
- 若局域网访问失败但本机访问成功,优先排查监听地址、服务器防火墙和网络路由。
## 预计文件变更
- 新增本次三件套文档。
- 追加 `工程分析/经验记录.md`
- `WebSite/dist/` 会因构建更新,但不纳入本次文档备份 commit。
- 不预计修改源码。
## 提交与部署策略
- 先完成构建、服务重启和访问验证。
- 再追加经验记录。
- 仅暂存本次工程分析文档和 `工程分析/经验记录.md`
- commit message 使用:`2026-06-04-09-46-36 部署并验证局域网 4000 服务`