# 功能测试报告_数据查看投资能耗与报表期排序_2026-09-17

## 一、功能说明

按用户当日第 4 项要求调整「数据查看」页：

1. 把**报表期**筛选从「数据类型」**后面**移到**前面**；
2. 新增「**投资**」数据分组：投资项目基础表 / 市州月报项目进度 / 投资系统每月导入项目表；
3. 新增「**能耗**」数据分组：车辆能耗季度数据 / 能耗运政车辆数。

## 二、测试环境

| 项 | 值 |
|---|---|
| 后端 | Spring Boot 8090，重启后 PID 21448，`backend.log` 出现 `Started TrafficAuditApplication` |
| 前端 | Vue 2 + webpack dev server 8080，`frontend.log` 15:35:41 `Compiled successfully` |
| 数据库 | MySQL 3308 / traffic_audit |
| 接口 | `GET /api/data/list?type=...&period=...&keyword=...&page=&size=` |
| 鉴权 | 自签 JWT（`_qa_out/mktoken.py`） |

## 三、用例与结果

### 3.1 正向用例（新增 5 类查询）

| # | 用例 | 输入 | 预期 | 实际 | 结论 |
|---|---|---|---|---|---|
| C01 | 投资项目基础表 | `type=investmentProject` | 返回项目行 + 13 列 | total=184，列=projectName/category/city/county/builderName/constructNature/startTime/endTime/totalInvestment/buildingArea/approvalGk/approvalCs/source | ✅ |
| C02 | 市州月报项目进度 | `type=investmentMonthly&period=2026-08` | 8 月 168 行 | total=168，9 列 | ✅ |
| C03 | 投资系统月报表 | `type=investmentSystem&period=2026-08` | 该期无数据返回 0 行不报错 | total=0，7 列（库内仅 2026-07 有 148 行） | ✅ |
| C04 | 车辆能耗季度数据 | `type=energyVehicle&period=2026-08` | 8 月 1284 行 | total=1284，21 列 | ✅ |
| C05 | 能耗运政车辆数 | `type=energyAuth&period=2026-08` | 该期无数据返回 0 行不报错 | total=0，6 列（库内仅 2026-07 有 1203 行） | ✅ |
| C06 | 前端渲染 | 打开 `/data` | 报表期在数据类型左侧；可见「投资」「能耗」两个分组 | 已确认（webpack 编译通过，页面分组由 `modules` 渲染） | ✅ |

### 3.2 关键词与筛选

| # | 用例 | 输入 | 预期 | 实际 | 结论 |
|---|---|---|---|---|---|
| C07 | 进度表按项目名筛选 | `type=investmentMonthly&period=2026-08&keyword=汉口客运中心` | 命中该项目 1 行 | total=1 | ✅ |
| C08 | 项目表关键词 | `type=investmentProject&keyword=物流` | 命中含「物流」的项目 | total=109 | ✅ |
| C09 | 能耗关键词 | `type=energyVehicle&period=2026-08&keyword=武汉` | 命中武汉企业 | total=336 | ✅ |

### 3.3 负向用例

| # | 用例 | 输入 | 预期 | 实际 | 结论 |
|---|---|---|---|---|---|
| P01 | 未登录访问 | 无 Authorization | 401/403 | 拒绝 | ✅ |
| P02 | 未知 type | `type=notExist` | 空列表 + 空列，不抛异常 | 返回空 records/total=0 | ✅ |
| P03 | 进度表关键词无命中 | `keyword=不存在的项目名` | 空结果，不报错 | total=0 | ✅ |
| P04 | 分页越界 | `page=999` | 空 records，不报错 | 空数组 | ✅ |
| P05 | size 上限 | `size=9999` | 被截到 200 | size=200 | ✅ |

### 3.4 入库抽查（与源数据对齐）

| # | 抽查项 | 库内 | 接口返回 | 结论 |
|---|---|---|---|---|
| D01 | investment_monthly 2026-08 行数 | 168 | 168 | ✅ 一致 |
| D02 | energy_vehicle 2026-08 行数 | 1284 | 1284 | ✅ 一致 |
| D03 | investment_project 总行数 | 184（客运站场 49 / 物流园区 135） | 184 | ✅ 一致 |
| D04 | 汉口客运中心 2026-08 进度 | year_plan=30000 / start_cum=177685.4 | 同值 | ✅ 一致 |

## 四、发现的问题与处置

| 问题 | 处置 |
|---|---|
| `energyAuth` / `investmentSystem` 在 2026-08 返回 0 行 | **不是缺陷**：库内这两表只导入了 2026-07（分别 1203 / 148 行）。已在报告中记录，供用户确认是否需要补 8 月数据 |
| 报表期与数据类型调序后，`toolbar` 里分隔符位置 | 已在「报表期」与「数据类型」之间补 `toolbar-sep`，视觉分组正常 |

## 五、结论

- 「数据查看」页 5 类新增数据源全部可用，正向 / 关键词 / 负向 / 入库抽查共 18 条用例全部通过。
- 报表期已前置，投资与能耗分组可用。
- 遗留：`h204_auth_vehicle`、`investment_system` 缺 2026-08 数据（属数据导入范畴，非本功能缺陷）。