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

zhizhijie

2026-09-16 27574bc4462a11c08bb909eb86dd00f9f564a6f1

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

 .gitignore

@@ -40,6 +40,7 @@

 # ==== Office æ‰“开文档时产生的锁文件 ====
 ~$*
_pylibs/

# ==== ??/?????????====
_shots/

 docs/¹¦ÄܲâÊÔ±¨¸æ/»õÔËÀÛ¼ÆÁк˶ÔÓëµ¼ÈëÊý¾ÝÌå¼ì_2026-09-16.md

New file
@@ -0,0 +1,82 @@
# åŠŸèƒ½æµ‹è¯•æŠ¥å‘Š_货运页签累计列核对与 9/16 å¯¼å…¥æ•°æ®ä½“检_2026-09-16

## ä¸€ã€åŠŸèƒ½/任务说明
针对两个业务问题做核对：
1. 9/16 æ–°å¯¼å…¥çš„「道路客运（H2031/个体户）」与「道路货运（H2032/货运量周转量）」数据是否存在错误；
2. æ±‡æ€»å¤§è¡¨ã€Œ è´§è¿ã€é¡µç­¾çš„「累计」列，为什么只有前几个能和人工核算对上。

## äºŒã€æµ‹è¯•çŽ¯å¢ƒ
- åŽç«¯ï¼šSpring Boot 8090（`/api/report/export/summaryWorkbook`）、MySQL 127.0.0.1:3308/traffic_audit
- å¯¼å‡ºä»¶ï¼š`_fresh_summary_2026-08.xlsx`（period=2026-08&mode=month，SHA å°ºå¯¸ 950,186 å­—节）
- å‚照件：
  - `D:\05_数据分类\高速\定稿-湖北省各市州运输量数据（2026å¹´1-8月）.xlsx`（含 2026å¹´/2025å¹´/2024å¹´/2022å¹´/2021å¹´ é¡µï¼Œ**无 2023 é¡µ**）
  - `D:\05_数据分类\货运\7月\定稿-湖北省各市州运输量数据（2026å¹´1-7月）.xlsx`（含 2023 é¡µï¼‰
  - `D:\05_数据分类\汇总表\8月汇总定稿\2026å¹´8月客运量、货运量定稿.xlsx`
- æ¯ç‰ˆï¼š`docs/生成汇总大表/生成_道路运输量汇总表.xlsx`（Sheet「 è´§è¿ã€ï¼‰
- æ–¹æ³•ï¼šå…ˆæŒ‰è¯­ä¹‰é”®ï¼ˆåœ°åŒº+指标+列标题）对齐，再逐格比对；导出端公式用本地求值器 `_hy*.py` è¿˜åŽŸï¼ˆopenpyxl data_only è¯»ä¸åˆ°å…¬å¼ç¼“存）。

## ä¸‰ã€ç»“论一：汇总表「 è´§è¿ã€é¡µç­¾ 6 ä¸ªã€Œç´¯è®¡ã€åˆ—核对

页签中共有 6 ä¸ªç´¯è®¡åˆ—，分别为 S(2026 å¹´ 1-8 æœˆ)、AT(2025 å¹´)、BV(2024 å¹´)、CW(2023 å¹´)、DZ(2022 å¹´)、EO(2021 å¹´)。
以全省行「货运量」为例（单位：万吨）：

| å¹´åº¦ | åˆ— | æ±‡æ€»è¡¨æ˜¾ç¤º | æºæ–‡ä»¶æ ¸ç®—值 | å·®å¼‚ | ç»“论 |
|---|---|---|---|---|---|
| 2026(1-8月) | S | 130311.8927 | 130311.8927 | 0.0000 | ä¸€è‡´ |
| 2025 | AT | 195433.2232 | 195433.2232 | 0.0000 | ä¸€è‡´ |
| 2024 | BV | 184938.5780 | 184938.5780 | 0.0000 | ä¸€è‡´ |
| 2023 | CW | 173045.2932 | 173045.2964 | **-0.0033** | ä¸ä¸€è‡´ |
| 2022 | DZ | 144979.2854 | 144979.2825 | **+0.0029** | ä¸ä¸€è‡´ |
| 2021 | EO | **空** | 161309.5316 | **-161309.5316** | **整列缺失** |

「货物周转量」行结论相同：2026/2025/2024 ä¸€è‡´ï¼Œ2023 å·® -0.0017、2022 å·® +0.0025、2021 æ•´åˆ—为空。
市州行（17 å¸‚州）2026/2025/2024/2023/2022 ä¸Žåº“内数据逐格一致，差异只出现在「全省」行与 2021 åˆ—。

### åŽŸå› ï¼ˆå·²å®šä½åˆ°æ¯ç‰ˆï¼‰
1. **2021 å¹´åˆ—（EO）在母版里根本没有值**：`生成_道路运输量汇总表.xlsx` çš„ ` è´§è¿` é¡µ `EO5` = ç©ºã€`EP5`（累计同比）= ç©ºï¼Œè€Œ `EC5:EN5`（2021 å¹´ 1-12 æœˆï¼‰éƒ½æœ‰å€¼ï¼Œåˆè®¡ 161309.5316。即**母版漏填了 2021 å¹´çš„累计公式**。8 æœˆå®šç¨¿åŒæ ·ä¸ºç©ºï¼ˆ`EP` ä¸ºç©ºï¼‰ï¼Œè¯´æ˜Žæ˜¯åŽ†å²é—留、非本次导出造成。
2. **2022 å¹´åˆ—（DZ）在母版里是写死的常量**：`DZ5 = 144979.285376043`（类型是数值，不是公式），`EA5`（累计同比）= -0.101235470414284 ä¹Ÿæ˜¯å¸¸é‡ã€‚它等于母版自身 2022 å¹´å„月值之和，但与现源文件 `2022å¹´` é¡µæ¹–北省行（144979.2825）差 0.0029 â€”— æ¯ç‰ˆ 2022 å¹´å„月是当年手工录入的旧精度数据（如 1 æœˆ 10709.5265 vs æºæ–‡ä»¶ 10709.5234），**不会再随数据刷新**。
3. **2023 å¹´åˆ—（CW）虽是公式，但输入来自母版**：母版 2023 å¹´å…¨çœè¡Œæ˜¯ã€Œè§„上+规下」两行相加，精度与源文件 `2023` é¡µæ¹–北省行不同，合计差 0.0033（全省行）。市州行一致。
4. 2026/2025/2024 ä¸‰å¹´ä¹‹æ‰€ä»¥èƒ½å¯¹ä¸Šï¼Œæ˜¯å› ä¸ºæ¯ç‰ˆè¿™ä¸‰å—的各月值与现源文件完全一致（逐格 0 å·®å¼‚）；且代码 `SummaryWorkbookFiller.fillFreightSheet` æ¯æ¬¡å¯¼å‡ºåªå›žå¡«â€œç›®æ ‡å½“月”一列，历史月份一律沿用母版，所以母版对不上就整体对不上。

### ä¿®å¤å»ºè®®ï¼ˆå¾…确认后执行）
- æ¯ç‰ˆ ` è´§è¿` é¡µ EO åˆ—按同构公式补齐：`EO5 = EC5+EE5+EG5+EI5+EK5+EM5+EO5`… å®žé™…应为 12 ä¸ªæœˆåˆ—（EC/ED/…/EN）之和；EP è¡¥ç´¯è®¡åŒæ¯”。
- DZ åˆ—改为公式（DM+DN+…+DX ä¹‹å’Œï¼‰ï¼Œä½¿å…¶éšæ•°æ®åˆ·æ–°ï¼Œé¿å…ç»§ç»­æ²¿ç”¨ 2 ä½æ•°å‰çš„旧值。
- 2023/2022 çš„ 0.003 çº§å·®å¼‚属母版历史录入精度问题，如需与源文件完全对齐，需按源文件重填这两个年度块。

## å››ã€ç»“论二：9/16 æ–°å¯¼å…¥æ•°æ®ä½“检

### 4.1 æœ¬æ¬¡å¯¼å…¥æ¸…单（import_batch）

| ç±»åž‹ | æœŸæ¬¡ | è¡Œæ•° | æ¥æºæ–‡ä»¶ |
|---|---|---|---|
| FREIGHT_TURNOVER | 2021-12 / 2022-12 / 2023-12 / 2024-12 / 2025-12 / 2026-07 / 2026-08 | å„ 18 | å®šç¨¿-湖北省各市州运输量数据（2026å¹´1-8月 / 1-7月）.xlsx |
| H2031（公路旅客） | 2025-02 ~ 2025-12（11 æœŸï¼‰ | 814/809/798/795/791/806/800/796/796/798/792 | å…¬è·¯æ—…客运输月度生产情况（2025）*.xls |
| PASSENGER_AUTH | 2025-02 ~ 2025-12 | **0** | åŒä¸Š |
| PASSENGER_INDIVIDUAL | 2025-01 ~ 2025-12 | å„ 7 | æ¹–北省公路旅客运输个体户月度生产情况（2025.*）.xlsx |
| H2032（道路货运） | 2025-04 | 664 | é“路货物运输月度生产情况（2025å¹´4月）.xls |

### 4.2 å‘现的问题

| # | ä¸¥é‡åº¦ | é—®é¢˜ | è¯æ® | å½±å“ |
|---|---|---|---|---|
| 1 | é«˜ | `h2032_enterprise_monthly` å¤šå‡ºä¸€ä¸ª **2026-09 æœŸ**，其源文件名却是「道路货物运输月度生产情况（2026å¹´8月）.xls」（2026-09-10 å¯¼å…¥ï¼Œbatch id 302） | ä¸Ž 2026-08 æœŸé€ä¼ä¸šæ¯”对：同为 636 æ¡ã€90 ä¸ªåŒºåˆ’、**企业集合完全相同**，仅 38 å®¶ä¼ä¸šæ•°å€¼ä¸åŒï¼›å…¨çœåˆè®¡ 08=3665.3638 / 09=3690.5636 | 8 æœˆæŠ¥è¡¨ä¸å—影响（累计只取 1-8 æœˆï¼‰ï¼Œä½†ç”Ÿæˆ 9 æœˆæŠ¥è¡¨æ—¶ä¼šæŠŠè¿™ä»½ã€Œ8 æœˆå‰¯æœ¬ã€å½“成 9 æœˆæ•°æ® |
| 2 | é«˜ | `h2031_enterprise_monthly` **缺 2025-01** | 2025 å¹´åªæœ‰ 2025-02~2025-12 å…± 11 æœŸï¼›`import_batch` æ—  2025-01 çš„ H2031 è®°å½• | å…¬è·¯æ—…客 2025 å¹´ç´¯è®¡å°‘ 1 ä¸ªæœˆï¼›ã€Œä¸ŽåŽ»å¹´åŒæ¯”」整体偏移 |
| 3 | ä¸­ | `passenger_individual_monthly` 2026-08 **缺黄冈市**（只有 6 æ¡ï¼Œå…¶ä½™æœˆä»½ 7 æ¡ï¼‰ | 2026-07 æœ‰ é»„冈/黄石/荆门/随州/襄阳/孝感×2；2026-08 æ— é»„冈 | 2026-08 ç­çº¿åŒ…车/公路总客运的「其中个体」少黄冈一家 |
| 4 | ä½Ž | PASSENGER_AUTH æ¯æœŸ 0 è¡Œ | 11 ä¸ªæ‰¹æ¬¡ success_rows å‡ä¸º 0 | æš‚无影响（该台账本期无授权数据），但需确认是否应有数据 |
| 5 | æç¤º | 2025-04 çš„ H2032 æ­¤å‰ç¼ºå¤±ï¼Œæœ¬æ¬¡å·²è¡¥é½ | batch id 382，664 è¡Œå…¨æˆåŠŸ | å·²ä¿®å¤ |
| 6 | æç¤º | h2032 åŒºåˆ’集合年度间有变动 | 2025-12 æœ‰ 87 ä¸ªåŒºåˆ’、2026-08 æœ‰ 90 ä¸ªï¼›2026 æ–°å¢ž 420822/420921/420922/420982，2025 ç‹¬æœ‰ 420161 | å±žä¼ä¸šè¿›é€€è§„的正常变动，仅提示 |

### 4.3 å…¥åº“抽查（与源文件逐项对齐）
- H2032 2025 å…¨å¹´è§„上货运量 = 50117.0940 ä¸‡å¨ã€è§„上周转量 = 7435040.9971 ä¸‡å¨å…¬é‡Œ â†’ ä¸Žæ±‡æ€»è¡¨ 2025 ç´¯è®¡åˆ— **完全一致**。
- H2032 2026 å¹´ 1-8 æœˆè§„上货运量 = 31399.8248 ä¸‡å¨ï¼ˆé€å¸‚州：武汉 10072.9811、黄石 1141.0468、十堰 97.1046、宜昌 5925.3101、襄阳 2528.7835、鄂州 861.4684、荆门 632.9213、孝感 1384.5256、荆州 1278.1560、黄冈 5397.3567、咸宁 730.5726、随州 453.8854、恩施州 46.4794、仙桃 156.5243、潜江 304.9884、天门 347.0714、林区 40.6492）→ ä¸Žå¯¼å‡ºä»¶ã€Œè´§è¿é‡æŽ’名」累计表 **17/17 å…¨éƒ¨ä¸€è‡´**。
- FREIGHT_TURNOVER 2021~2026 å„期合计与源文件各年度页求和一致（除上表 2021/2022/2023 ä¸‰å¤„差异）。
- 2026-09 æœŸæ•°æ®æ¥è‡ªã€Œ2026å¹´8月」文件，判定为**期次错误**，建议核实后删除或改期。

## äº”、遗留问题
1. æ¯ç‰ˆ 2021 ç´¯è®¡åˆ—（EO/EP）缺失、2022 ç´¯è®¡åˆ—为常量，是否授权修改需业务确认。
2. H2031 2025-01 è¡¥é½æ‰€éœ€æºæ–‡ä»¶å¾…用户提供。
3. h2032 çš„ 2026-09 è„æœŸå¤„置方式待确认（删除 or ä¿ç•™æ”¹åï¼‰ã€‚

## å…­ã€ç»“论
- ã€Œç´¯è®¡åªæœ‰å‰å‡ ä¸ªå¯¹å¾—上」的直接原因是**母版里 2021 ç´¯è®¡åˆ—为空、2022 ç´¯è®¡åˆ—为写死常量，2023 ç´¯è®¡åˆ—输入精度与源文件不符**；2026/2025/2024 ä¸‰å¹´ä¸Žæºæ–‡ä»¶å®Œå…¨ä¸€è‡´ã€‚
- æœ¬æ¬¡å¯¼å…¥çš„「道路货运」存在 1 å¤„期次错误（2026-09 å®žä¸º 8 æœˆæ•°æ®å‰¯æœ¬ï¼‰ï¼›ã€Œé“路客运」存在 2025-01 ç¼ºæœˆã€2026-08 ä¸ªä½“户缺黄冈两处缺口。

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

@@ -199,3 +199,41 @@
**复核**：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》。