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

zhizhijie

2026-09-20 2761abd2f50ae9f3838d0746b9817a30cb9fc13a

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

@@ -2,63 +2,88 @@

## ä¸€ã€ä»Šå¤©åšäº†ä»€ä¹ˆ

### 1. å›žç­”用户核对差异的疑问（承接 09-19）
### 1.1 ä¿®å¤ï¼šæŠ¥è¡¨ç”Ÿæˆé¡µä¸¤å¼ æŠ•èµ„明细表报「未知报表类型」

用户把人工算的一列放进桌面《生成_道路运输量汇总表 (1).xlsx》，问差异原因。
用户追问「是不是取数维度不对造成的——程序直接加『城际城乡』，人工用『总量−城市内』」——
**是的，正是这个原因**，已在 09-19 ä¿®å¤å¹¶æŽ¨é€ï¼ˆé—®é¢˜è®°äºŽã€ŠåŠŸèƒ½æµ‹è¯•æŠ¥å‘Š_中口径排名周转量口径统一_2026-09-19.md》）。
- **现象**：报表生成页「客运站投资明细表」「物流站场投资明细」显示
  `未知报表类型：investPassengerDetail / investLogisticsDetail`，无法预览/导出。
- **定位**：报错来自 `ReportExportService.checkExportReady()` çš„ `switch (t)` å…œåº•åˆ†æ”¯ï¼ˆ`ReportExportService.java:231`）。
  å‰ä¸€æ™šåªæŠŠè¿™ä¸¤ä¸ªç±»åž‹æŽ¥è¿›**导出**链路（`exportSelected` switch、`REPORT_FILE_NAMES`、`ReportExportController` ä¸¤ä¸ªæŽ¥å£ã€`ReportExport.vue` ä¸¤é¡¹ï¼‰ï¼Œ
  æ¼äº†**就绪校验与预览**链路，`isInvestType()` ä¹Ÿæ²¡æ”¶å½•è¿™ä¸¤ä¸ªç±»åž‹ã€‚
- **与数据无关**：8 æœˆæŠ•èµ„月报一直在库（客运站场 39 è¡Œã€ç‰©æµå›­åŒº 128 è¡Œï¼‰ã€‚
- **修复**：
  1. `checkExportReady()` æ–°å¢žä¸¤ä¸ª case：按类别统计 `investment_monthly` è¯¥æœŸè¡Œæ•° + æ ¡éªŒ `docs/投资/模板/` æ¯ç‰ˆæ˜¯å¦å­˜åœ¨ï¼ˆç¼ºæ¯ç‰ˆç»™æç¤ºï¼‰ï¼›
  2. `isInvestType()` æ”¶å½•ä¸¤ä¸ªç±»åž‹ï¼ˆçº³å…¥æŠ•èµ„分支的月度覆盖与问题清单）；
  3. `investPreview()` å¢žåŠ æŒ‰ç±»åˆ«è¿‡æ»¤é‡è½½ `(period, mode, category, summary, problems)`，原无参重载保留；
  4. é¢„览循环按类型分派到对应类别；未知类型兜底报错保持不变。

### 2. å…¨ç²¾åº¦å­˜å‚¨ + ä¸¤ä½å°æ•°æ˜¾ç¤ºæ”¹é€ ï¼ˆä»Šå¤©ä¸»ä»»åŠ¡ï¼‰
### 1.2 å…¶å®ƒ

**用户指令**：「所有的数据都全部全精度保留，计算得到的结果显示两位小数。」
- é‡å¯å‰åŽç«¯åŠ è½½æ–°ä»£ç ï¼ˆåŽç«¯ `Started TrafficAuditApplication` 10:49:51）。
- é¡ºæ‰‹æ ¸å¯¹ï¼šå‰ä¸€æ™šã€Œåˆè®¡è¡Œè¢«å½“项目」修复后，客运本月完成投资由含合计行的 2130.1 æ”¶æ•›ä¸º **2048.1**，与 SQL é€é¡¹ä¸€è‡´ï¼›åº“内已无含「计」的伪项目行。

- **去预舍入**：`ReportExportService.java` åŽ»æŽ‰ 40 å¤„写入前的 `round(...)`——
  è´§è¿è§„上/规下/同比（累计与当月）、`÷10000` å•ä½æ¢ç®—（省/市 Ã— æœˆ/累计四处）、
  ä¸­å£å¾„排名/分析写入、排名页占比（`setFreightShare`、货运量排名/周转量排名块）、
  é€šç”¨æ•°æ®æ ¼ `setDataCell`、平均运距兜底、客运转运写入、投资进度、物流占比、投资计划万吨；
  `WycSplitCalc.java` å¹³å‡è¿è·å…œåº•æ”¹å…¨ç²¾åº¦å¹¶åˆ é™¤å·²æ— å¼•ç”¨çš„私有 `round`。
- **展示位数交给单元格格式**：重写 `applyTwoDecimalFormat()`
  â€”—数值格统一 `0.00`（保留 `;[Red]\(...\)` ç­‰å‰åŽç¼€ï¼‰ï¼Œ**3 ä½åŠä»¥ä¸Šå°æ•°çš„格式**（`0.000_ `、`0.0000`）
  ç”¨æ­£åˆ™ `\.0{3,}` æ”¶æ•›ä¸ºä¸¤ä½ï¼›ç™¾åˆ†æ¯”/日期/科学计数/文本格式不动；整数值沿用「不显示 .00」约定。
- æŽ§åˆ¶å°é¢„览摘要里的 `round` ä¿ç•™ï¼ˆä¸è¿›æŠ¥è¡¨æ•°æ®ï¼‰ã€‚
### 1.3 ä¿®å¤ï¼šæ±‡æ€»å¤§è¡¨ã€ŠåŸŽå¸‚客运》8 æœˆåŒæ¯” / ç´¯è®¡åŒæ¯”算错（母版删 AJ è¾…助列 + ç¨‹åºæŒ‰è¡¨å¤´å–数）

**过程中修掉的两个自作聪明的坑**（均已在测试报告「四、发现的问题与处置」留证）：

1. ã€Œæ•´æ•°ä¸æ˜¾ç¤º .00」的保护先把公式格跳过了，首轮改造后 `货运!EO90/EO93/EO108/EO111`
   ä»æ˜¯ `0.0000`（缓存值 0 è¢«åˆ¤ä¸ºæ•´æ•°ï¼‰â†’ æŠŠæ ¼å¼å½’一判断**提到整数保护之前**。
2. æ—§åˆ¤æ–­ `f.contains("0.00")` æŠŠ `0.000_ ` è¯¯åˆ¤ä¸ºã€Œå·²æ˜¯ä¸¤ä½å°æ•°ã€ï¼Œä¸­å£å¾„明细 134 æ ¼æ¼æ”¹
   â†’ æ”¹æ­£åˆ™åŽå½’零。
- **现象**：用户上报生成表城市客运 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》：18 æ¡ç”¨ä¾‹ï¼ˆ11 æ­£å‘ / 4 å›žå½’ / 3 è¾¹ç•Œ / 1 è´Ÿå‘挂起）通过。
《功能测试报告_投资明细表就绪与预览类型补齐_2026-09-20.md》：**7 æ¡ç”¨ä¾‹é€šè¿‡ï¼Œ1 æ¡æœªå®žæµ‹**（缺母版提示，未临时移动用户母版文件）。

- ç¼–译通过；22 ä¸ªå¯¼å‡ºæŽ¥å£å›žå½’，21 ä¸ª OK（`wycSplit` å› ç¼º `docs\网络客运` è¾“入目录 500，属既有问题）。
- æ”¹å‰ vs æ”¹åŽã€Šé“路运输量汇总表》逐格对比 66205 ä¸ªæ•°å€¼æ ¼ï¼š**仅 249 æ ¼å˜åŒ–**，最大 0.00022 ä¸‡äººå…¬é‡Œï¼›
  ä¸¤ä½å°æ•°å£å¾„的不一致格 **0**；错误值数量 589 æ— å˜åŒ–。
- å…³é”®å€¼ï¼šæ­¦æ±‰ç´¯è®¡å‘¨è½¬é‡ 152330.8912（全精度 152330.89119999998）、孝感 64429.944543113306 ä¸å†è¢«æˆªæ–­æˆ 64429.9445。
- **09-19 é—留的「全省行 0.0002 ä¸‡äººå…¬é‡Œã€å·²æ¶ˆé™¤**：市州全精度后母版 `=SUM(O4:O20)` ä¸Žæ˜Žç»†æ±‚和逐位闭合（差 0.0）。
- æ ¼å¼ï¼šæœ‰å€¼æ•°å€¼/公式格中 3 ä½ä»¥ä¸Šå°æ•°æ ¼å¼ **108 æ ¼ â†’ 0 æ ¼**（汇总大表）、**134 æ ¼ â†’ 0 æ ¼**（中口径明细），
  15 ä¸ªäº§ç‰©åˆè®¡ 0 æ ¼ã€‚
| æ ¡éªŒé¡¹ | ç»“æžœ |
| --- | --- |
| `/api/report/ready`（两新类型） | ready=true，rows=39 / 128，note ä¸ºç©º |
| `/api/report/preview`（两新类型） | è¦†ç›– [8]，problems ä¸ºç©º |
| æ‘˜è¦ vs SQL é€é¡¹å¯¹é½ | å®¢è¿ `2048.1 / 38648.16 / 550929.76`、物流 `90185.9 / 704107.7 / 2656354.31`，**一致** |
| åˆ†ç±»åˆ«è¿‡æ»¤ | å®¢è¿ 39 + ç‰©æµ 128 = 167，全类别类型仍 167（未串类） |
| å¯¼å‡ºå›žå½’ | ä¸¤å¼ æ˜Žç»†è¡¨ä»å¯å¯¼å‡ºï¼ˆ29462 / 134144 å­—节） |
| åŽŸæœ‰æŠ•èµ„类型回归 | 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. **母版排名页 Q/R å æ¯”公式仍是 `=ROUND(B/L*10,1)`**（货运量排名 Q4:Q42、货运周转量排名 Q5:Q44，共 72 æ ¼ï¼‰ã€‚
   ç¨‹åºä¸è¦†å†™å…¬å¼æ ¼ï¼ŒExcel æ‰“开会重算回 1 ä½å†æŒ‰ `0.00` å±•ç¤ºã€‚若要彻底全精度，需把三个母版改成 `=B/L*10`（R åˆ— `=10-Q`）——**待用户拍板**。
2. ä»å¸¦ 4 ä½å°æ•°æ ¼å¼çš„ 274 æ ¼ä¸ºç©ºå€¼/文本格（无显示值），本次不动；若后续要在这些格填数再评估。
3. `wycSplit` æŽ¥å£ä¾èµ– `docs\网络客运\网络约车（全省）汇总.xlsx`，该目录当前不存在，导出报 500，待补输入。
4. 09-19 çš„遗留项（用户表 O åˆ—高速运距同比来源、545 å®¶ vs å…¨å£å¾„上报选择）仍未闭环。
1. æ­¦æ±‰ç‰©æµé¡¹ç›®æ¸…单口径（已确认忽略）。
2. å¤©é—¨ç‰©æµæºæ–‡ä»¶ H/J/K ä¸ºç©º â†’ å¾…用户找同事要数据后导入。
3. è†å·ž/黄石「规划内/规划外」拆分口径 â†’ å¾…用户向同事确认。
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. æŒ‰ç”¨æˆ·åé¦ˆå†³å®šæ˜¯å¦è¿žæ¯ç‰ˆ Q/R å æ¯”公式一起去掉 `ROUND(...,1)`。
2. è‹¥ç”¨æˆ·æœ‰å…¶ä»–表的显示位数要求，按同一套「全精度写入 + æ ¼å¼æŽ§åˆ¶å±•ç¤ºã€è§„则处理。
3. è¡¥é½ `docs\网络客运` è¾“入后回归 `wycSplit` å¯¼å‡ºã€‚

---

**本次改动文件**

- `traffic-audit-server/src/main/java/com/trafficaudit/reportexport/service/ReportExportService.java`
- `traffic-audit-server/src/main/java/com/trafficaudit/reportexport/calc/WycSplitCalc.java`
- æ–‡æ¡£ï¼š`docs/功能测试报告/功能测试报告_全精度存储与两位小数显示_2026-09-20.md`、本文件
1. ç­‰å¤©é—¨æºæ•°æ® / è†å·žé»„石口径确认后补导并复验。
2. æŽ¨è¿› C/D ç»„与 B4。
3. ä¸Žç”¨æˆ·ç¡®è®¤æ˜¯å¦æŠŠ 09-18 å¤œé—´èµ·çš„本地提交一并推送到公司 gitea（用户 09-19 æ›¾è¦æ±‚「今天先不推公司」）。
4. è¯„估汇总大表导出异步化（长任务进度条 / ç»“果缓存），并确认部署包母版同步方式。