fix(汇总表): 城市客运8月/累计同比取数修正（母版删AJ辅助列+按表头定位月份列）

zhizhijie

2026-09-20 2761abd2f50ae9f3838d0746b9817a30cb9fc13a

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

@@ -21,6 +21,26 @@
- é‡å¯å‰åŽç«¯åŠ è½½æ–°ä»£ç ï¼ˆåŽç«¯ `Started TrafficAuditApplication` 10:49:51）。
- é¡ºæ‰‹æ ¸å¯¹ï¼šå‰ä¸€æ™šã€Œåˆè®¡è¡Œè¢«å½“项目」修复后，客运本月完成投资由含合计行的 2130.1 æ”¶æ•›ä¸º **2048.1**，与 SQL é€é¡¹ä¸€è‡´ï¼›åº“内已无含「计」的伪项目行。

### 1.3 ä¿®å¤ï¼šæ±‡æ€»å¤§è¡¨ã€ŠåŸŽå¸‚客运》8 æœˆåŒæ¯” / ç´¯è®¡åŒæ¯”算错（母版删 AJ è¾…助列 + ç¨‹åºæŒ‰è¡¨å¤´å–数）

- **现象**：用户上报生成表城市客运 8 æœˆåŒæ¯” âˆ’86.5%、累计同比 âˆ’43.5%；且「2025å¹´1-7月累计」列在母版删过却仍在生成表里。
- **根因（3 ä¸ªï¼‰**：
  1. æ¯ç‰ˆæœ‰**两本**——用户删的是《2026å¹´7月道路运输量汇总表.xlsx》，而 8 æœˆå¯¼å‡ºç”¨çš„是《2026å¹´8月…》，
     åŽè€…城市客运页 2025 å¹´æ®µæ’了 AJ åˆ—「2025å¹´1-7月累计」，把 2025å¹´8月列挤到 AK，
     8 æœˆåŒæ¯” `=Q4/AJ4-1` å®žé™…是「8月值 Ã· 2025å¹´1-7月累计」；累计同比分母又把 1-6 æœˆé‡å¤è®¡ã€8 æœˆæ¼è®¡ã€‚
  2. æ–°å†™çš„列号换算 `colIndexOf()` è¿”回 1 åŸºåˆ—号，而 POI åˆ—号是 0 åŸº â†’ æœˆä»½åˆ—查表全落空、退化成「+2 åˆ—」，
     `=O5/AH5-1` è¢«ç®—成 `=R5/AK5-1`（自引用）→ è´§è¿/网约车/中口径明细 å…± 360 æ ¼å¾ªçŽ¯å¼•ç”¨ã€‚
  3. POI `setCellFormula` ä¸æŽ¥å—带 `=` å‰ç¼€çš„公式串，异常又被 `catch (Exception ignore)` åžæŽ‰ï¼Œ
     ç´¯è®¡åŒæ¯”分母修正一直静默失败（日志只显示「修正格数=0」）；另母版 3~8 æœˆè¡¨å¤´æ˜¯ 46235 è¿™ç±»è£¸åºåˆ— + General æ ¼å¼ï¼Œ
     åŽŸæŒ‰ `isCellDateFormatted` åˆ¤å®šä¼šæ¼åˆ¤ã€‚
- **处置**：
  1. æ¯ç‰ˆï¼šç”¨ Excel 16.0 COM åœ¨ã€Š2026å¹´8月道路运输量汇总表.xlsx》城市客运页整列删除 AJ（引用由 Excel è‡ªåŠ¨è°ƒæ•´ï¼Œ
     å¦‚ `W4` â†’ `=V4/AW4-1`），再把删列产生的 36 å¤„ `#REF!` ç´¯è®¡åŒæ¯”公式还原为 `AJ`；
     å¤‡ä»½ `_bak_202608母版删除AJ列前_20260920.xlsx`；删列后母版与版式参照件《生成_道路运输量汇总表.xlsx》列结构一致。
  2. ä»£ç ï¼š`colIndexOf` æ”¹ 0 åŸºï¼›`setCellFormula` åŽ»æŽ‰ `=` å‰ç¼€å¹¶æŠŠ catch æ”¹æˆ WARN æ—¥å¿—ï¼›
     `yearMonthOf` æ”¯æŒè£¸æ—¥æœŸåºåˆ—ï¼›`repairCumulativeYoyFormulas()` ä¿ç•™ä½œæ¯ç‰ˆå…œåº•ã€‚
  3. å‰ç«¯ï¼š`ReportExport.vue` é¢„览补齐货运量/城市客运/中口径共 8 é¡¹åŒæ¯”映射，修正「当月货物周转量(万吨)」单位。

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

《功能测试报告_投资明细表就绪与预览类型补齐_2026-09-20.md》：**7 æ¡ç”¨ä¾‹é€šè¿‡ï¼Œ1 æ¡æœªå®žæµ‹**（缺母版提示，未临时移动用户母版文件）。
@@ -35,16 +55,35 @@
| åŽŸæœ‰æŠ•èµ„类型回归 | investPlan / investBillion / investCounty / investFiveYearLogistics å‡ ready=true，rows=167 |
| æœªçŸ¥ç±»åž‹è´Ÿå‘ | `foo` â†’ ready=false、note=未知报表类型：foo（兜底仍有效） |

《功能测试报告_城市客运月度与累计同比_2026-09-20.md》：**15 æ¡ç”¨ä¾‹é€šè¿‡**。

| æ ¡éªŒé¡¹ | ç»“æžœ |
| --- | --- |
| åŸŽå¸‚客运 R4 / T4 å…¬å¼ | `=Q4/AJ4-1`、`=S4/(V4+X4+Z4+AB4+AD4+AF4+AH4+AJ4)-1`（不再是 `#REF!`） |
| å…¨çœå®¢è¿é‡ 8 æœˆåŒæ¯” / ç´¯è®¡åŒæ¯” | **+4.44% / +0.117%**（修复前 âˆ’86.5% / âˆ’43.5%） |
| è¾…助列 | ç”Ÿæˆè¡¨ä¸Žæ¯ç‰ˆå‡æ— ã€Œ2025å¹´1-7月累计」，城市客运页 BV→BU |
| å¾ªçŽ¯å¼•ç”¨ | å…¨è¡¨ 0 å¤„（修复前 360 å¤„，含货运/网约车/中口径明细 R åˆ—） |
| å…¶å®ƒ 18 ä¸ªé¡µç­¾å›žå½’ | é™¤ä¸Šè¿° R åˆ—修复外逐格一致 |
| é¢„览接口 | 24 é¡¹æŒ‡æ ‡å« 8 é¡¹åŒæ¯”，1.03 ç§’ |
| å¯¼å‡ºè€—æ—¶ | 14 ç§’（母版读取+回填 6.5s、公式重算 4.1s、写盘传输 3.4s） |

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

1. æ­¦æ±‰ç‰©æµé¡¹ç›®æ¸…单口径（已确认忽略）。
2. å¤©é—¨ç‰©æµæºæ–‡ä»¶ H/J/K ä¸ºç©º â†’ å¾…用户找同事要数据后导入。
3. è†å·ž/黄石「规划内/规划外」拆分口径 â†’ å¾…用户向同事确认。
4. C ç»„（城市客运页结构归一，需用户先在 WPS æ•´åˆ—删除 AJ åˆ—）／D ç»„（增速排名措辞）／B4（导出前基数体检 + å¼¹çª— + ã€Šæ•°æ®ç¼ºå¤±æ¸…单》页）待排期。
4. ~~C ç»„（城市客运页结构归一，需用户先在 WPS æ•´åˆ—删除 AJ åˆ—）~~ **已完成**（改用 Excel COM æ•´åˆ—删除 + å…¬å¼è¿˜åŽŸï¼‰ï¼›
   D ç»„（增速排名措辞）／B4（导出前基数体检 + å¼¹çª— + ã€Šæ•°æ®ç¼ºå¤±æ¸…单》页）待排期。
5. ç¼ºæ¯ç‰ˆæç¤ºï¼ˆT08）未实测，可在有测试副本时补测。
6. æ±‡æ€»å¤§è¡¨å¯¼å‡ºæ˜¯**同步请求**，当前约 14 ç§’（每次都要重算整本约 4 ä¸‡æ ¼å…¬å¼ï¼‰ï¼šæ•°æ®é‡å†æ¶¨ä¸»è¦æ˜¯ SQL èšåˆå˜æ…¢ï¼Œ
   ä¸ä¼šã€Œå¡æ­»ã€ï¼Œä½†å»ºè®®åŽç»­åšæˆå¼‚步任务 + è¿›åº¦æç¤ºã€‚
7. éƒ¨ç½²åŒ… `deploy/traffic-audit-deploy-20260913/backend/docs/生成汇总大表/` ä¸Ž `_deploytest/` ä¸‹ä»æ˜¯**带 AJ åˆ—的旧母版**，
   ä¸‹æ¬¡æ‰“包时需同步（未经用户确认不擅自改部署产物）。
8. ä¸­å£å¾„明细 4 æ ¼ï¼ˆåŸŽé™…城乡巡游出租/网约车）因 2025å¹´8月基数为 0，同比显示 `#DIV/0!`（不可比），如需改空白需用户确认口径。

## å››ã€æ˜Žæ—¥è®¡åˆ’

1. ç­‰å¤©é—¨æºæ•°æ® / è†å·žé»„石口径确认后补导并复验。
2. æŽ¨è¿› C/D ç»„与 B4。
3. ä¸Žç”¨æˆ·ç¡®è®¤æ˜¯å¦æŠŠ 09-18 å¤œé—´èµ·çš„本地提交一并推送到公司 gitea（用户 09-19 æ›¾è¦æ±‚「今天先不推公司」）。
4. è¯„估汇总大表导出异步化（长任务进度条 / ç»“果缓存），并确认部署包母版同步方式。