2026-05-04-03-21-40 增加前后端协同和NIfTI导出

工程分析/测试方案-2026-05-04-03-21-40.md

@@ -0,0 +1,132 @@
+# 测试方案
+
+时间戳：2026-05-04-03-21-40
+
+## 测试目标
+
+验证系统已经从纯前端静态演示升级为前后端协调系统，并确认登录同步、默认项目、恢复出厂设置、NIfTI 导出和部署均可用。
+
+## 静态检查
+
+- 检查 `server.ts` 是否提供 API 和前端页面服务。
+- 检查 `src/lib/api.ts` 是否统一封装 API 请求。
+- 检查项目列表、系统管理、逆向工作区是否不再依赖硬编码假数据。
+- 检查 `.gitignore` 是否排除 `WebSite/data/`、`WebSite/exports/`、DICOM、STL、依赖和构建产物。
+
+## 构建与类型检查
+
+在 `WebSite/` 下执行：
+
+```bash
+npm run lint
+npm run build
+```
+
+预期结果：
+
+- TypeScript 类型检查通过。
+- Vite 构建通过。
+
+## API 验证
+
+启动后端服务后验证：
+
+```bash
+curl -s http://127.0.0.1:4000/api/health
+curl -s http://127.0.0.1:4000/api/session
+curl -s http://127.0.0.1:4000/api/projects
+curl -s http://127.0.0.1:4000/api/users
+curl -s -X POST http://127.0.0.1:4000/api/demo/reset
+```
+
+预期结果：
+
+- health 返回 `ok`。
+- projects 包含默认项目 `head-ct-demo`。
+- 默认项目 `dicomCount` 为 `300`。
+- 默认项目 STL 模块包含 `Head_CT_ReConstruct` 下的 `.stl` 文件。
+- reset 后默认项目仍存在。
+
+## 登录同步验证
+
+- 浏览器 A 登录 `admin / 123456`。
+- 浏览器 B 刷新或等待轮询后读取到已登录状态。
+- 浏览器 A 或 B 登出后，另一个浏览器轮询后同步到未登录状态。
+
+命令级验证：
+
+```bash
+curl -s -X POST http://127.0.0.1:4000/api/login -H 'Content-Type: application/json' -d '{"account":"admin","password":"123456"}'
+curl -s http://127.0.0.1:4000/api/session
+curl -s -X POST http://127.0.0.1:4000/api/logout
+curl -s http://127.0.0.1:4000/api/session
+```
+
+## NIfTI 导出验证
+
+执行：
+
+```bash
+curl -L -o /tmp/revoxelseg-mask.nii.gz -X POST http://127.0.0.1:4000/api/projects/head-ct-demo/export-mask
+file /tmp/revoxelseg-mask.nii.gz
+gzip -t /tmp/revoxelseg-mask.nii.gz
+```
+
+预期结果：
+
+- 下载文件存在。
+- 文件为 gzip 压缩数据。
+- `gzip -t` 校验通过。
+- 响应文件名后缀为 `.nii.gz`。
+
+## 页面验证
+
+- 打开 `http://192.168.3.11:4000/`。
+- 登录页可正常登录。
+- 总体概况显示后端统计数据。
+- 项目库默认显示头部 CT 演示项目。
+- 项目详情展示 `Head_CT_DICOM` 和 `Head_CT_ReConstruct` 相关信息。
+- 系统管理页点击“恢复演示环境出厂设置”后，项目仍恢复为默认 DICOM/STL。
+- 逆向工作区可导出 `nii.gz` mask。
+
+## 回归风险
+
+- 引入后端后部署方式从纯 Vite 改为 Express + Vite 中间件，需要确认 `4000` 服务由 `server.ts` 托管。
+- 后端共享登录状态是演示同步方案，不等同生产级多用户 session。
+- NIfTI 文件当前为演示 mask，非医学级真实 STL 体素化结果。
+
+## 人工审核状态
+
+本次用户明确要求无需人工二次确认。
+
+状态：自动确认，继续执行。
+
+## 执行结果
+
+- `npm run lint` 执行成功。
+- `npm run build` 执行成功。
+- Vite 仍有大 chunk 警告，当前不影响本次功能。
+- 已新增 Express 后端 `server.ts`，并通过 `npm run serve -- --host 0.0.0.0 --port 4000` 托管前后端。
+- `GET /api/health` 返回 `ok: true`。
+- `GET /api/projects` 返回默认项目 `head-ct-demo`。
+- 默认项目载入结果：
+  - `dicomCount: 300`
+  - `modelCount: 9`
+  - `dicomPath: Head_CT_DICOM`
+  - `modelPath: Head_CT_ReConstruct`
+- `POST /api/demo/reset` 执行成功，重置后默认项目仍载入 `Head_CT_DICOM` 与 `Head_CT_ReConstruct`。
+- `POST /api/login` 使用 `admin / 123456` 登录成功。
+- `GET /api/session` 登录后返回 `authenticated: true`。
+- `POST /api/logout` 登出成功。
+- `GET /api/session` 登出后返回 `authenticated: false`。
+- `POST /api/projects/head-ct-demo/export-mask?format=nii.gz` 执行成功。
+- `/tmp/revoxelseg-mask.nii.gz` 通过 `gzip -t` 校验。
+- 解压后 NIfTI magic 为 `n+1\0`。
+- `POST /api/projects/head-ct-demo/export-mask?format=nii` 执行成功，生成未压缩 `.nii`。
+- `http://192.168.3.11:4000/` 返回 `HTTP/1.1 200 OK`。
+- 当前部署由 `tmux` 会话 `revoxelseg-dicom` 托管。
+
+## 剩余说明
+
+- 当前导出的 NIfTI mask 是可下载、格式有效的演示分割体数据。
+- 真实医学级 STL 反向体素化仍需后续加入 DICOM 空间解析、STL 坐标配准、网格体素填充和标签体系。