docs: 数据查看口径筛选与表头单位功能测试报告 + 日结补充

zhizhijie

9 天以前 336695c5449cbf5d526b89622c24c9c6b590baab

docs: 数据查看口径筛选与表头单位功能测试报告 + 日结补充

 docs/¹¦ÄܲâÊÔ±¨¸æ/¹¦ÄܲâÊÔ±¨¸æ_Êý¾Ý²é¿´¿Ú¾¶É¸Ñ¡Óë±íÍ·µ¥Î»_2026-09-22.md

New file
@@ -0,0 +1,61 @@
# åŠŸèƒ½æµ‹è¯•æŠ¥å‘Šï¼šæ•°æ®æŸ¥çœ‹å£å¾„筛选、空列隐藏与表头单位（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 ç±»è¡¨è¡¨å¤´å…¨éƒ¨å¸¦å•ä½ã€‚原有筛选、冻结、格式化逻辑无回归。

 docs/¹¤×÷ÈÕ½á/¹¤×÷ÈÕ½á_2026-09-22.md

@@ -53,11 +53,19 @@
- **市州月报进度**：连 `investment_project` è¡¥é¡¹ç›®åç§°ä¸Žå¸‚州（原表只有 project_id，页面显示数字无法辨识）；
- **数值显示规范**：底层全精度不变，显示层千分位+两位小数、比率类转百分比、排名字段整数。

### 7. æ•°æ®æŸ¥çœ‹ï¼šå£å¾„上移筛选、空列隐藏、表头补单位（第四轮）

- **空列不显示**：拆分表"规上/规下/合计货运量"（源文件未提供、库内全空）不再展示，字段保留；
- **口径上移**：拆分表"口径"从表格列改为工具栏下拉（全部/当月/累计），后端 `/api/data/list` æ–°å¢ž `periodType` å‚数；切换类型自动复位；
- **表头补单位**：12 ç±»è¡¨ 60 ä½™åˆ—按库内注释/源文件核对补齐（万人次、万人公里、吨、吨公里、万吨、万吨公里、人、人公里、辆、座、公里、车次、万元、平方米、名、%）；
  èƒ½è€—燃料三项库内无单位注释，标注"(按燃料单位)"未臆造。

## äºŒã€æµ‹è¯•ç»“果摘要

- æŠ¥å‘Šï¼š`docs/功能测试报告/功能测试报告_数据查看补齐网约车与个体客运类型_2026-09-22.md`
- æŠ¥å‘Šï¼š`docs/功能测试报告/功能测试报告_数据查看冻结列与数据类型下拉框_2026-09-22.md`（冻结列/下拉框真机用例 12 æ¡å…¨é€šè¿‡ï¼‰
- æŠ¥å‘Šï¼š`docs/功能测试报告/功能测试报告_数据查看展示优化与网约车按市州竖排_2026-09-22.md`（接口 6 æ¡ + çœŸæœº 6 æ¡å…¨é€šè¿‡ï¼‰
- æŠ¥å‘Šï¼š`docs/功能测试报告/功能测试报告_数据查看口径筛选与表头单位_2026-09-22.md`（接口 7 æ¡ + çœŸæœº 2 æ¡å…¨é€šè¿‡ï¼‰
- æŠ¥å‘Šï¼š`docs/功能测试报告/功能测试报告_汇总大表进度弹窗优化_2026-09-22.md`（6 æ¡ç”¨ä¾‹é€šè¿‡ï¼šç”Ÿæˆä¸­çŠ¶æ€ / å®Œæˆæç¤º / å†æ¬¡ä¸‹è½½èµ°ç¼“å­˜ / å…³é—­ / æ— æŽ§åˆ¶å°æŠ¥é”™ / å…¶å®ƒå¯¼å‡ºæœªå—影响）
- çŽ¯å¢ƒï¼šåŽç«¯ `mvn spring-boot:run`（8090，`Started TrafficAuditApplication`）；前端 `npm run serve`（8080，`Compiled successfully in 4769ms`）；MySQL `localhost:3308/traffic_audit`；登录 admin/123456 å– JWT。
- ç»“果：3 ä¸ªæ–°ç±»åž‹æ­£å‘（含期间/关键字筛选）、负向（未知类型、无数据期、无 token）全部通过；入库抽查条数与库内一致（20 / 20 / 139）；原有 15 ç±»å›žå½’正常。