2026-06-23-12-07-35 部署并验证局域网 4000 服务

工程分析/实现方案-2026-06-23-12-07-35.md

@@ -0,0 +1,71 @@
+# 实现方案-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 服务`。