# 功能测试报告：数据查看展示优化与网约车按市州竖排（2026-09-22）

> 日期：2026-09-22　模块：数据查看（前端 DataView.vue + 后端 DataViewController）　测试人：Codex
> 诉求来源：用户当日复核后的 4 点反馈。

## 一、功能说明（按用户 4 点反馈逐条）

1. **数据类型下拉分组标题样式**：Element UI 默认把 `el-select-group__title` 做成 12px 灰字，视觉上"比选项更小更淡"。
   改为明确的组标题样式（13px / 700 / `#303133` / 浅底 `#F5F7FA`），并与选项左缩进拉开层级；通过 `popper-class="data-type-select"` 精确命中该下拉，不影响其它页面。
2. **冻结列调整**：报表期与所属地区不再出现在表格中（报表期由筛选条件体现；所属地区是 6 位区划代码，已由派生的"市州"列替代）。
   冻结区只保留"能辨识数据归属"的列，最多 3 列：市州/地区、企业名称/项目名称/车牌号、口径。
   - 后端为企业类表补派生"市州"列（`RegionUtil.cityByCode`）：h2032、h2031、h204 车辆能耗季报、个体客运（原有）。
3. **规上规下拆分空值核查**：源文件《模板_规上规下拆分运输量.xlsx》的表头只有"周转量/排名/同比/增速排名"，**没有货运量列**，
   导入按"周转量"布局解析（有货运量的扩展布局会自动识别），所以规上/规下/合计货运量三列为空——属源数据形态，不是导入故障。
   三家周转量列名已标注单位 `(万吨公里)`；货运量列名标注 `(来源文件未提供该列)`。
4. **网约车订单及全省总量改为按市州竖排**：由"1 行/期 × 23 列宽表"改为"地区（全省 + 17 市州）× 指标"的长表，
   列：`地区 | 期间 | 订单数(单) | 订单占比 | 客运量(万人次) | 旅客周转量(万人公里) | 其中城市内客运量(万人次) | 其中城市内旅客周转量(万人公里) | 说明`。
   - 订单数取台账原值；订单占比 = 该市州订单数 ÷ 订单合计；
   - 客运量/周转量/城市内两列**复用 `WycSplitCalc`（拆分口径）**，与汇总大表「网约车」页同源算法；全省行直接取台账 pin 值。
5. **市州月报进度显示项目名称**：原表只有 `project_id`，页面显示数字无法辨识。现按 `investment_project` 连表补 `项目名称` + `市州`；`项目ID` 列保留在接口中（供连表）但页面不展示。
6. **数值显示规范**：全部数据**底层保持全精度**（导出/汇总仍用原值），仅显示层格式化：
   - 比率类列（rate/yoy/mom/growth/ratio/percent/share）库内是小数（0.045 = 4.5%），显示为百分比两位小数；
   - 排名类列（rank）显示整数；
   - 其余数值千分位、保留两位小数；整数原样显示（如车辆数 51、排名 1）。

## 二、测试环境

- 后端：`start-dev.ps1`（8090）；前端：dev server（8080）；数据库：本机 MySQL `localhost:3308/traffic_audit`；账号 admin/123456。
- 浏览器：Codex 内置浏览器真机操作（DOM 校验）。

## 三、用例表

### 3.1 接口用例

| 编号 | 输入 | 预期 | 实际 | 结论 |
| --- | --- | --- | --- | --- |
| TC-1 | `type=wycOrder&period=2026-08` | 18 行（全省 + 17 市州） | total=18；全省：订单 30,508,652、客运量 4997.74、周转量 29166.70、城市内 4571.18/23367.09 | 通过 |
| TC-2 | 同上，武汉市 | 按订单占比拆分 | 订单 11,550,551、占比 0.378599、客运量 1892.14、周转量 13484.80 | 通过 |
| TC-3 | `type=investmentMonthly&period=2026-08` | 显示项目名称与市州 | `通山城西综合客运站（二级站）` / 咸宁市（原为 projectId=1） | 通过 |
| TC-4 | `type=h2032&period=2026-08` | 派生市州列 | regionCode=429021 → 市州=神农架林区 | 通过 |
| TC-5 | `type=cityBus` 列名 | 带单位 | 客运量(万人次) / 旅客周转量(万人公里) / 平均运距(公里) | 通过 |
| TC-6 | `type=scaleSplit` 列名 | 标注单位与缺口 | 规上周转量(万吨公里) / 规上货运量(来源文件未提供该列) | 通过 |

### 3.2 真机（浏览器）用例

| 编号 | 输入 | 预期 | 实际 | 结论 |
| --- | --- | --- | --- | --- |
| TC-7 | 展开数据类型下拉 | 组标题比选项更醒目 | 组标题 13px / 700 / rgb(48,49,51)（原为 12px 灰字） | 通过 |
| TC-8 | 货运企业月报 | 冻结市州+企业名称，隐藏报表期/所属地区 | 冻结表头=市州、企业名称；正文首列=车辆数合计；无报表期/所属地区 | 通过 |
| TC-9 | 城市公交 | 同上 | 冻结=市州、企业名称；神农架林区行数据正常 | 通过 |
| TC-10 | 网约车订单 | 冻结地区 | 冻结=地区；列序=地区、期间、订单数…；360 行（20 期 × 18） | 通过 |
| TC-11 | 规上规下拆分 | 冻结口径+市州 | 冻结=口径、市州；规上同比列显示百分比 | 通过 |
| TC-12 | 数值格式 | 千分位 + 两位小数 + 比率百分比 | 30,508,652 / 570,004.44 / 100.00% / 空值 `-` | 通过 |

### 3.3 单位核对（规上规下拆分周转量）

| 项 | 值 |
| --- | --- |
| h2032 武汉 1-6 月规上周转量（吨公里） | 12,357,607,239 |
| 拆分表 武汉 2026-06 累计规上周转量（万吨公里） | 1,235,760.72 |
| 1,235,760.72 × 10000 | 12,357,607,239（完全一致） |

结论：拆分表周转量单位为**万吨公里**（与 h2032 的吨公里相差 1 万倍），跨表汇总需换算。

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

1. 规上规下拆分（`scale_split_transport`）**货运量三列全空、周转量等有值**：核查源文件表头确认源数据本身没有货运量列，非导入故障；已把列名标注为"来源文件未提供该列"，并建议与业务确认是否需要供应商补该列。
2. `investment_monthly` 只存 `project_id`，页面无法辨识项目；已连表补项目名称与市州。
3. 网约车台账是多期混排（默认 360 行）；"报表期"列在全站被隐藏，故该表把期间列改名为"期间"并紧跟"地区"，避免多期行无法区分。
4. 勾稽校验：网约车全省客运量 4997.74 与 `wyc_total_monthly` 2026-08 的 pinK 一致。

## 五、结论

用户反馈的 4 点全部处理并通过真机用例：下拉分组标题样式、隐藏报表期/所属地区并收窄冻结列、拆分表空值与单位说明、网约车按市州竖排、市州月报项目名称、数值与百分比显示规范。底层数据精度未做任何改动。