72 lines
3.0 KiB
Markdown
72 lines
3.0 KiB
Markdown
# 实现方案-2026-06-23-12-07-35
|
||
|
||
## 实现方案文档路径
|
||
|
||
`工程分析/实现方案-2026-06-23-12-07-35.md`
|
||
|
||
## 修改目标
|
||
|
||
完成一次无业务源码变更的重新部署，使当前程序可通过 `http://192.168.3.11:4000/` 访问，并保留本次操作的工程分析记录。
|
||
|
||
## 涉及路径
|
||
|
||
- `AGENTS.md`
|
||
- `README.md`
|
||
- `WebSite/README.md`
|
||
- `WebSite/package.json`
|
||
- `WebSite/vite.config.ts`
|
||
- `WebSite/server.ts`
|
||
- `工程分析/代码编纂工作流.md`
|
||
- `工程分析/工程整体分析.md`
|
||
- `工程分析/经验记录.md`
|
||
- `工程分析/需求分析-2026-06-23-12-07-35.md`
|
||
- `工程分析/实现方案-2026-06-23-12-07-35.md`
|
||
- `工程分析/测试方案-2026-06-23-12-07-35.md`
|
||
|
||
## 技术路线
|
||
|
||
- 通过仓库文档、脚本和服务入口确认项目是 Express + Vite 的前后端一体服务。
|
||
- 使用 `npm run build` 生成生产构建产物。
|
||
- 使用 `tmux` 会话 `revoxelseg-dicom` 启动 `npm run serve -- --host 0.0.0.0 --port 4000`。
|
||
- 使用 `curl` 同时验证本机地址和目标局域网地址的 API 与首页。
|
||
- 仅将本次工程分析文档和经验记录纳入 Git 备份提交。
|
||
|
||
## 执行步骤
|
||
|
||
1. 检查工作区状态、Node/npm 版本、依赖目录、目标网卡地址、`4000` 端口和 `tmux` 会话。
|
||
2. 在 `WebSite/` 执行 `npm run build`。
|
||
3. 如存在旧 `revoxelseg-dicom` 会话，先确认并重建该会话；如不存在则创建新会话。
|
||
4. 在会话内执行 `npm run serve -- --host 0.0.0.0 --port 4000`。
|
||
5. 验证：
|
||
- `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/`
|
||
6. 检查 `tmux` 会话日志和 `4000` 端口监听状态。
|
||
7. 追加 `工程分析/经验记录.md` 的 A/B/C/D 四段式记录。
|
||
8. 暂存并提交本次工程分析文档，commit message 使用 `2026-06-23-12-07-35 部署并验证局域网 4000 服务`。
|
||
|
||
## 兼容性与回滚方案
|
||
|
||
- 如果构建失败，不重启旧服务，保留错误并汇报。
|
||
- 如果新服务启动失败，查看 `tmux` 日志和端口占用，停止失败会话后恢复上一条可用部署命令。
|
||
- 如果 `4000` 被非本项目进程占用，先记录占用来源，再决定是否停止或改用既有服务验证。
|
||
- 如果 `192.168.3.11` 不在本机网卡上，应停止局域网地址部署验证并报告网络前置条件不满足。
|
||
|
||
## 预计文件变更
|
||
|
||
- 新增：
|
||
- `工程分析/需求分析-2026-06-23-12-07-35.md`
|
||
- `工程分析/实现方案-2026-06-23-12-07-35.md`
|
||
- `工程分析/测试方案-2026-06-23-12-07-35.md`
|
||
- 追加：
|
||
- `工程分析/经验记录.md`
|
||
- 运行构建可能更新或生成 `WebSite/dist/`，该目录为运行态构建产物，不纳入本次文档备份提交。
|
||
|
||
## 提交与部署策略
|
||
|
||
- 先完成构建、部署和访问验证，再追加经验记录。
|
||
- 使用 Git 仅提交本次工程分析文档和经验记录。
|
||
- 不提交 DICOM/STL 数据、`WebSite/data/`、`WebSite/exports/`、`WebSite/dist/` 或无关工作区变化。
|
||
- 提交信息：`2026-06-23-12-07-35 部署并验证局域网 4000 服务`。
|