docs: 数据查看展示优化与网约车竖排功能测试报告 + 日结补充

zhizhijie

9 天以前 15c8035c5b9d490fad685f0665fbfaeec3220e5d

docs: 数据查看展示优化与网约车竖排功能测试报告 + 日结补充

 docs/¹¦ÄܲâÊÔ±¨¸æ/¹¦ÄܲâÊÔ±¨¸æ_Êý¾Ý²é¿´Õ¹Ê¾ÓÅ»¯ÓëÍøÔ¼³µ°´ÊÐÖÝÊúÅÅ_2026-09-22.md

New file
@@ -0,0 +1,74 @@
# åŠŸèƒ½æµ‹è¯•æŠ¥å‘Šï¼šæ•°æ®æŸ¥çœ‹å±•ç¤ºä¼˜åŒ–与网约车按市州竖排（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 ç‚¹å…¨éƒ¨å¤„理并通过真机用例：下拉分组标题样式、隐藏报表期/所属地区并收窄冻结列、拆分表空值与单位说明、网约车按市州竖排、市州月报项目名称、数值与百分比显示规范。底层数据精度未做任何改动。

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

@@ -44,10 +44,20 @@
- **左侧冻结标识列**：`renderColumns` æŒ‰è¡¨è‡ªé€‚应冻结 `报表期/所属地区/市州/企业名称` ç­‰å‰å¯¼åˆ—（此实现 09:56 å·²è½åœ¨å·¥ä½œåŒºä½†æœªæäº¤ï¼Œæœ¬æ¬¡çœŸæœºéªŒè¯åŽä¸€å¹¶æäº¤ï¼‰ã€‚
- **跨期汇总口径定稿**：流量列求和、时点列不参与汇总且不显示、比率列按累计口径重算。

### 6. æ•°æ®æŸ¥çœ‹å±•ç¤ºä¼˜åŒ–（第三轮，用户复核反馈 4 ç‚¹ï¼‰

- **下拉分组标题**：改成 13px/700/深色+浅底（原为 Element UI é»˜è®¤ 12px ç°å­—），`popper-class` ç²¾ç¡®å‘½ä¸­ï¼›
- **隐藏报表期与所属地区**，冻结区收窄为"市州/地区 + ä¼ä¸šåç§°/项目名称 + å£å¾„"（最多 3 åˆ—）；后端为企业类表（h2032/h2031/h204 è½¦è¾†èƒ½è€—）补派生市州列；
- **规上规下拆分空值定性**：源文件《模板_规上规下拆分运输量.xlsx》只有"周转量"列，无货运量列 â†’ ä¸‰åˆ—空属源数据形态；周转量单位核对为**万吨公里**（1,235,760.72×10000=12,357,607,239 å¨å…¬é‡Œï¼Œä¸Ž h2032 æ­¦æ±‰ 1-6 æœˆå®Œå…¨ä¸€è‡´ï¼‰ï¼›åˆ—名已标注单位；
- **网约车订单改按市州竖排**：地区（全省+17 å¸‚州）נ指标（期间/订单数/订单占比/客运量/旅客周转量/城市内两项/说明）；客运量与周转量复用 `WycSplitCalc` æ‹†åˆ†å£å¾„，全省行取台账 pin；
- **市州月报进度**：连 `investment_project` è¡¥é¡¹ç›®åç§°ä¸Žå¸‚州（原表只有 project_id，页面显示数字无法辨识）；
- **数值显示规范**：底层全精度不变，显示层千分位+两位小数、比率类转百分比、排名字段整数。

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

- æŠ¥å‘Šï¼š`docs/功能测试报告/功能测试报告_数据查看补齐网约车与个体客运类型_2026-09-22.md`
- æŠ¥å‘Šï¼š`docs/功能测试报告/功能测试报告_数据查看冻结列与数据类型下拉框_2026-09-22.md`（冻结列/下拉框真机用例 12 æ¡å…¨é€šè¿‡ï¼‰
- æŠ¥å‘Šï¼š`docs/功能测试报告/功能测试报告_数据查看展示优化与网约车按市州竖排_2026-09-22.md`（接口 6 æ¡ + çœŸæœº 6 æ¡å…¨é€šè¿‡ï¼‰
- æŠ¥å‘Šï¼š`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 ç±»å›žå½’正常。