docs(比对): 汇总大表 vs 8月定稿逐表比对报告；工作日结补记 2024 年重导与比对

zhizhijie

2026-09-16 cb8ea4248828ca608031f41bd6003dc6765587e8

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

@@ -148,3 +148,54 @@
1. ç­‰ç”¨æˆ·ç¡®è®¤ 3 ä»¶äº‹ï¼šæ˜¯å¦é‡å¯¼ 2026 å¹´åŽ†å² H203-1 æ–‡ä»¶å›žå¡«ä¸¤åˆ—、是否补 `last_*` / `2024-12` ä¸Šå¹´åŒæœŸã€é¢„览弹窗文案是否调整。
2. ç½‘络恢复后补推公司 gitea（先 fetch åˆå¹¶ï¼Œç¦å¼ºæŽ¨ï¼‰ã€‚
3. è§†ç”¨æˆ·æ„è§æ¸…理仓库根目录 `_*.*` ä¸´æ—¶æ–‡ä»¶ã€‚

## åå››ã€git å®žé™…结果（傍晚补记）

1. `git fetch origin`（个人 gitee，`master`）：远端与本地一致（`HEAD...origin/master = 0 0`），**无同事/用户新提交**，无需合并。
2. æäº¤ `24b4c28`：`feat(h2031): é€‚配模板新增「统一社会信用代码/填报单位」两列并入库；fix(import): è¡¥å½• 2023 å¹´è´§è¿é‡å‘¨è½¬é‡ï¼›fix(login/report): éªŒè¯ç å®¹é”™ã€é¢„览指标对齐、弹窗可拖动圆角、失败提示细分；docs: æ–°å¢žé—®é¢˜ä¸Žæ³¨æ„äº‹é¡¹æ±‡æ€»`（10 ä¸ªæ”¹åŠ¨ + 4 ä¸ªæ–°å¢žï¼Œå…± 14 ä¸ªæ–‡ä»¶ï¼‰ã€‚
3. æŽ¨ä¸ªäººä»“库 `origin`：`git push origin main:master` æˆåŠŸï¼ˆ`0cfd6e0..24b4c28`）。
4. æŽ¨å…¬å¸ `gitea`：`git fetch gitea` æŠ¥ `Operation too slow. Less than 1000 bytes/sec transferred the last 15 seconds`；`curl --max-time 20 http://61.183.254.94:3000/` è¿”回 `http_code=000 time=20.01`，确认**公司内网不可达**（网络问题，非凭据），本次未推送成功，已列为遗留问题；补推前先 `git fetch gitea` ä¸Žè¿œç«¯ `main` åˆå¹¶ï¼Œ**禁强推**。

## åäº”、用户 4 æ¡ç¡®è®¤çš„落实（2026-09-16 æ”¶å°¾ï¼‰

| ç”¨æˆ·åé¦ˆ | ç»“论与处置 |
|---|---|
| 1-2「我导入的货运量周转量表里有 23 å¹´æ•°æ®ã€ | å·²é€æ ¼å¤æ ¸ï¼š8 æœˆæºæ–‡ä»¶åªæœ‰ `2026å¹´ / 2025å¹´ / 2024å¹´ / 2022å¹´ / 2021å¹´` äº”个 Sheet，内文无任何 2023 æ ‡è¯†ï¼ˆå‘½ä¸­é¡¹å‡ä¸ºæµ®ç‚¹æ•°é‡Œçš„数字巧合）；`2023` Sheet å‡ºçŽ°åœ¨**7 æœˆ**文件里。已用 7 æœˆæ–‡ä»¶çš„ `2023` Sheet è¡¥å½• `2023-12`，无需再导。 |
| 1「让他空着吧」 | 2026-01~08 çš„ H203-1 `unified_credit_code` / `report_unit` ä¿æŒç©ºï¼Œ**不重导**历史文件。 |
| 2「是不是把 23 å¹´ä¹Ÿå¯¼è¿›åŽ»ã€ | æ˜¯ï¼Œå·²å¯¼å…¥ `2023-12`（18 è¡Œï¼‰ã€‚若要回填 `2024-12` çš„上年同期值，需再重导一次 2024 å¹´æ•°æ®ï¼ˆå¾…用户确认）。 |
| 3「可以」 | é¢„览弹窗文案已按确认修改（汇总大表「指标 N é¡¹ã€ï¼å…¶å®ƒæŠ¥è¡¨ã€Œå…± N è¡Œæ˜Žç»†ã€ï¼‰ï¼Œå¹¶å·²åœ¨æµè§ˆå™¨å®žæµ‹ã€‚ |
| 4「什么时候开始连不上的」 | å…¬å¸ gitea **自 2026-09-15 èµ·ä¸å¯ç”¨**：09-15 ä¸ºå‡­æ®å¼¹çª—未推成功；09-16 èµ·å˜ä¸º TCP 3000 å¯è¿žä½† HTTP æ— å“åº”。今日复测 `Test-NetConnection` ä¸º True、`curl` 25s è¶…æ—¶ `code=000`。 |

## åå…­ã€git å®žé™…结果（收尾补记）

- `git fetch origin`（个人 gitee）：`HEAD...origin/master = 0 0`，无新提交，无需合并。
- æäº¤ `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 å¦å­˜ã€‚