fix(报表): 补齐客运站/物流站场投资明细表的就绪校验与预览类型

zhizhijie

2026-09-20 b80bb7253a87931fea5a1a788fc4c6ffb204d245

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

@@ -2,63 +2,49 @@

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

### 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 å…¶å®ƒ

**用户指令**：「所有的数据都全部全精度保留，计算得到的结果显示两位小数。」

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

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

1. ã€Œæ•´æ•°ä¸æ˜¾ç¤º .00」的保护先把公式格跳过了，首轮改造后 `货运!EO90/EO93/EO108/EO111`
   ä»æ˜¯ `0.0000`（缓存值 0 è¢«åˆ¤ä¸ºæ•´æ•°ï¼‰â†’ æŠŠæ ¼å¼å½’一判断**提到整数保护之前**。
2. æ—§åˆ¤æ–­ `f.contains("0.00")` æŠŠ `0.000_ ` è¯¯åˆ¤ä¸ºã€Œå·²æ˜¯ä¸¤ä½å°æ•°ã€ï¼Œä¸­å£å¾„明细 134 æ ¼æ¼æ”¹
   â†’ æ”¹æ­£åˆ™åŽå½’零。
- é‡å¯å‰åŽç«¯åŠ è½½æ–°ä»£ç ï¼ˆåŽç«¯ `Started TrafficAuditApplication` 10:49:51）。
- é¡ºæ‰‹æ ¸å¯¹ï¼šå‰ä¸€æ™šã€Œåˆè®¡è¡Œè¢«å½“项目」修复后，客运本月完成投资由含合计行的 2130.1 æ”¶æ•›ä¸º **2048.1**，与 SQL é€é¡¹ä¸€è‡´ï¼›åº“内已无含「计」的伪项目行。

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

见《功能测试报告_全精度存储与两位小数显示_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（兜底仍有效） |

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

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 åˆ—）／D ç»„（增速排名措辞）／B4（导出前基数体检 + å¼¹çª— + ã€Šæ•°æ®ç¼ºå¤±æ¸…单》页）待排期。
5. ç¼ºæ¯ç‰ˆæç¤ºï¼ˆT08）未实测，可在有测试副本时补测。

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

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 æ›¾è¦æ±‚「今天先不推公司」）。