docs(核对): 货运页签累计列定位（2021累计列母版缺失/2022写死常量）+ 9/16 导入数据体检（H2032 2026-09 期次错误、H...

zhizhijie

2026-09-16 27574bc4462a11c08bb909eb86dd00f9f564a6f1

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

@@ -172,3 +172,68 @@
- æäº¤ `e7cddc4`：`fix(report): é¢„览弹窗行数文案按报表类型区分`（4 ä¸ªæ–‡ä»¶ï¼Œ+25/-1）。
- æŽ¨ä¸ªäººä»“库 `origin`：`git push origin main:master` æˆåŠŸï¼ˆ`b0c8b4f..e7cddc4`）。
- æŽ¨å…¬å¸ `gitea`：`git fetch gitea` ä»å¤±è´¥ï¼ŒæŠ¥ `fatal: unable to access ... Recv failure: Connection was reset`（`fetch_exit=128`），本次**未推送成功**，继续列为遗留问题；补推前先 `git fetch gitea` ä¸Žè¿œç«¯ `main` åˆå¹¶ï¼Œ**禁强推**。

## åä¸ƒã€ç”¨æˆ·ç¬¬ 5 æ¡ï¼šæ±‡æ€»å¤§è¡¨ä¸Ž 8 æœˆå®šç¨¿é€è¡¨æ¯”对

**比对对象**：`D:\桌面\生成_道路运输量汇总表.xlsx`（用户 14:39 å¯¼å‡ºï¼‰ vs `D:\05_数据分类\汇总表\8月汇总定稿\2026å¹´8月客运量、货运量定稿.xlsx`。重新导出一次（`GET /api/report/export/summaryWorkbook?period=2026-08&mode=month`）得到的文件与桌面那份**字节数完全一致（950,186）**，排除“文件过期”。

**踩的坑（重要）**：
1. ä¸¤è¾¹**行块高度不同**（导出每市州 6 è¡Œã€å®šç¨¿ 4 è¡Œï¼›å¯¼å‡º 118 è¡Œ vs å®šç¨¿ 84 è¡Œï¼‰ï¼Œç›´æŽ¥æŒ‰å•å…ƒæ ¼åæ ‡æ¯”会得出 4.6 ä¸‡ä¸ªâ€œå·®å¼‚”，全是错位噪声 â†’ æ”¹ç”¨ã€Œåœ°åŒº+指标+列标题」**语义键**对齐。
2. å¯¼å‡ºç«¯æœ‰ **39,939 ä¸ªå…¬å¼æ ¼**（`=C7+C9`、`=C5/V5-1`、`RANK(...)`），`openpyxl(data_only=True)` è¯»å‡ºæ¥å…¨æ˜¯ None â†’ è¯¯åˆ¤æˆâ€œæ•´è¡¨æ²¡æ•°æ®â€ã€‚Excel COM æ‰“不开（用户已开着 Excel，不能乱动），最后**自己写公式求值器**（SUM/RANK/ROUND+四则+跨表引用）算出 61,972 ä¸ªæ•°å€¼æ ¼å†æ¯”。

**结论**：语义键一致 28,567 ä¸ªï¼Œä¸ä¸€è‡´ 4,742 ä¸ªã€‚
* ` è´§è¿` è¡¨ï¼šå¯¼å‡ºæ¯å¸‚州比定稿**多两行**（「规上+规下货运量」「规下货运量」），同指标数值**零差异**；定稿还有「规上+规下周转量」行而导出该行为空。
* **最大差异来源**：`city_bus_monthly / city_taxi_monthly / wyc_order_monthly / wyc_total_monthly` **只有 2026-01~08，没有 2025 å¹´** â†’ å…¬äº¤/出租/网约车/中口径几张表的「与去年同比」被算成 `0`/`-1`、2025 å¹´ç´¯è®¡åå°ã€‚
* `h2031_enterprise_monthly` ç¼º `2025-01`（源文件本身没有 1 æœˆï¼‰ã€‚
* å¯¼å‡ºç«¯ã€Œä¸­å£å¾„分析」多一段当月块、缺 4 è¡Œâ€œå æ¯””。
详见《功能测试报告/汇总大表与定稿比对_2026-09-16.md》。

## åå…«ã€ç”¨æˆ·ç¬¬ 2 æ¡ï¼š2024 å¹´æ•°æ®é‡å¯¼ï¼ˆå›žå¡«ä¸Šå¹´åŒæœŸï¼‰

**背景**：`last_*`（上年同期）只从**同一个工作簿的上一年 Sheet** å–，8 æœˆæ–‡ä»¶æ²¡æœ‰ `2023` Sheet，所以 `2024-12` çš„ `last_*` ä¸€ç›´æ˜¯ NULL。

**过程**：先用 7 æœˆæ–‡ä»¶ï¼ˆå« `2023` Sheet）另存只留 4 ä¸ªå¹´åº¦ Sheet çš„临时文件导入 â†’ `2024-12` çš„ `last_*` å¡«ä¸Šäº†ï¼Œä½† **`2021-12` çš„「湖北省」行 1 æœˆå€¼ä»Ž 14945.34 å˜æˆäº† 0**。排查发现「湖北省」行是 `=SUM()` **公式**，openpyxl å¦å­˜ä¼š**丢掉公式的缓存值**，POI è¯»åˆ°ç©ºå…¬å¼å°±å†™ 0。

**修正**：改用**原始 7 æœˆæ–‡ä»¶**整份重导（`POST /api/import/freightTurnover?period=2026-07`，返回「共 108 æ¡è®°å½•ã€= 6 æœŸ Ã— 18 è¡Œï¼‰ã€‚

**复核**：7 æœˆ/8 æœˆä¸¤ä¸ªæ–‡ä»¶çš„ 11 ä¸ªå¹´åº¦ Sheet ä¸Žåº“逐格比对 **4,752 æ ¼å…¨éƒ¨ 0 ä¸ä¸€è‡´**；上年同期链条 2022→2021、2023→2022、2024→2023、2025→2024、2026-07/08→2025 **全部 0 ä¸ä¸€è‡´**。

**教训**：以后不能用 openpyxl å¦å­˜ Excel å†å–‚给后端，公式缓存会丢；要么用原始文件，要么用 Excel COM å¦å­˜ã€‚


## åä¹ã€ç”¨æˆ·ç¬¬ 3 è½®æé—®ï¼šè´§è¿é¡µç­¾ã€Œç´¯è®¡ã€ä¸ºä»€ä¹ˆåªæœ‰å‰å››ä¸ªå¯¹å¾—上 + æ–°å¯¼å…¥æ•°æ®ä½“检

### 19.1 å®šä½è¿‡ç¨‹
1. è§£å‰–导出件「 è´§è¿ã€é¡µç­¾ï¼šå…± 6 ä¸ªç´¯è®¡åˆ— â€”— `S`(2026 1-8月)、`AT`(2025)、`BV`(2024)、`CW`(2023)、`DZ`(2022)、`EO`(2021)。
2. è¯»æ¯ç‰ˆ `docs/生成汇总大表/生成_道路运输量汇总表.xlsx` çš„同名页：`S5/AT5/BV5/CW5` æ˜¯ **Σ公式**，`DZ5` æ˜¯ **数值常量 144979.285376043**，`EO5/EP5` **为空**。2021 å¹´ `EC5:EN5` åäºŒä¸ªæœˆéƒ½æœ‰å€¼ï¼ˆåˆè®¡ 161309.5316），只是累计列漏了。
3. ç”¨æºæ–‡ä»¶ï¼ˆ`D:\05_数据分类\高速\定稿-湖北省各市州运输量数据（2026å¹´1-8月）.xlsx`，另有 7 æœˆæ–‡ä»¶å« 2023 é¡µï¼‰å¤ç®—全省行：

| å¹´åº¦ | åˆ— | æ±‡æ€»è¡¨ | æºæ–‡ä»¶æ ¸ç®— | å·®å¼‚ |
|---|---|---|---|---|
| 2026(1-8月) | S | 130311.8927 | 130311.8927 | 0 |
| 2025 | AT | 195433.2232 | 195433.2232 | 0 |
| 2024 | BV | 184938.5780 | 184938.5780 | 0 |
| 2023 | CW | 173045.2932 | 173045.2964 | âˆ’0.0033 |
| 2022 | DZ | 144979.2854 | 144979.2825 | +0.0029 |
| 2021 | EO | ç©º | 161309.5316 | æ•´åˆ—缺失 |

周转量行同理（2023 âˆ’0.0017、2022 +0.0025、2021 ç©ºï¼‰ã€‚市州行 2026~2022 é€æ ¼ä¸€è‡´ï¼Œå·®å¼‚只在「全省」行和 2021 åˆ—。

### 19.2 åŽŸå› 
* **2021 ç´¯è®¡åˆ—（EO）在母版里就是空的** â€”— æ¼å¡«ç´¯è®¡å…¬å¼ï¼›8 æœˆå®šç¨¿åŒæ ·ä¸ºç©ºï¼Œå±žåŽ†å²é—留。
* **2022 ç´¯è®¡åˆ—（DZ）是写死常量**，不会随导入数据刷新；其各月值也是当年手工录入的旧精度（1 æœˆ 10709.5265 vs æºæ–‡ä»¶ 10709.5234）。
* **2023 ç´¯è®¡åˆ—（CW）是公式，但输入来自母版**：母版 2023 å…¨çœè¡Œ = è§„上+规下两行相加，与源文件 `2023` é¡µæ¹–北省行精度不同，差 0.0033。
* ä»£ç æ¯æ¬¡å¯¼å‡ºåªå›žå¡«ã€Œç›®æ ‡å½“月」一列（`SummaryWorkbookFiller.fillFreightSheet`），历史月份全部沿用母版 â†’ æ¯ç‰ˆå¯¹ä¸ä¸Šå°±æ•´ä½“对不上。

### 19.3 æ–°å¯¼å…¥æ•°æ®ä½“检（问题清单）
| # | ä¸¥é‡åº¦ | é—®é¢˜ |
|---|---|---|
| 1 | é«˜ | `h2032_enterprise_monthly` å¤šå‡ºä¸€ä¸ª **2026-09 æœŸ**，源文件名是「道路货物运输月度生产情况（2026å¹´8月）.xls」（batch 302）。与 2026-08 æœŸé€ä¼ä¸šæ¯”：636 æ¡ä¼ä¸šå®Œå…¨åŒé›†ã€90 ä¸ªåŒºåˆ’，仅 38 å®¶ä¼ä¸šæ•°å€¼ä¸åŒ â†’ æ˜¯ 8 æœˆæ•°æ®çš„另一版本被存成 9 æœˆ |
| 2 | é«˜ | `h2031_enterprise_monthly` **缺 2025-01**（今天只导了 02~12），2025 å¹´ç´¯è®¡ä¼šå°‘ 1 ä¸ªæœˆ |
| 3 | ä¸­ | `passenger_individual_monthly` 2026-08 **缺黄冈市**（7 æ¡å˜ 6 æ¡ï¼‰ |
| 4 | ä½Ž | PASSENGER_AUTH 11 æœŸå…¨ 0 è¡Œï¼Œéœ€ç¡®è®¤æ˜¯å¦æ­£å¸¸ |
| 5 | æç¤º | 2025-04 çš„ H2032 æ­¤å‰ç¼ºå¤±ï¼Œæœ¬æ¬¡å·²è¡¥é½ï¼ˆbatch 382，664 è¡Œï¼‰ï¼›h2032 åŒºåˆ’æ•° 2025=87 / 2026=90，属企业进退规正常变动 |

入库抽查：H2032 2025 å…¨å¹´è§„上 50117.0940 ä¸‡å¨ / 7435040.9971 ä¸‡å¨å…¬é‡Œã€2026 å¹´ 1-8 æœˆè§„上 31399.8248 ä¸‡å¨ï¼Œé€å¸‚å·ž 17/17 ä¸Žå¯¼å‡ºä»¶ã€Œè´§è¿é‡æŽ’名」累计表一致。

详见《功能测试报告/货运累计列核对与导入数据体检_2026-09-16.md》。