# 测试方案

开始时间：2026-05-03-22-36-18

## 本次方案路径

`工程分析/测试方案-2026-05-03-22-36-18.md`

## 测试范围

- 前端文案是否正确调整。
- 四状态输出区每个状态是否都有独立下载按钮。
- 单状态 DICOM ZIP 下载是否能触发、轮询并下载。
- 数据影像库“变换”“阅览”“信息”“删除”按钮是否正常布局和工作。
- 阅览弹层是否能显示冠状位、矢状位。
- 阅览弹层是否能切换 DICOM/CT 显示模式和切片。
- 前端类型检查、构建和 Python 语法检查是否通过。
- 重新部署后目标地址是否可访问。

## 测试命令

Python 语法检查：

```bash
python -m py_compile web_backend.py head_extension_app.py
```

前端类型检查：

```bash
cd WebSite
npm run lint
```

前端构建：

```bash
cd WebSite
npm run build
```

后端阅览接口验证：

```bash
curl -s 'http://127.0.0.1:8787/api/library/reformat-preview?id=<影像库ID>&plane=coronal&index=0&window=bone'
```

```bash
curl -s 'http://127.0.0.1:8787/api/library/reformat-preview?id=<影像库ID>&plane=sagittal&index=0&window=soft_tissue'
```

部署验证：

```bash
curl -I --max-time 5 http://192.168.3.11:3005/
```

## 手工验证点

- 左侧按钮显示“下载结果”。
- 四状态卡片中原始序列、硬边界、高斯平滑、软过渡重建旁边均有下载按钮。
- 点击单状态下载按钮后，能下载对应 DICOM 序列 ZIP。
- 数据影像库卡片中“调阅”改为“变换”。
- 点击“变换”仍能进入影像变换工作站并选择该数据。
- 点击“阅览”打开弹层，能查看冠状位和矢状位。
- 切换显示模式后图像灰度/对比度发生变化。
- 调节切片滑杆后图像更新。

## 验收标准

- 所有用户提出的文字和功能入口均出现。
- 单状态 DICOM ZIP 下载可用。
- 阅览弹层可用，冠状位/矢状位和显示模式切换可用。
- `python -m py_compile web_backend.py head_extension_app.py` 通过。
- `npm run lint` 通过。
- `npm run build` 通过。
- Gitea commit 和 push 完成。
- 项目重新部署后 `http://192.168.3.11:3005/` 返回 `200 OK`。

## 无法测试或残余风险

- 若没有真实业务 DICOM 数据，使用仓库样例或当前影像库数据验证；不同扫描协议下的窗宽窗位显示效果可能需用户进一步微调。
- 冠状/矢状重建为轻量预览，不替代专业 DICOM 阅片器的诊断级 MPR 功能。

## 人工审核状态

待用户二次人工审核确认。未经确认不得修改业务代码。