# 测试方案-2026-06-23-12-07-35

## 测试方案文档路径

`工程分析/测试方案-2026-06-23-12-07-35.md`

## 静态检查

- 检查 `WebSite/package.json` 中存在 `build` 与 `serve` 脚本。
- 检查 `WebSite/server.ts` 会解析 `--host`、`--port` 参数并提供 `/api/health`。
- 检查本机是否包含目标网卡地址 `192.168.3.11`。
- 检查当前 Git 工作区，避免提交无关变更。

## 构建检查

- 在 `WebSite/` 执行 `npm run build`。
- 如果构建失败，停止部署并记录错误。

## 关键业务场景验证

- 验证首页 HTML 可正常返回，确认前端入口可访问。
- 验证 `/api/health` 返回健康状态，确认 Express API 可用。
- 可选验证 `/api/projects` 返回项目列表，确认默认项目状态可读。

## 医学影像数据相关边界验证

- 本次仅重新部署，不修改 DICOM/STL 解析、融合、分割映射或 Mask 导出逻辑。
- 检查默认演示数据目录存在并记录数量，不生成新的医学导出文件。
- 避免将 `Head_CT_DICOM/`、`Head_CT_ReConstruct/`、`WebSite/data/`、`WebSite/exports/` 混入 Git 提交。

## 部署验证

- 服务命令：`npm run serve -- --host 0.0.0.0 --port 4000`。
- 运行载体：`tmux` 会话 `revoxelseg-dicom`。
- 端口验证：确认 `4000` 端口由当前 Node 服务监听。
- 访问验证：
  - `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/`

## Git/Gitea 备份验证

- 只暂存本次工程分析三件套和 `工程分析/经验记录.md`。
- 提交后用 `git show --stat --oneline HEAD` 验证 commit message 包含 `2026-06-23-12-07-35` 和部署简述。

## 风险与回归关注点

- 如果 `tmux` 会话已存在，需确认旧服务关闭后新服务能稳定启动。
- 如果局域网 IP 不属于当前机器，服务即使监听成功也无法通过目标地址访问。
- 如果只验证 localhost，不能代表 `192.168.3.11` 可访问。
- 如果误提交构建产物或医学数据，会污染备份提交，需要在提交前复查 staged 文件。

## 执行结果

- `npm run lint`：通过，`tsc --noEmit` 无错误。
- `npm run build`：通过，Vite 成功生成 `dist/`；存在 chunk 大于 500 kB 的体积提示，不影响本次部署。
- 本机网卡：已确认 `ens34` 包含 `192.168.3.11/24`。
- 端口与会话：`tmux` 会话 `revoxelseg-dicom` 已创建，`4000` 端口由当前 Node 进程监听在 `0.0.0.0:4000`。
- 启动命令：`NODE_ENV=production npm run serve -- --host 0.0.0.0 --port 4000`。
- `http://127.0.0.1:4000/api/health`：HTTP 200，返回 `ok: true`。
- `http://127.0.0.1:4000/`：HTTP 200，返回 HTML。
- `http://192.168.3.11:4000/api/health`：HTTP 200，返回 `ok: true`。
- `http://192.168.3.11:4000/`：HTTP 200，返回 HTML。
- `http://127.0.0.1:4000/api/projects`：HTTP 200，当前返回 2 个项目，默认项目 `head-ct-demo` 包含 300 张 DICOM 与 9 个 STL。