docs: 数据查看按市州汇总与导出功能测试报告 + 日结

zhizhijie

9 天以前 7594035c7d81d5c800f09cba73e539091d6b1631

docs: 数据查看按市州汇总与导出功能测试报告 + 日结

 docs/¹¦ÄܲâÊÔ±¨¸æ/¹¦ÄܲâÊÔ±¨¸æ_Êý¾Ý²é¿´°´ÊÐÖÝ»ã×ÜÓëµ¼³ö_2026-09-22.md

New file
@@ -0,0 +1,59 @@
# åŠŸèƒ½æµ‹è¯•æŠ¥å‘Šï¼šæ•°æ®æŸ¥çœ‹ã€ŒæŒ‰å¸‚州汇总 + å¯¼å‡º Excel」（2026-09-22）

> æ—¥æœŸï¼š2026-09-22　模块：数据查看（后端 CityRollupService/DataViewController + å‰ç«¯ DataView.vue）　测试人：Codex
> å£å¾„依据：2026-09-22 ç”¨æˆ·ç¡®è®¤â€”—起止月任意选、累计同比带上年同期、排名字段可选（留空/按累计值重排）、不放时点列。

## ä¸€ã€åŠŸèƒ½è¯´æ˜Ž

1. **入口**：数据查看工具栏加「视图：明细 / æŒ‰å¸‚州汇总」切换（仅对有市州维度的类型出现）。
2. **汇总条件**：起止月（任意区间，年初至 N æœˆå³ 01~N）、排名口径（留空 / æŒ‰ç´¯è®¡å€¼é‡æŽ’）、汇总、导出 Excel。
3. **结果**：17 ä¸ªå¸‚州（RegionUtil è§„范名与顺序）+「全省合计」行。
4. **口径规则**：
   - æµé‡ç±»ï¼ˆå®¢è¿é‡/周转量/货运量/订单数）→ è·¨æœŸæ±‚和；
   - **时点类（车辆数、企业数、站点数）不参与汇总，不出现在结果中**；
   - æ¯”率类按累计口径重算：累计同比 = æœ¬æœŸç´¯è®¡ Ã· ä¸Šå¹´åŒæœŸç´¯è®¡ âˆ’ 1；平均运距 = ç´¯è®¡å‘¨è½¬é‡ Ã· ç´¯è®¡å®¢è¿é‡ï¼›
   - æŽ’名默认留空；选「按累计值重排」时按累计值降序给名次，全省合计行不排名；
   - åˆè®¡è¡Œç”± 17 å¸‚州相加（"湖北省"等合计行不计入，避免重复）。
5. **接口**：`GET /api/data/rollupTypes`（支持汇总的类型）、`GET /api/data/summary`、`GET /api/data/export`（xlsx，数值全精度、显示 2 ä½å°æ•° / ç™¾åˆ†æ¯”）。
6. **支持类型（7 ç±»ï¼‰**：`cityBus`、`cityTaxi`、`h2032`、`h2031`、`passengerIndividual`、`wycOrder`（拆分口径）、`freightTurnover`。

## äºŒã€æµ‹è¯•çŽ¯å¢ƒ

后端 `mvn spring-boot:run`（8090，`Started TrafficAuditApplication`）；前端 8080；MySQL `localhost:3308/traffic_audit`；账号 admin/123456；浏览器：Codex å†…置浏览器真机。

## ä¸‰ã€ç”¨ä¾‹è¡¨

### 3.1 æŽ¥å£ç”¨ä¾‹

| ç¼–号 | è¾“å…¥ | é¢„期 | å®žé™… | ç»“论 |
| --- | --- | --- | --- | --- |
| TC-1 | `rollupTypes` | è¿”回 7 ä¸ªç±»åž‹ | cityBus/cityTaxi/h2032/h2031/passengerIndividual/wycOrder/freightTurnover | é€šè¿‡ |
| TC-2 | å…¬äº¤ 2026-01~08 | ä¸Žæ‰‹å·¥æ ¸ç®—一致 | å…¨çœåˆè®¡å®¢è¿é‡ 110776.34 ä¸‡äººæ¬¡ã€å‘¨è½¬é‡ 738254.64 ä¸‡äººå…¬é‡Œã€å¹³å‡è¿è· 6.66 å…¬é‡Œã€ç´¯è®¡åŒæ¯” âˆ’3.07%；武汉客运量 36935.38（与 SQL é€æœˆç›¸åŠ ä¸€è‡´ï¼‰ | é€šè¿‡ |
| TC-3 | å…¬äº¤ 2026-03~06 | åŒºé—´ç´¯è®¡ | å…¨çœåˆè®¡ 59060.71 ä¸‡äººæ¬¡ï¼ˆ= 3~6 æœˆé€æœˆç›¸åŠ ï¼‰ | é€šè¿‡ |
| TC-4 | è´§è¿ä¼ä¸š h2032 2026-01~08 | ä¸Ž SQL ä¸€è‡´ | å…¨çœåˆè®¡è´§è¿é‡ 313,998,248 å¨ã€å‘¨è½¬é‡ 49,271,617,743 å¨å…¬é‡Œã€å¹³å‡è¿è· 156.92 å…¬é‡Œã€åŒæ¯” âˆ’17.37% | é€šè¿‡ |
| TC-5 | è´§è¿é‡å‘¨è½¬é‡ 2026-01~08 | 17 å¸‚州之和（排除"湖北省"行） | 130,311.89 ä¸‡å¨ï¼Œä¸Ž SQL ç›´æŸ¥ 17 å¸‚州之和完全一致（修复前误把"湖北省"行与区间重复叠加，曾得到 1,149,579） | é€šè¿‡ |
| TC-6 | åŒä¸Š `to=2026-09`（该月无数据） | è‡ªåŠ¨å›žé€€åˆ°æœ€æ–°æœ‰æ•°æœˆä»½ | ç»“果与 01~08 ä¸€è‡´ï¼›æœŸé—´æ ‡ç­¾ä»æ˜¾ç¤ºè¯·æ±‚区间 | é€šè¿‡ |
| TC-7 | æŽ’名 `rankMode=blank` | æŽ’名列为空 | ç©ºï¼ˆæ˜¾ç¤º `-`） | é€šè¿‡ |
| TC-8 | æŽ’名 `rankMode=recompute` | æŒ‰ç´¯è®¡å€¼é™åº | è´§è¿é‡ï¼šæ­¦æ±‰ 1、宜昌 3、黄石 9、十堰 12；全省合计行留空 | é€šè¿‡ |
| TC-9 | ç½‘约车 2026-01~08 | æ‹†åˆ†å£å¾„合计 | å…¨çœåˆè®¡è®¢å• 208,229,132 å•ã€å®¢è¿é‡ 33864.94 ä¸‡äººæ¬¡ | é€šè¿‡ |
| TC-10 | `export`（公交 2026-01~08） | ç”Ÿæˆ xlsx | 5,773 å­—节，可正常打开、含表头与合计行 | é€šè¿‡ |

### 3.2 çœŸæœºç”¨ä¾‹

| ç¼–号 | è¾“å…¥ | é¢„期 | å®žé™… | ç»“论 |
| --- | --- | --- | --- | --- |
| TC-11 | æ•°æ®æŸ¥çœ‹é€‰"道路货物运输月度生产情况" | å‡ºçŽ°ã€Œè§†å›¾ã€åˆ‡æ¢ | å·¥å…·æ ï¼šæŠ¥è¡¨æœŸ / æ•°æ®ç±»åž‹ / è§†å›¾ | é€šè¿‡ |
| TC-12 | åˆ‡åˆ°"按市州汇总" | å‡ºçŽ°èµ·æ­¢æœˆã€æŽ’名、汇总、导出 | å·¥å…·æ ï¼šæ•°æ®ç±»åž‹ / è§†å›¾ / èµ·æ­¢æœˆ / æŽ’名；按钮：汇总、导出 Excel | é€šè¿‡ |
| TC-13 | æ‰§è¡Œæ±‡æ€» | 18 è¡Œã€å¸‚州冻结、口径提示 | 18 è¡Œï¼›å†»ç»“列=市州；提示"共 18 æ¡è®°å½• | é“路货物运输企业（按市州汇总） 2026-01 ~ 2026-09 ç´¯è®¡ï¼›åŒæ¯”基数 2025-01 ~ 2025-09；排名口径：留空"；全省合计 313,998,248 å¨ / 49,271,617,743 å¨å…¬é‡Œ | é€šè¿‡ |
| TC-14 | æ•°å€¼æ˜¾ç¤º | åƒåˆ†ä½ + 2 ä½å°æ•° + åŒæ¯”百分比 | 100,729,811 / 16,328,908,098 / 162.11 / âˆ’24.39% | é€šè¿‡ |

## å››ã€å‘现的问题与处置

1. **货运量周转量表口径坑**：该表每行是"年初至当期"的行内累计（行内含各月列），跨期再叠加会重复计算；且表内"湖北省"行等于 17 å¸‚州之和。已改为只取区间内最新一期那一行、对区间月份求和，并显式排除非市州行 â†’ ç”± 1,149,579 ä¿®æ­£ä¸º 130,311.89 ä¸‡å¨ï¼ˆä¸Žç›´æŸ¥ä¸€è‡´ï¼‰ã€‚
2. ç»“束月无数据（如 2026-09）时自动回退到最新有数月份，避免出现全 0 è¡Œã€‚
3. æ±‡æ€»æ¨¡å¼ä¸‹"报表期/关键字"输入框隐藏（由起止月承担期间条件），避免两套期间条件并存。
4. æŽ’名口径默认"留空"；开启重排后按累计值降序，全省合计行不参与排名。

## äº”、结论

「按市州汇总 + å¯¼å‡º Excel」按用户确认的口径完成并通过 10 æ¡æŽ¥å£ç”¨ä¾‹ + 4 æ¡çœŸæœºç”¨ä¾‹ï¼›ä¸Žæ‰‹å·¥/SQL æ ¸ç®—逐项一致。时点列不参与汇总、比率按累计重算、排名可选，导出保留全精度。

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

@@ -60,19 +60,29 @@
- **表头补单位**：12 ç±»è¡¨ 60 ä½™åˆ—按库内注释/源文件核对补齐（万人次、万人公里、吨、吨公里、万吨、万吨公里、人、人公里、辆、座、公里、车次、万元、平方米、名、%）；
  èƒ½è€—燃料三项库内无单位注释，标注"(按燃料单位)"未臆造。

### 8. æ•°æ®æŸ¥çœ‹ã€ŒæŒ‰å¸‚州汇总 + å¯¼å‡º Excel」落地（第五轮，主线功能）

- æ–°å¢ž `CityRollupService` + ä¸‰ä¸ªæŽ¥å£ï¼š`/api/data/rollupTypes`、`/api/data/summary`、`/api/data/export`；
- æ”¯æŒ 7 ç±»ï¼šå…¬äº¤ã€å·¡æ¸¸å‡ºç§Ÿã€è´§è¿ä¼ä¸šã€å…¬è·¯æ—…客企业、个体客运、网约车（拆分口径）、货运量周转量；
- å£å¾„：任意起止月；流量求和、**时点列不参与**、比率按累计重算（累计同比自动取上年同期）；排名可选「留空 / æŒ‰ç´¯è®¡å€¼é‡æŽ’」；结果 = 17 å¸‚å·ž + å…¨çœåˆè®¡ï¼›
- å‰ç«¯ï¼šå·¥å…·æ åŠ ã€Œè§†å›¾ï¼šæ˜Žç»† / æŒ‰å¸‚州汇总」，汇总模式提供起止月、排名、汇总、导出 Excel；
- ä¿®å¤ä¸¤ä¸ªå£å¾„坑：货运量周转量表的"行内累计 + æ¹–北省合计行"重复计算（1,149,579 â†’ 130,311.89 ä¸‡å¨ï¼‰ã€ç»“束月无数据自动回退；
- ä¸Žæ‰‹å·¥æ ¸ç®—一致：公交 1-8 æœˆ 110776.34 ä¸‡äººæ¬¡ã€è´§è¿ä¼ä¸š 313,998,248 å¨ã€è´§è¿é‡å‘¨è½¬é‡ 130,311.89 ä¸‡å¨ã€‚

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

- æŠ¥å‘Šï¼š`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`（接口 10 æ¡ + çœŸæœº 4 æ¡å…¨é€šè¿‡ï¼‰
- æŠ¥å‘Šï¼š`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 ç±»å›žå½’正常。

## ä¸‰ã€é—留问题与待办

1. ã€ä¸‹ä¸€æ­¥ä¸»ä½“工作】数据查看"按市州汇总"：任意起止月（年初至 N æœˆå³ 01~N）+ 17 å¸‚å·ž + åˆè®¡è¡Œï¼›**不放时点列**；比率列按累计口径重算；并支持导出 Excel。
1. ã€å·²å®Œæˆã€‘数据查看"按市州汇总 + å¯¼å‡º Excel"（见第 8 èŠ‚与《功能测试报告_数据查看按市州汇总与导出_2026-09-22.md》）。
2. æ±‡æ€»å£å¾„细则待业务确认：排名字段跨期需重新排名（先留空）；累计同比需要自动取上年同期期间。
3. å…³é”®å­—框对无名称列的表（网约车总数、网约车订单）无效，待优化。
4. å†»ç»“列依赖"标识列连续排在前面"的列序假设，若以后调整列序/新增类型需同步维护 `stickyProps`/`nameProps`。