docs(工作日结): 补记本轮 git 结果（origin 已推 27574bc；gitea HTTP 无响应待补推）

zhizhijie

2026-09-16 8544968a63fcb8ae2c5275b3b96acdaba704f6e0

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

@@ -155,3 +155,89 @@
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 å¦å­˜ã€‚


## åä¹ã€ç”¨æˆ·ç¬¬ 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》。

### 19.4 git ç»“果（本轮）
- æäº¤ `27574bc`（功能测试报告 + æœ¬èŠ‚ + .gitignore è¡¥ `_pylibs/`、修正 `~$*` å‰å¯¼ç©ºæ ¼ï¼‰â†’ **已推 origin（gitee master）**：`559e937..27574bc`。
- **公司 gitea ä»ä¸å¯ç”¨**：`Test-NetConnection 61.183.254.94:3000` è¿”回 True（TCP é€šï¼‰ï¼Œä½† `GET /r/trafficAudit.git/info/refs?service=git-upload-pack` 25 ç§’无任何响应（HTTP 000），`git fetch gitea` æŠ¥ `Operation too slow. Less than 1000 bytes/sec`。判断为服务端未正常提供 HTTP å“åº”，待恢复后补推，**禁强推**。