3.0 KiB
3.0 KiB
实现方案-2026-06-23-12-07-35
实现方案文档路径
工程分析/实现方案-2026-06-23-12-07-35.md
修改目标
完成一次无业务源码变更的重新部署，使当前程序可通过 http://192.168.3.11:4000/ 访问，并保留本次操作的工程分析记录。
涉及路径
AGENTS.mdREADME.mdWebSite/README.mdWebSite/package.jsonWebSite/vite.config.tsWebSite/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 备份提交。
执行步骤
- 检查工作区状态、Node/npm 版本、依赖目录、目标网卡地址、
4000端口和tmux会话。 - 在
WebSite/执行npm run build。 - 如存在旧
revoxelseg-dicom会话，先确认并重建该会话；如不存在则创建新会话。 - 在会话内执行
npm run serve -- --host 0.0.0.0 --port 4000。 - 验证：
http://127.0.0.1:4000/api/healthhttp://127.0.0.1:4000/http://192.168.3.11:4000/api/healthhttp://192.168.3.11:4000/
- 检查
tmux会话日志和4000端口监听状态。 - 追加
工程分析/经验记录.md的 A/B/C/D 四段式记录。 - 暂存并提交本次工程分析文档，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 服务。