编辑 | blame | 历史 | 原始文档

功能测试报告:数据查看口径筛选、空列隐藏与表头单位(2026-09-22)

日期:2026-09-22 模块:数据查看(前端 DataView.vue + 后端 DataViewController) 测试人:Codex
诉求来源:用户复核第 2、3 点——空列能否不显示、口径能否提到上面、所有表头是否都带单位。

一、功能说明

  1. 源文件未提供的空列不再显示:规上规下拆分表的 规上货运量 / 规下货运量 / 合计货运量 三列(源文件《模板_规上规下拆分运输量.xlsx》没有货运量列,库内全空)不展示;
    列定义与接口字段保留(若填报方后续补上货运量列,取消前端隐藏即可恢复)。
  2. 口径上移为筛选:拆分表的 口径(当月/累计)不再是表格列,改成工具栏下拉(全部 / 当月 / 累计),后端 /api/data/list 新增 periodType 参数(MONTH / CUMULATIVE);
    "全部"时仍会同时返回两种口径的行。切换数据类型时口径自动复位为"全部"。
  3. 所有表头补单位:按库内字段注释 + 源文件表头 + 交叉核对,为各表数值列补齐单位,共 12 类表、60 余列:
模块 单位口径
城市公交/巡游出租 客运量(万人次)、旅客周转量(万人公里)、平均运距(公里)、运营车数(辆)、载客车次(车次)、站点(个)、单车次载客人数(人/车次)
公路旅客企业 h2031 客运车辆(辆)、载客位(座)、客运量(人)、周转量(人公里)、平均运距(公里)
货运企业 h2032 车辆(辆)、吨位/标记吨位/各类货运量(吨)、周转量(吨公里)、平均运距(公里)
货运量周转量(宽表) 货运量N月(万吨)、周转量N月(万吨公里)(含去年同月列)
规上规下拆分 规上/规下/合计周转量(万吨公里)、货运量(万吨)、排名(名)、同比(%)
运政车辆 / 轨迹里程 牵引车、挂车、其他车(辆)、吨位(吨)、月度里程(公里)、有里程车辆(辆)
旅客运政车辆 车辆数(辆)、载客位数(座)
个体客运 个体客运量(人)、个体旅客周转量(人公里)
投资 投资额(万元)、建筑面积(平方米)
能耗车辆/运政车辆 标记吨位(吨)、货运量(吨)、周转量(吨公里)、里程(公里)、车次(次);燃料类按填报燃料单位标注
网约车 订单数(单)、订单占比(%)、客运量(万人次)、旅客周转量(万人公里)

二、测试环境

  • 后端 start-dev.ps1(8090);前端 dev server(8080);MySQL localhost:3308/traffic_audit;账号 admin/123456;浏览器:Codex 内置浏览器真机。

三、用例表

3.1 接口用例

编号 输入 预期 实际 结论
TC-1 type=scaleSplit&period=2026-08 两种口径共 36 行 total=36 通过
TC-2 同上 &periodType=CUMULATIVE 仅累计 18 行 total=18 通过
TC-3 同上 &periodType=MONTH 仅当月 18 行 total=18 通过
TC-4 拆分表列名 带单位 规上货运量(万吨)、规上周转量(万吨公里)、规上排名(名)、规上同比(%) 通过
TC-5 type=transportAuth 列名 带单位 牵引车数(辆)、挂车吨位(吨)、其他吨位(吨) 通过
TC-6 type=freightTurnover 列名 带单位 货运量1月(万吨) … 周转量N月(万吨公里) 通过
TC-7 type=h2031 列名 带单位 客运车辆合计(辆)、核定载客位合计(座)、客运量合计(人)、周转量合计(人公里) 通过

3.2 真机用例

编号 输入 预期 实际 结论
TC-8 货运企业月报 表头带单位、冻结市州+企业名称 车辆数合计(辆)、标记吨位数合计(吨)…;冻结=市州、企业名称;工具栏无"口径" 通过
TC-9 规上规下拆分 工具栏出现口径筛选、口径列消失、空列消失 工具栏:报表期 / 数据类型 / 口径[全部];表头从"规上周转量(万吨公里)"开始(三列货运量不再出现) 通过

四、发现的问题与处置

  1. 拆分表三个货运量列**不能在页面上区分"空"与"零"**:源文件未提供该列,故显示为全空。本次按用户意见不展示;若业务需要,需先让填报方在模板中增加货运量列(导入已支持"扩展布局"自动识别)。
  2. "表头单位"以库内字段注释为准(如 h2032.freight_total 注释"货运量_总计(吨)");能耗表的燃料类字段(燃料消耗量、百公里油耗、周转量油耗)库内无单位注释,标注为"(按燃料单位)",未擅自写成升。
  3. 口径筛选默认"全部"(两种口径同屏),因为原有页面行为即如此;需要只看向上或累计时再切换。

五、结论

三项诉求全部落地并通过接口 + 真机用例:空列不再显示、口径上移为筛选(接口 periodType 参数)、12 类表表头全部带单位。原有筛选、冻结、格式化逻辑无回归。