HANDOFF.md

@@ -4,6 +4,19 @@
> **每天结束时**：把当天进展、踩过的坑、新需求、未完成事项更新到本文件，然后可以放心开新对话。
> **协作约定（2026-08-31）**：说「提交」= æœ¬åœ° commit + æŽ¨é€åˆ°è¿œç«¯ git（origin main，Gitblit），不再只做本地 commit。

## æœ€æ–°ï¼ˆ2026-09-23）

- **已同步**：本地 `main` å¿«è¿›åˆå¹¶å…¬å¸ `origin/main` æœ€æ–° `8b739ce`（同事 09-22 å…³æœºå¿«ç…§ç»Ÿä¸€ç‰ˆï¼‰ï¼Œåˆå¹¶åŽ `HEAD = 8b739ce = origin/main`，工作区干净。
- **本次新增交接文档**：`docs/交接文档_2026-09-23.md`（09-23 å¢žé‡ï¼šçŽ°çŠ¶å¿«ç…§ + è…¾è®¯æ–‡æ¡£è¯»å–调研 + å½“前待办 + æ–‡ä»¶ç´¢å¼•ï¼‰ã€‚系统全景与 P0/P1/P2 å…¨é‡é—留仍以 `docs/交接文档_2026-09-21.md` ä¸ºå‡†ã€‚
- **今日工作**：腾讯文档读取调研 + æ½œæ±Ÿç‰©æµæŠ•èµ„月报重导修正；无业务代码改动（见 `docs/工作日结/工作日结_2026-09-23.md`）。
- **潜江重导（已完成）**：潜江物流 2026-06/07/08 åœ¨åº”用实际库 `3305` å‡æ”¹ä¸ºâ€œä¸­å›½è™¾è°·å†·é“¾ä»“储物流园” `11947.9 / 0 / 1135 / 0`；重复重导保持每月 1 æ¡ã€æ— é‡åé¡¹ç›®ï¼Œ2026-08 å¯¼å‡ºç«¯åˆ°ç«¯æ ¸å¯¹é€šè¿‡ã€‚09-22 æŠ¥å‘Šè®°å½•çš„验证库是 `3308`，与当前应用连接库不一致，故当前库 08 æœˆæ—§å€¼æœ¬æ¬¡ä¸€å¹¶ä¿®æ­£ã€‚报告 `docs/功能测试报告/功能测试报告_潜江投资物流月报重导_2026-09-23.md`。
- **腾讯文档读取调研（新结论）**：
  1. åªè¯»åˆ†äº«é“¾æŽ¥ï¼ˆã€Š2026年十一数据》，10 é¡µç­¾ï¼‰**能读显示值** â€”— æµè§ˆå™¨ã€Œæ‰“印 â†’ æ•´ä¸ªå·¥ä½œç°¿ â†’ æ‰“印预览」渲染成 SVG æ®µï¼Œè¯» `<text>` å³å¾—数值/日期/百分比/`#DIV/0!`；但读不到公式、隐藏行列、打印范围外内容，且不易恢复精确 A1 åæ ‡ã€‚
  2. **trafficAudit ç›®å‰ä¸æ”¯æŒ**在线文档导入，只走本地文件上传（`DataImport.vue:57/502` â†’ `DataImportController.java:33` â†’ Apache POI）。
  3. **腾讯官方 Open API V3 å¯è¡Œ**：`GET /openapi/spreadsheet/v3/files/{fileId}/{sheetId}/{range}`（A1 èŒƒå›´ï¼Œè¿”回 `cellValue`），但需 OAuth 2.0 + åº”用凭证 + `scope.sheet(.readonly)`；仅凭分享链接不能匿名调用。落产品建议走官方 API，不用打印预览。详见 `docs/交接文档_2026-09-23.md` Â§3。
- **运行状态（09-23 08:50 ç»­æŽ¥å®žæµ‹ï¼‰**：dev åŽç«¯ `8090`、前端 `8080` å·²å¯åŠ¨å¹¶å°±ç»ªï¼Œåº”用数据库 `localhost:3305/traffic_audit`。启动命令：`powershell -NoProfile -ExecutionPolicy Bypass -File start-dev.ps1`（沙箱外）。
- **接手优先（更新）**：投资明细表 L/D/E/F è¦†ç›–口径、武汉物流/黄冈客运 8 æœˆæºæ•°æ®ã€æœªè¦†ç›–清单落文件；汇总大表 304 æ ¼ã€Œ2025 ç´¯è®¡åˆ—」；P0-2 äº¿å…ƒè¡¨æŒ‰ Q7 è¿½åˆ—、P0-3 å¯¼å‡ºå‰åŸºæ•°ä½“检、P0-4 2026-09 æ¯ç‰ˆã€‚

## æœ€æ–°ï¼ˆ2026-09-22）

- **已同步**：本地 `main` å·²åˆå¹¶å…¬å¸ `origin/main` æœ€æ–° `db0ee92`（含投资明细取数/导入修复）；合并后 `mvn -q -DskipTests compile` é€šè¿‡ã€‚

 docs/½»½ÓÎĵµ_2026-09-23.md

New file
@@ -0,0 +1,197 @@
# äº¤é€šè´§è¿ç»Ÿè®¡å®¡æ ¸ç³»ç»Ÿ â€”— äº¤æŽ¥æ–‡æ¡£ï¼ˆ2026-09-23）

> **用途**：新对话/接手人先读 `HANDOFF.md` + é¡¹ç›®æ ¹ `AGENTS.md`，再读本文，即可无缝接力。
> **与其它文档的关系**：本文只写 09-23 çš„增量（现状快照 + æœ¬æ¬¡å¯¹è¯æ–°å¢žçš„腾讯文档读取调研 + å½“前待办入口）；
> ç³»ç»Ÿç»“构、P0/P1/P2 å…¨é‡é—留仍以 `docs/交接文档_2026-09-21.md` ä¸ºå‡†ï¼Œä¸é‡å¤ã€‚

---

## 0. å…ˆè¯»è¿™ä¸€é¡µï¼ˆæŽ¥æ‰‹ç¬¬ 1 å°æ—¶ï¼‰

1. **先把系统跑起来**（见 Â§1.3），再谈改代码。脚本必须在**沙箱外**运行。
2. **本次对话新增结论**：腾讯文档在线表格「能不能读、怎么读、trafficAudit èƒ½ä¸èƒ½è‡ªå·±è¯»ã€å®˜æ–¹ API è¡Œä¸è¡Œã€å…¨éƒ¨è°ƒç ”完，见 Â§3。
3. **P0 ä¸‰ä»¶äº‹ä¸å˜**：①《亿元投资项目》按 Q7 è¿½åˆ—；② å¯¼å‡ºå‰ã€ŒåŸºæ•°ä½“检 + å¼¹çª— +《数据缺失清单》页」只做了一半；③ ç¼º 2026-06 / 2026-09 æ¯ç‰ˆã€‚详见 `docs/交接文档_2026-09-21.md` Â§4。
4. **硬规矩不变**：改完必须写《功能测试报告》→ æ›´æ–°ã€Šå·¥ä½œæ—¥ç»“》→ æŽ¨é€å…¬å¸ gitea（`origin`，§1.4）。不要强推、不要覆盖同事代码。

---

## 1. çŽ°çŠ¶å¿«ç…§ï¼ˆ2026-09-23 08:50 ç»­æŽ¥å®žæµ‹ï¼‰

### 1.1 git

| é¡¹ | å€¼ |
| --- | --- |
| åˆ†æ”¯ | `main` |
| æœ¬è½®èµ·ç‚¹ HEAD | `8b739ce docs(交接): ç»Ÿä¸€ 09-22 å…³æœºå¿«ç…§ï¼ˆåˆå¹¶åŒäº‹ç‰ˆæœ¬ï¼Œä¿®æ­£è¿è¡ŒçŠ¶æ€ä¸ºå®žæµ‹ï¼š8090/8080 åœ¨è¿è¡Œï¼‰` |
| è¿œç«¯ | æœ¬è½®å¼€å§‹å‰å·²åŒæ­¥å…¬å¸ `origin/main`；本次续接新增的文档提交见 `git log` |
| è¿œç«¯åœ°å€ | `origin` â†’ `http://61.183.254.94:3000/r/trafficAudit.git`（分支 `main`）——**只用公司 gitea å•ä»“库**，个人 gitee å·²å¼ƒç”¨ |

### 1.2 æœåŠ¡ä¸Žè¿›ç¨‹

| é¡¹ | å€¼ |
| --- | --- |
| dev åŽç«¯ 8090 | **运行中**（09-23 08:48 å¯åŠ¨ï¼Œæ—¥å¿—出现 `Started TrafficAuditApplication`） |
| dev å‰ç«¯ 8080 | **运行中**（09-23 08:48 å¯åŠ¨ï¼Œæ—¥å¿—出现 `App running at`） |
| æ•°æ®åº“ | MySQL，库 `traffic_audit`，配置 `jdbc:mysql://localhost:3305/traffic_audit`，`root/root`；本机 `MySQL57`、`MySQL80` æœåŠ¡å‡ **Running** |
| å…¶å®ƒ node è¿›ç¨‹ | å­˜åœ¨è‹¥å¹² `node`/`cmd`（08:42 èµ·ï¼‰ï¼Œä¸º Codex è‡ªèº«ç»„件，**勿动** |

> åˆ¤æ–­æœåŠ¡æ˜¯å¦èµ·æ¥ï¼š**只看日志**（后端 `Started TrafficAuditApplication` + `Tomcat started on port(s): 8090`；前端 `App running at`）。
> æ²™ç®±å†… `Get-NetTCPConnection` ä¼šé™é»˜å¤±è´¥/报无匹配，据此判断会误判。

### 1.3 å¯åŠ¨ / åœæ­¢

```powershell
# é¡¹ç›®æ ¹ç›®å½•ï¼Œå¿…须在沙箱外（提权）运行
powershell -NoProfile -ExecutionPolicy Bypass -File start-dev.ps1
# åœæ­¢ï¼š
powershell -NoProfile -ExecutionPolicy Bypass -File stop-dev.ps1
```

脚本会自动跳过已在监听的端口；关机后服务自然停止，无需手工处理。

### 1.4 git å·¥ä½œæµï¼ˆç¡¬è§„矩）

```powershell
git fetch origin
# å…ˆåˆå¹¶è¿œç«¯ main（有必要就解冲突，禁止强推）
git add -- <改动文件>
git commit -m "docs: ..."
git push origin main
```

---

## 2. 09-22 å·²å®Œæˆï¼ˆæ‰¿ä¸Šï¼Œå·²åœ¨è¿œç«¯ï¼‰

- **投资明细表「软件生成 vs äººå·¥ç‰ˆã€é€æ ¼æ¯”对（2026-08）**：156 æ ¼å·®å¼‚，定位到 3 ç±»ã€Œä¼šé™é»˜å‡ºæ•°ã€çš„取数问题（导出按项目名匹配/库内无当月数沿用上期值、库内同名双档取到旧档、导入丢数）。报告 `docs/功能测试报告/数据比对报告_投资明细表软件生成与人工版_2026-09-22.md`。
- **投资取数修复第一轮**：导出 3 å¤„ + å¯¼å…¥ 2 å¤„（含新发现的「潜江导入 2018 å¹´åŽ†å² sheet」），回归后逐格差异 **156 â†’ 129**，无新增差异，未覆盖行能自动告警。报告 `docs/功能测试报告/功能测试报告_投资明细表取数修复_2026-09-22.md`。
- **汇总大表软件输出 vs æ‰‹å·¥å®šç¨¿å¤æ ¸ï¼ˆ2026-08）**：Excel å…¨é‡é‡ç®—后逐格比对，930 æ¡å·®å¼‚中实质数值差异 314 æ¡ï¼›æ° 304 æ¡ä¸ºã€Œ2025 ç´¯è®¡åˆ—少加 7、8 æœˆã€ï¼ˆä¸šåŠ¡å·²ç¡®è®¤è¯¥åˆ—可清空），10 æ¡ `货运` åŽ†å²åŒæ¯”业务已确认软件正确。报告 `docs/问题汇总/汇总大表_软件输出与手工定稿差异清单_2026-08_20260922.md`，明细 CSV åŒç›®å½•ã€‚
- **数据查看页**：补齐网约车总数/网约车订单/个体客运三类查看入口，新增「按市州汇总 + å¯¼å‡º Excel」，口径上移筛选、空列隐藏、表头补单位。
- **汇总大表导出缓存**：导出结果落盘缓存（`docs/生成汇总大表/_cache/`，gitignore）+ æ•°æ®æŒ‡çº¹å®ˆå«ï¼ˆä¾èµ–源表 `CHECKSUM TABLE` + æ¯ç‰ˆæ–‡ä»¶èº«ä»½ï¼Œæ¢æ¯ç‰ˆå¿…失效），失效时弹窗给说明。
- **Codex è¾“入卡顿修复复核通过**：09-22 é‡å¯åŽ `Codex++` å®ˆå«è„šæœ¬ä»å¯ç”¨ï¼Œä¸»æ¸²æŸ“进程空闲 CPU çº¦ 13.3%（单核），较修复前约 115% å·²è§£å†³ã€‚

### 2.1 09-23 ç»­æŽ¥ï¼šæ½œæ±ŸæŠ•èµ„物流月报重导（本次新增）

- æŒ‰é—留重导潜江物流 2026-06、2026-07；核对当前应用配置时发现实际连接库是 `localhost:3305`，而 09-22 åŠŸèƒ½æµ‹è¯•æŠ¥å‘Šè®°å½•çš„验证库是 `localhost:3308`。
- å½“前 `3305` åº“中，潜江 2026-08 ä»æŒ‚旧项目“潜江传化公路港项目”并保留 `5173/12000/5173/1440`，说明上一轮 08 æœˆä¿®æ­£æœªè½åˆ°æœ¬æ¬¡è¿è¡Œåº“ï¼›`3308` å½“前无法连接。
- æœ¬æ¬¡åªä¸Šä¼ æ½œæ±Ÿå•æ–‡ä»¶é‡å¯¼ 6/7/8 ä¸‰ä¸ªæœˆï¼Œå‡ä¸º `success=1`；三个月均改为“中国虾谷冷链仓储物流园” `11947.9 / 0 / 1135 / 0`。
- é‡å¤é‡å¯¼å¹‚等（每月 1 æ¡ã€1 ä¸ªé¡¹ç›®ã€æ— é‡åä¸»æ¡£ï¼‰ï¼Œ2026-08 ç‰©æµæ˜Žç»†å¯¼å‡ºç¬¬ 180 è¡Œç«¯åˆ°ç«¯æ ¸å¯¹é€šè¿‡ã€‚
- æŠ¥å‘Šï¼š`docs/功能测试报告/功能测试报告_潜江投资物流月报重导_2026-09-23.md`。

---

## 3. è…¾è®¯æ–‡æ¡£åœ¨çº¿è¡¨æ ¼è¯»å–调研（本次对话新增）

### 3.1 èƒŒæ™¯

用户给定在线表格（只读分享链接）：

`https://docs.qq.com/sheet/DQ2ZLR09Kcm9ZcUpI?nlc=1&tab=000004`

文档名 **《2026年十一数据》**，权限**只能查看**，共 **10 ä¸ªé¡µç­¾**：铁路、民航、道路、水路、高速公路、普通国省道、营业性客运量、人员流动量汇总、报厅办1、报厅办2。

### 3.2 å®žæµ‹ç»“论一：分享链接的内容**可以读**（显示值层面）

做法（Codex å†…置浏览器 + CUA/Playwright，无需任何腾讯账号/API）：

1. æ‰“开文档 â†’ è§¦å‘「打印」→ é€‰æ‹©ã€Œ**整个工作簿**」→ è¿›å…¥**打印预览**；
2. é¢„览把每个页签渲染成 SVG æ‰“印页段（本次实测共 **15 æ®µ**）；
3. è¯»å– SVG ä¸­ `<text>` èŠ‚点即可得到**当前显示值**：表头、日期、数值、百分比，连 `#DIV/0!` è¿™ç§é”™è¯¯æ–‡æœ¬ä¹Ÿèƒ½æ‹¿åˆ°ã€‚

**能力边界（很重要）**：

- âœ… èƒ½è¯»ï¼šå½“前**显示值**（含打印范围内的表头/日期/数值/百分比/错误文本）。
- âŒ ä¸èƒ½è¯»ï¼šåŽŸå§‹**公式**（拿到的是结果不是 `=…`）。
- âŒ ä¸èƒ½è¯»ï¼š**隐藏行列**（打印预览不含隐藏内容）。
- âŒ ä¸èƒ½è¯»ï¼š**打印范围外**的内容。
- âŒ ä¸æ˜“恢复：精确 **A1 å•å…ƒæ ¼åæ ‡**（按显示布局切分，不保证与单元格一一对应）。

### 3.3 å®žæµ‹ç»“论二：**trafficAudit ç›®å‰è¯»ä¸äº†åœ¨çº¿æ–‡æ¡£**

代码调研（全仓无腾讯文档/分享链接/腾讯 Open API ä»»ä½•é›†æˆï¼‰ï¼š

- å‰ç«¯åªæ”¯æŒ**本地文件上传**：`el-upload`，接受 `.xlsx/.xls/.et`（网约车报告另有 `.docx`）——`traffic-audit-web/src/views/DataImport.vue:57`、`DataImport.vue:502`；
- åŽç«¯æŽ¥å£æ”¶ `MultipartFile`——`DataImportController.java:33`；
- æœåŠ¡å±‚用 Apache POI `WorkbookFactory.create(file.getInputStream())`——`DataImportService.java:192`；
- ã€Œç›®å½•å¯¼å…¥ã€åªæ‰«æ**服务器本地目录**，不访问外网。

> ç»“论：要靠软件自己读在线表格，**必须新增集成**（下述官方 API æ˜¯å”¯ä¸€æ­£è§„路径）；否则只能像本次一样借助浏览器「打印预览」人工/脚本抓显示值。

### 3.4 å®žæµ‹ç»“论三：**腾讯文档官方 API å¯ä»¥æŒ‰å•å…ƒæ ¼è¯»å–**（无需大模型/OCR）

官方 Open API（V3，V2 å·²åºŸå¼ƒï¼‰æä¾›**读指定范围**接口：

```http
GET https://docs.qq.com/openapi/spreadsheet/v3/files/{fileId}/{sheetId}/{range}
# ä¾‹ï¼š/files/ABCDE123abcde/BB08J2/A10:D11
```

请求头：

```http
Access-Token: {ACCESS_TOKEN}
Open-Id: {OPEN_ID}
Client-Id: {CLIENT_ID}
Accept: application/json
```

要点：

- `range` ç”¨ **A1 è¡¨ç¤ºæ³•**，返回 `gridData.rows[].values[].cellValue`；
- æƒé™éœ€ `scope.sheet` æˆ– `scope.sheet.readonly`；
- å¿…须走**腾讯文档 OAuth 2.0 ç”¨æˆ·æŽˆæƒ**拿到 `Access-Token`/`Open-Id`；
- å•æ¬¡é™åˆ¶ï¼šè¡Œ â‰¤ 1000、列 â‰¤ 200、总单元格 â‰¤ 10000；
- **仅凭公开分享链接、没有应用凭证/OAuth，不能匿名调用**；
- å®˜æ–¹æ–‡æ¡£ï¼šhttps://docs.qq.com/open/document/app/openapi/v3/sheet/get/get_range.html

### 3.5 å»ºè®®ï¼ˆè‹¥åŽç»­è¦è½åœ°ï¼‰

- åªè¯»å°‘æ•°**已知范围**的数值 â†’ ç›´æŽ¥èµ°**官方 Open API V3**（按 A1 èŒƒå›´è¯»ï¼Œç¨³å®šã€å¯å†™è¿›ä»£ç ï¼‰ã€‚
- æµè§ˆå™¨ã€Œæ‰“印预览」只作**临时/一次性**取证手段，不要写进产品逻辑。
- çœŸæ­£å¼€å‘前需先准备：腾讯文档**开放平台应用**（`Client-Id`）+ **OAuth å›žè°ƒ** + ç”¨æˆ·æŽˆæƒï¼Œå¹¶ç¡®è®¤ç›®æ ‡æ–‡æ¡£æ‰€åœ¨è´¦å·èƒ½æŽˆæƒè¯¥åº”用。

---

## 4. å½“前待办

### 4.1 æŠ•èµ„明细表（下一轮）

1. **L/D/E/F åˆ—覆盖口径**：需先确认《建设阶段归一表》（源表「主体施工/竣工收尾/未开工/本年正式施工/暂停施工/前期」→ è¾“出用词）；
2. **补源数据**：武汉物流 8 æœˆæ— å•è¡¨ã€é»„冈客运 8 æœˆæ— æºæ–‡ä»¶ï¼ˆå¯¼å‡ºå·²èƒ½è‡ªåŠ¨å‘Šè­¦ï¼Œå…± 15 è¡Œå—影响）；
3. **潜江 2026-06 / 2026-07 / 2026-08** âœ… å·²äºŽ 2026-09-23 åœ¨å½“前应用库 `3305` ç”¨å¯¹åº”月份源表重导并完成幂等/导出验证；后续不要再沿用 09-22 æŠ¥å‘Šçš„ `3308` éªŒè¯ç»“论。
4. ã€Œæœªè¦†ç›–行清单」目前只进 `backend.log` â†’ æŒ‰ P1-9 åšæˆã€Šæ ¡éªŒæŠ¥é”™_<年月>.xlsx》或页面提示。

### 4.2 æ±‡æ€»å¤§è¡¨

- 304 æ ¼ã€Œ2025 ç´¯è®¡åˆ—少加 7、8 æœˆã€ï¼šä¸šåŠ¡å·²ç¡®è®¤è¯¥åˆ—**可清空**，等落实现（清空/修正规则以业务最终意见为准）。

### 4.3 æ—¢æœ‰ P0/P1/P2（不变，见 `docs/交接文档_2026-09-21.md` Â§4）

- P0-2《亿元投资项目》按 Q7 è¿½åˆ—（`ReportExportService.java:6251` ä»å†™åŒä¸€æ ¼ï¼‰ï¼›
- P0-3 å¯¼å‡ºå‰åŸºæ•°ä½“检（`getLastMidIssues()` æ— è°ƒç”¨æ–¹ï¼‰ï¼›
- P0-4 2026-06/09 æ¯ç‰ˆç¼ºå¤±ï¼›
- P2-2「城市客运页表头仍是日期序列号」可能过时（代码 09-03 å·²åŠ  `fixCityMonthHeaderText()`），待跑一次 2026-08 å¯¼å‡ºæ ¸å¯¹åŽå†æ”¹ï¼›
- å…¶ä½™ P1/P2 è§ 09-21 æ€»äº¤æŽ¥æ–‡æ¡£ã€‚

---

## 5. å…³é”®æ–‡ä»¶ä¸Žå‘½ä»¤ç´¢å¼•

| ç”¨é€” | è·¯å¾„ / å‘½ä»¤ |
| --- | --- |
| æ¯æ—¥æ€»å…¥å£ | `HANDOFF.md`（本仓库根） |
| é¡¹ç›®è§„约 | `AGENTS.md`（仓库根） |
| ç³»ç»Ÿæ€»äº¤æŽ¥ + P0/P1/P2 | `docs/交接文档_2026-09-21.md` |
| æ±‡æ€»å¤§è¡¨ä¸“项交接 | `docs/问题汇总/汇总大表问题交接_2026-09-21.md` |
| æ±‡æ€»å¤§è¡¨å·®å¼‚清单/明细 | `docs/问题汇总/汇总大表_软件输出与手工定稿差异清单_2026-08_20260922.md` + åŒå CSV |
| æŠ•èµ„比对/修复报告 | `docs/功能测试报告/数据比对报告_投资明细表软件生成与人工版_2026-09-22.md`、`docs/功能测试报告/功能测试报告_投资明细表取数修复_2026-09-22.md` |
| æ½œæ±Ÿé‡å¯¼éªŒè¯æŠ¥å‘Š | `docs/功能测试报告/功能测试报告_潜江投资物流月报重导_2026-09-23.md` |
| åŽ†å²é—®é¢˜å‘索引 | `docs/问题汇总/问题与注意事项汇总_2026-09-16.md` |
| æ±‡æ€»å¤§è¡¨æ¯ç‰ˆ | `docs/生成汇总大表/`（`{yyyy}å¹´{M}月道路运输量汇总表.xlsx`） |
| æŠ•èµ„模板/输入/输出 | `docs/投资/模板/`、`docs/投资/输入/…`、`docs/投资/输出/` |
| å¯åœ | `start-dev.ps1` / `stop-dev.ps1`（沙箱外） |
| åŽç«¯/前端日志 | `backend.log`、`traffic-audit-web/frontend.log` |

---

*本文由 2026-09-23 ä¼šè¯ç”Ÿæˆï¼Œç”¨äºŽæ–°å¯¹è¯ç»­æŽ¥ã€‚系统全景仍以 `docs/交接文档_2026-09-21.md` ä¸ºå‡†ã€‚*

 docs/¹¦ÄܲâÊÔ±¨¸æ/¹¦ÄܲâÊÔ±¨¸æ_Ͷ×ÊÃ÷ϸ±íÈ¡ÊýÐÞ¸´_2026-09-22.md

@@ -26,6 +26,8 @@
- ä¿®å¤åŽè½¯ä»¶ç‰ˆï¼š`_tmp/gen_new_0922/…`（本次重跑导出）
- æ¯”对脚本：`_tmp_diff_invest_0922.py`（修复前）、`_tmp_diff_after_fix_0922.py`（修复后）

> **2026-09-23 ç»­æŽ¥æ ¸å®ž**：本报告记录的验证库 `localhost:3308` ä¸æ˜¯å½“前应用实际连接库；当前 `application.yml` ä¸Žè¿è¡Œä¸­åŽç«¯å‡ä½¿ç”¨ `localhost:3305`。在 `3305` ä¸Šå¤æ ¸æ—¶ï¼Œæ½œæ±Ÿ 2026-08 ä»æ˜¯æ—§é¡¹ç›®é”™å€¼ï¼Œè¯´æ˜Žæœ¬æŠ¥å‘Šå½“时的 08 æœˆé‡å¯¼ç»“果未落到当前运行库。已在 2026-09-23 é‡å¯¼æ½œæ±Ÿ 2026-06/07/08 å¹¶å®Œæˆåº“内/导出验证，详见 `docs/功能测试报告/功能测试报告_潜江投资物流月报重导_2026-09-23.md`。

## ä¸‰ã€æµ‹è¯•ç”¨ä¾‹ä¸Žç»“æžœ

| # | ç”¨ä¾‹ | è¾“å…¥ | é¢„期 | å®žé™… | ç»“论 |

 docs/¹¦ÄܲâÊÔ±¨¸æ/¹¦ÄܲâÊÔ±¨¸æ_DZ½­Í¶×ÊÎïÁ÷Ô±¨Öص¼_2026-09-23.md

New file
@@ -0,0 +1,67 @@
# åŠŸèƒ½æµ‹è¯•æŠ¥å‘Š â€” æ½œæ±Ÿç‰©æµæŠ•èµ„月报 2026-06/07/08 é‡å¯¼ä¿®æ­£

> æµ‹è¯•æ—¥æœŸï¼š2026-09-23
> è¢«æµ‹å¯¹è±¡ï¼šæŠ•èµ„市州单表导入（`POST /api/import/batch`，`type=investmentLogistics`）+ ç‰©æµç«™åœºæŠ•èµ„明细导出
> èƒŒæ™¯ï¼š09-22 å·²ä¿®å¤â€œæ½œæ±Ÿå¤šåŽ†å² sheet é€‰é”™é¡µç­¾â€ï¼Œä½†äº¤æŽ¥é—留明确要求重导 2026-06/07。复核当前应用实际连接库时又发现 2026-08 ä»æ˜¯æ—§é¡¹ç›®é”™å€¼ã€‚

## ä¸€ã€åŠŸèƒ½è¯´æ˜Žä¸Žæ•°æ®ä¿®æ­£

本次没有改业务代码，使用现有重导/幂等逻辑修正当前应用库 `3305/traffic_audit` çš„潜江物流 2026-06、2026-07、2026-08 æœˆåº¦æ•°æ®ï¼š

| æœŸé—´ | æºæ–‡ä»¶ | æºè¡¨å½“期页签 | æºè¡¨å…³é”®å€¼ï¼ˆH/J/K） |
| --- | --- | --- | --- |
| 2026-06 | `docs/投资/输入/物流（物流园区）/6月/潜江2026.06.xlsx` | `潜江传化2022.3`，表内报表期 `2026.06.22` | `11947.9 / 1135 / 0` |
| 2026-07 | `docs/投资/输入/物流（物流园区）/7月/潜江2026.07.xlsx` | `潜江传化2022.3`，表内报表期 `2026.07.22` | `11947.9 / 1135 / 0` |
| 2026-08 | `docs/投资/输入/物流（物流园区）/8月/潜江2026.08.xlsx` | `潜江传化2022.3`，表内报表期 `2026.08.24` | `11947.9 / 1135 / 0` |

修正前当前应用库三个月均挂旧项目“潜江传化公路港项目”，2026-08 ä¸º `5173 / 12000 / 5173 / 1440`；修正后三个月均挂“中国虾谷冷链仓储物流园”，月度值为 `start_cum=11947.9 / year_plan=0 / year_cum=1135 / month_done=0 / progress_stage=在建`。

## äºŒã€æµ‹è¯•çŽ¯å¢ƒ

- åŽç«¯ï¼š`start-dev.ps1` å¯åŠ¨ï¼Œ8090 æ—¥å¿—出现 `Started TrafficAuditApplication`。
- æ•°æ®åº“：`jdbc:mysql://localhost:3305/traffic_audit`，`root/root`。
- ç™»å½•ï¼š`admin/123456`，验证码配置 `required=false`。
- å¯¼å…¥æ–¹å¼ï¼šåªä¸Šä¼ å¯¹åº”月份的潜江单文件，避免全目录导入改动其他市州。
- å¯¼å‡ºéªŒè¯ï¼š`GET /api/report/export/investLogisticsDetail?period=2026-08&mode=month`。

## ä¸‰ã€æµ‹è¯•ç”¨ä¾‹ä¸Žç»“æžœ

| # | ç”¨ä¾‹ | è¾“å…¥ | é¢„期 | å®žé™… | ç»“论 |
| --- | --- | --- | --- | --- | --- |
| 1 | 2026-06 æ­£å‘重导 | `潜江2026.06.xlsx` | é€‰å½“期页，成功 1 æ¡ | æŽ¥å£ `success=1`；库内项目“中国虾谷冷链仓储物流园”，值 `11947.9 / 0 / 1135 / 0` | âœ… |
| 2 | 2026-07 æ­£å‘重导 | `潜江2026.07.xlsx` | é€‰å½“期页，成功 1 æ¡ | æŽ¥å£ `success=1`；库内项目“中国虾谷冷链仓储物流园”，值 `11947.9 / 0 / 1135 / 0` | âœ… |
| 3 | 2026-08 ä¸€è‡´æ€§ä¿®æ­£ | `潜江2026.08.xlsx` | å½“前应用库不再保留旧项目错值 | æŽ¥å£ `success=1`；库内改为“中国虾谷冷链仓储物流园”，值 `11947.9 / 0 / 1135 / 0` | âœ… |
| 4 | è´Ÿå‘-历史页签不泄漏 | ä¸‰ä»½æ–‡ä»¶å‡å« 2018/2019 ç­‰åŽ†å² sheet | ä¸å¾—导入“潜江传化公路港项目”的历史行 | ä¸‰ä¸ªæœˆåº“内均无该项目月度记录；选中页均以表内 `2026.xx.xx` æŠ¥è¡¨æœŸå‘½ä¸­ | âœ… |
| 5 | å…¥åº“抽查 | ä¸‰ä»½æºè¡¨å½“前页 H/J/K | åº“内逐项一致 | 6/7/8 æœˆå‡ä¸º `11947.9 / 1135 / 0`，项目名、建设阶段一致 | âœ… |
| 6 | å¹‚ç­‰-重复重导 | ä¸‰ä»½æ–‡ä»¶å„再导入一次 | ä¸æ–°å¢žé‡å¤æœˆåº¦è¡Œæˆ–重复项目 | 6/7/8 æœˆå„保持 `monthly_rows=1`、`projects=1`；潜江重名项目数 `0` | âœ… |
| 7 | ç«¯åˆ°ç«¯å¯¼å‡º | 2026-08 ç‰©æµç«™åœºæŠ•èµ„明细 | æ½œæ±Ÿè¡Œå–新值，不结转旧值 | è¾“出 `_tmp/qa_qianjiang_20260923/生成_物流站场投资明细_2026-08.xls`，`分项目投资完成情况` ç¬¬ 180 è¡Œä¸ºâ€œä¸­å›½è™¾è°·å†·é“¾ä»“储物流园”，金额 `11947.9 / 1135 / 0` | âœ… |

## å››ã€å…³é”®å‘现：验证库与应用实际连接库不一致

- å½“前运行配置 `traffic-audit-server/src/main/resources/application.yml` æŒ‡å‘ `localhost:3305/traffic_audit`。
- 09-22《功能测试报告_投资明细表取数修复》记录的验证环境是 `localhost:3308/traffic_audit`。
- æœ¬æ¬¡ç›´æŽ¥æŸ¥è¯¢å½“前应用库 `3305` æ—¶ï¼Œæ½œæ±Ÿ 2026-08 ä»æ˜¯æ—§é¡¹ç›® `5173/12000/5173/1440`，说明 09-22 çš„ 08 æœˆä¿®æ­£æ²¡æœ‰åæ˜ åˆ°æœ¬æ¬¡å®žé™…运行库。`3308` å½“前无法连接（HTTP/MySQL è¿žæŽ¥è¢«æ‹’绝），因此不能继续以该库作为交付验收依据。
- å¤„理：本次在同一后端会话中重导 6/7/8 ä¸‰ä¸ªæœˆï¼Œå¹¶åœ¨ `3305` ä¸Šå®Œæˆåº“内抽查和 2026-08 ç«¯åˆ°ç«¯å¯¼å‡ºéªŒè¯ã€‚

## äº”、数据变更说明

| è¡¨ | æœŸé—´ | ä¿®æ­£å‰ | ä¿®æ­£åŽ |
| --- | --- | --- | --- |
| `investment_monthly` | 2026-06 | æ½œæ±Ÿä¼ åŒ–公路港项目 `3685/12000/3685/1520` | ä¸­å›½è™¾è°·å†·é“¾ä»“储物流园 `11947.9/0/1135/0` |
| `investment_monthly` | 2026-07 | æ½œæ±Ÿä¼ åŒ–公路港项目 `3733/12000/3733/48` | ä¸­å›½è™¾è°·å†·é“¾ä»“储物流园 `11947.9/0/1135/0` |
| `investment_monthly` | 2026-08 | æ½œæ±Ÿä¼ åŒ–公路港项目 `5173/12000/5173/1440` | ä¸­å›½è™¾è°·å†·é“¾ä»“储物流园 `11947.9/0/1135/0` |

- æœªåˆ é™¤ä»»ä½• `investment_project` ä¸»æ¡£ï¼›æ—§é¡¹ç›®ä¸»æ¡£ `id=108` ä¿ç•™ï¼Œä½†å…¶ 6/7/8 æœˆæ—§æœˆåº¦è®°å½•å·²æŒ‰å¸‚å·ž+类别+期间清理。
- æ–°å¢žé¡¹ç›®ä¸»æ¡£ `id=276`，类别 `物流园区`，后续三个月复用同一条主档。
- æœªæ”¹åŠ¨å…¶ä»–市州、其他期间、其他投资类别。

## å…­ã€é—留问题与下一步

1. æŠ•èµ„明细表 L/D/E/F åˆ—覆盖口径仍需《建设阶段归一表》后确认。
2. æ­¦æ±‰ç‰©æµ 8 æœˆã€é»„冈客运 8 æœˆæºæ•°æ®ä»æœªè¡¥é½ã€‚
3. P0 é¡¹ä¸å˜ï¼šäº¿å…ƒæŠ•èµ„项目按 Q7 è¿½åˆ—、导出前基数体检、2026-09 æ¯ç‰ˆã€‚
4. åŽç»­å†™æµ‹è¯•/交接文档时，必须先读取当前 `application.yml` æˆ–运行中进程配置，不能沿用上一轮报告的数据库端口作为验收环境。

## ä¸ƒã€ç»“论

潜江物流投资 2026-06、2026-07 åŽ†å²é”™å€¼å·²ä¿®æ­£ï¼›åŒæ—¶å‘现并修正了当前应用库遗漏的 2026-08 é”™å€¼ã€‚三个月重导均成功，历史页签未泄漏，重复导入保持幂等，2026-08 å¯¼å‡ºç«¯åˆ°ç«¯å–值正确。

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

New file
@@ -0,0 +1,69 @@
# å·¥ä½œæ—¥ç»“_2026-09-23

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

### 1. æ‹‰å–并同步公司仓库最新（未改业务代码）

- `git fetch origin` åŽå‘现远端有新提交，已**快进合并** `origin/main` åˆ°æœ¬åœ°ï¼š
  - `8b739ce docs(交接): ç»Ÿä¸€ 09-22 å…³æœºå¿«ç…§ï¼ˆåˆå¹¶åŒäº‹ç‰ˆæœ¬ï¼Œä¿®æ­£è¿è¡ŒçŠ¶æ€ä¸ºå®žæµ‹ï¼š8090/8080 åœ¨è¿è¡Œï¼‰`
  - `23f2d2c Merge remote-tracking branch 'origin/main'`
  - `48350f7 docs(交接): 09-22 å…³æœºäº¤æŽ¥å¿«ç…§ï¼ˆæŠ•èµ„比对与取数修复交付、运行状态、接手优先项）`
- åˆå¹¶åŽ `HEAD = 8b739ce = origin/main`，工作区干净、无未跟踪文件。

### 2. æ ¸å¯¹å½“日运行状态

- dev åŽç«¯ 8090：**未运行**（无 java è¿›ç¨‹ï¼›`backend.log` æœ€åŽå†™å…¥ 09-21 17:29）。
- dev å‰ç«¯ 8080：**未运行**（`frontend.log` æœ€åŽå†™å…¥ 09-21 17:36）。
- MySQL：本机 `MySQL57`、`MySQL80` æœåŠ¡å‡ **Running**（库 `traffic_audit`，`localhost:3305`，`root/root`）。
- å…¶å®ƒ node/cmd è¿›ç¨‹ä¸º Codex è‡ªèº«ç»„件，未触碰。

### 3. è…¾è®¯æ–‡æ¡£åœ¨çº¿è¡¨æ ¼è¯»å–调研（本次对话主要产出）

用户给定只读分享链接 `https://docs.qq.com/sheet/DQ2ZLR09Kcm9ZcUpI?nlc=1&tab=000004`，问题链：能不能读 â†’ èƒ½ä¸èƒ½è¯»å…¨éƒ¨é¡µç­¾ â†’ èƒ½ä¸èƒ½åªè¯»æŸäº›å•å…ƒæ ¼ â†’ ä¸å€ŸåŠ©å¤§æ¨¡åž‹ trafficAudit èƒ½ä¸èƒ½è¯» â†’ è…¾è®¯å®˜æ–¹ API è¡Œä¸è¡Œã€‚逐条调研结论：

- **能读**：文档名《2026年十一数据》，只读，共 10 é¡µç­¾ï¼ˆé“è·¯/民航/道路/æ°´è·¯/高速公路/普通国省道/营业性客运量/人员流动量汇总/报厅办1/报厅办2）。方式为打开文档 â†’ æ‰“印 â†’ ã€Œæ•´ä¸ªå·¥ä½œç°¿ã€â†’ æ‰“印预览，预览渲染出 15 ä¸ª SVG é¡µæ®µï¼Œè¯»å–其中 `<text>` èŠ‚点即得**显示值**（含表头/日期/数值/百分比/`#DIV/0!`）。
- **能力边界**：读的是显示值；读不到原始公式、隐藏行列、打印范围外内容；不易恢复精确 A1 åæ ‡ã€‚
- **trafficAudit ç›®å‰ä¸æ”¯æŒ**：全仓无腾讯文档/分享链接/Open API é›†æˆï¼›å¯¼å…¥åªèµ°æœ¬åœ°æ–‡ä»¶ä¸Šä¼ ï¼ˆ`el-upload`，`.xlsx/.xls/.et`），后端 `MultipartFile` + Apache POI `WorkbookFactory.create`；目录导入只扫服务器本地目录。
- **腾讯官方 API å¯è¡Œ**：Open API V3 æ”¯æŒæŒ‰ A1 èŒƒå›´è¯»å•å…ƒæ ¼ï¼ˆ`GET /openapi/spreadsheet/v3/files/{fileId}/{sheetId}/{range}`，返回 `gridData.rows[].values[].cellValue`），但需 OAuth 2.0 ç”¨æˆ·æŽˆæƒ + åº”用凭证（`Client-Id`/`Access-Token`/`Open-Id`）+ `scope.sheet(.readonly)`；单次行 â‰¤1000、列 â‰¤200、总单元格 â‰¤10000；仅凭分享链接不能匿名调用。
- **建议**：落产品走官方 Open API V3；浏览器打印预览只作一次性取证。

### 4. å†™å‡º 09-23 äº¤æŽ¥æ–‡æ¡£ï¼ˆä¾›æ–°å¯¹è¯ç»­æŽ¥ï¼‰

- æ–°å¢ž `docs/交接文档_2026-09-23.md`：现状快照（git/进程/启动命令/git å·¥ä½œæµï¼‰ã€09-22 å·²å®Œæˆæ‘˜è¦ã€è…¾è®¯æ–‡æ¡£è¯»å–调研全结论、当前待办、关键文件与命令索引。
- æ›´æ–° `HANDOFF.md` é¡¶éƒ¨ã€Œæœ€æ–°ã€èŠ‚，加 09-23 å…¥å£ï¼ŒæŒ‡å‘新交接文档。

### 5. æ½œæ±Ÿç‰©æµæŠ•èµ„月报重导修正（新增）

- æŒ‰äº¤æŽ¥é—留重导潜江物流 2026-06、2026-07；核对当前运行配置时发现应用实际连接 `3305/traffic_audit`，而 09-22 æŠ¥å‘ŠéªŒæ”¶è®°å½•å†™çš„是 `3308`，当前 `3305` åº“çš„ 2026-08 ä»æ˜¯æ—§é¡¹ç›®é”™å€¼ã€‚
- åªä¸Šä¼ å„月潜江单文件重导 6/7/8 ä¸‰ä¸ªæœˆï¼ŒæŽ¥å£å‡ä¸º `success=1`；三个月均改为“中国虾谷冷链仓储物流园”，月度值 `11947.9 / 0 / 1135 / 0`。
- é‡å¤å¯¼å…¥ä¸€æ¬¡éªŒè¯å¹‚等：6/7/8 æœˆå„保持 1 æ¡æœˆåº¦æ•°æ®ã€1 ä¸ªé¡¹ç›®ï¼Œæ½œæ±Ÿé‡åé¡¹ç›®æ•° 0；2026-08 ç‰©æµæ˜Žç»†å¯¼å‡ºç¬¬ 180 è¡Œå–值正确。
- æŠ¥å‘Šï¼š`docs/功能测试报告/功能测试报告_潜江投资物流月报重导_2026-09-23.md`。

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

- ä»Šæ—¥**无业务代码改动**；新增一次数据重导功能测试，正向、历史页签负向、入库抽查、幂等与导出验证全部通过。
- æ–‡æ¡£/调研类产出：`git fetch` åˆå¹¶ç»“果、运行状态实测、腾讯文档读取三组结论均经实际验证（浏览器实测读值 + å…¨ä»“代码检索 + å®˜æ–¹æ–‡æ¡£æ ¸å¯¹ï¼‰ã€‚
- æ½œæ±Ÿç‰©æµæŠ•èµ„ 2026-06/07/08 ä¸‰ä¸ªæœˆå·²ä¸Žæºè¡¨é€é¡¹å¯¹é½ï¼›2026-08 å¯¼å‡ºç«¯åˆ°ç«¯å–值正确。测试报告见 `docs/功能测试报告/功能测试报告_潜江投资物流月报重导_2026-09-23.md`。
- åˆå¹¶åŽå·¥ä½œåŒºå¹²å‡€ï¼›æ— ç¼–译/回归风险（未触碰 Java/Vue æºç ï¼‰ã€‚

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

1. **投资明细表下一轮**：潜江 2026-06/07/08 é‡å¯¼å·²é—­çŽ¯ï¼›å‰©ä½™ L/D/E/F è¦†ç›–口径（需《建设阶段归一表》）、补武汉物流 8 æœˆå•è¡¨ã€é»„冈客运 8 æœˆæºæ–‡ä»¶ã€æœªè¦†ç›–行清单出文件/页面提示（P1-9）。
2. **汇总大表**：304 æ ¼ã€Œ2025 ç´¯è®¡åˆ—少加 7、8 æœˆã€ä¸šåŠ¡å·²ç¡®è®¤å¯æ¸…空，待落实。
3. **P0 ä¸å˜**：亿元投资项目按 Q7 è¿½åˆ—（P0-2）；导出前基数体检（P0-3）；2026-06/09 æ¯ç‰ˆç¼ºå¤±ï¼ˆP0-4）。
4. **P2-2 å¾…核实**：城市客运页表头日期序列号可能已由 `fixCityMonthHeaderText()` ä¿®å¥½ï¼Œè·‘一次 2026-08 å¯¼å‡ºç¡®è®¤åŽå†æ”¹æ–‡æ¡£ã€‚
5. **潜在新需求（未立项）**：腾讯文档在线表格导入（官方 Open API V3 + OAuth），如需开发需先准备开放平台应用与授权。

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

1. æŒ‰ç”¨æˆ·ä¼˜å…ˆçº§æŽ¨è¿›æŠ•èµ„明细表下一轮（先向用户/业务确认《建设阶段归一表》口径，再动覆盖逻辑）。
2. è¡¥æ­¦æ±‰ç‰©æµ 8 æœˆã€é»„冈客运 8 æœˆæºæ•°æ®ï¼›ç»§ç»­æŽ¨è¿› L/D/E/F å£å¾„与未覆盖清单落文件。
3. è·‘一次 2026-08 æ±‡æ€»å¤§è¡¨å¯¼å‡ºï¼Œæ ¸å¯¹ P2-2 åŸŽå¸‚客运表头后再更新文档。
4. è§†ç”¨æˆ·éœ€è¦ï¼Œè¯„估腾讯文档 Open API è¯»å–的最小可用实现（仅读指定单元格范围）。

## äº”、关机/交接快照（2026-09-23 08:52 ç»­æŽ¥æ›´æ–°ï¼‰

- **git**：基线 `main = 8b739ce`，已同步 `origin/main`；本次续接新增潜江重导测试报告并更新日结、HANDOFF、09-23 äº¤æŽ¥æ–‡æ¡£ã€‚
- **运行状态（09-23 08:50 å®žæµ‹ï¼‰**：dev åŽç«¯ 8090、前端 8080 å·²å¯åŠ¨å¹¶å°±ç»ªï¼›åº”用实际数据库为 `localhost:3305/traffic_audit`。
- **下次启动**：项目根 `powershell -NoProfile -ExecutionPolicy Bypass -File start-dev.ps1`（沙箱外）。
- **新对话入口**：说「读 HANDOFF.md ç»§ç»­ã€â†’ HANDOFF.md â†’ AGENTS.md â†’ `docs/交接文档_2026-09-23.md`（本次增量）→ `docs/交接文档_2026-09-21.md`（系统全景 + P0/P1/P2）。

 docs/ÎÊÌâ»ã×Ü/Êý¾Ý²é¿´»ã×ÜÓë»ã×Ü´ó±í¿Ú¾¶¶ÔÓ¦¹Øϵ_2026-09-23.md

New file
@@ -0,0 +1,40 @@
# æ•°æ®æŸ¥çœ‹ã€ŒæŒ‰å¸‚州汇总」与「汇总大表」口径对应关系与一致性核对（2026-09-23）

> æ ¸å¯¹æ—¥æœŸï¼š2026-09-23　提问：数据查看里的汇总功能与大表生成的数据是否一致
> æ ¸å¯¹æ–¹å¼ï¼šå¤§è¡¨å–自程序输出 `D:\桌面\生成数据\生成_道路运输量汇总表_2026-08 (3).xlsx`（含缓存直出，2026-09-22 14:10 ç”Ÿæˆï¼‰ï¼›æ•°æ®æŸ¥çœ‹å–自 `/api/data/summary?from=2026-01&to=2026-08`
> è„šæœ¬ï¼š`_tmp_cmp_dabiao2.py`（大表逐月列加总 vs æ±‡æ€»æŽ¥å£é€å€¼æ¯”对）

## ä¸€ã€ç»“论

**一致。** ä¸‰ä¸ªå¯ç›´æŽ¥å¯¹ä½çš„口径（城市公交、巡游出租、网约车）**逐位相同**：

| é¡¹ç›® | æ¯”对值个数 | è¶…出容差(>0.01) | æœ€å¤§ç»å¯¹å·® |
| --- | --- | --- | --- |
| åŸŽå¸‚公交（客运量/旅客周转量/城市内两项 Ã— å…¨çœ+17市州） | 72 | 0 | 0.000000 |
| å·¡æ¸¸å‡ºç§Ÿï¼ˆåŒä¸Š 4 æŒ‡æ ‡ï¼‰ | 72 | 0 | 0.000000 |
| ç½‘约车（拆分口径 4 æŒ‡æ ‡ï¼‰ | 72 | 0 | 0.000000 |

货运侧因为大表分「规上 / è§„下 / åˆè®¡ã€ä¸‰å—，需按块对应（见第二节），**对应后也完全一致**。

## äºŒã€å£å¾„对应关系

| æ•°æ®æŸ¥çœ‹ç±»åž‹ | å¯¹åº”大表位置 | å£å¾„ | æ ¸å¯¹æ ·ä¾‹ï¼ˆ2026 å¹´ 1-8 æœˆï¼‰ |
| --- | --- | --- | --- |
| `cityBus` åŸŽå¸‚公共交通 | ã€Œå…¬äº¤ã€é¡µå„市州 4 æŒ‡æ ‡ | å°è´¦å€¼é€æœˆç›¸åŠ  | å…¨çœå®¢è¿é‡ 110776.34 ä¸‡äººæ¬¡ã€æ—…客周转量 738254.64 ä¸‡äººå…¬é‡Œ â€”— é€ä½ä¸€è‡´ |
| `cityTaxi` å·¡æ¸¸å‡ºç§Ÿ | ã€Œå‡ºç§Ÿã€é¡µå„市州 4 æŒ‡æ ‡ | åŒä¸Š | å…¨çœå®¢è¿é‡ 48069.02 ä¸‡äººæ¬¡ã€æ—…客周转量 280664.05 ä¸‡äººå…¬é‡Œ â€”— é€ä½ä¸€è‡´ |
| `wycOrder` ç½‘约车 | ã€Œç½‘约车」页各市州 4 æŒ‡æ ‡ | æ‹†åˆ†å£å¾„（订单占比 Ã— å…¨çœ pin，城市内按巡游出租占比代理），与 `WycSplitCalc` åŒæº | å…¨çœå®¢è¿é‡ 33864.94 ä¸‡äººæ¬¡ç­‰ 4 é¡¹ â€”— é€ä½ä¸€è‡´ |
| `h2032` è´§è¿ä¼ä¸š | ã€Œè´§è¿é‡æŽ’名 / è´§è¿å‘¨è½¬é‡æŽ’名」的**规上**列 | è§„上企业月报（h2032） | å…¨çœè§„上货运量 31399.8248 ä¸‡å¨ = 313,998,248 å¨ï¼ˆä¸€è‡´ï¼‰ï¼›æ­¦æ±‰ 10072.9811 ä¸‡å¨ = 100,729,811 å¨ï¼ˆä¸€è‡´ï¼‰ |
| `freightTurnover` è´§è¿é‡å‘¨è½¬é‡ | ã€Œé“路运输周转量」的道路货运周转量列；货运量 = å¤§è¡¨ã€Œè§„上 + è§„下」合计 | è§„上+规下（全口径） | å…¨çœå‘¨è½¬é‡ 17,492,129.0479 ä¸‡å¨å…¬é‡Œï¼ˆä¸€è‡´ï¼‰ï¼›å…¨çœè´§è¿é‡ 130,311.89 ä¸‡å¨ = è§„上 31399.8248 + è§„下 98912.0679（一致） |

## ä¸‰ã€å£å¾„差异（不是数据差异，是设计差异）

1. **时点列**：数据查看汇总按用户要求不显示车辆数/企业数/站点数（不做累加）；大表的车辆数等按月取自台账。核对规模指标请回明细或直接看大表对应页。
2. **比率列**：数据查看汇总按累计口径重算（累计同比 = æœ¬æœŸç´¯è®¡ Ã· ä¸Šå¹´åŒæœŸç´¯è®¡ âˆ’ 1；平均运距 = ç´¯è®¡å‘¨è½¬é‡ Ã· ç´¯è®¡å®¢è¿é‡ï¼‰ï¼›å¤§è¡¨æ˜¯é€æœˆåŒæ¯”列 + ç‰ˆå¼å›ºå®šã€‚两者"月度同比"和"累计同比"不能直接互比，需按同一口径取值。
3. **覆盖范围**：数据查看只覆盖**可导入的数据表**（7 ç±»æ”¯æŒæ±‡æ€»ï¼‰ï¼›å¤§è¡¨è¿˜å«ç­çº¿åŒ…车、公路总客运、中口径明细/排名/分析、轨道轮渡、城市汇总/分市州、投资与能耗报表等，这些不在数据查看范围内。
4. **单位**：`h2032` ä¸ºå¨ / å¨å…¬é‡Œï¼Œ`freightTurnover` ä¸Žæ‹†åˆ†è¡¨ä¸ºä¸‡å¨ / ä¸‡å¨å…¬é‡Œï¼Œå¤§è¡¨ç»Ÿä¸€ç”¨ä¸‡å¨ / ä¸‡å¨å…¬é‡Œï¼ˆæ•°æ®æŸ¥çœ‹åˆ—名已标注单位）。

## å››ã€å¤æ ¸æ–¹æ³•ï¼ˆå¯å¤çŽ°ï¼‰

1. `GET /api/report/exportTask/summaryWorkbook?period=2026-08` ç”Ÿæˆ/取缓存 â†’ å– `生成_道路运输量汇总表_2026-08.xlsx`；
2. `GET /api/data/summary?type=<类型>&from=2026-01&to=2026-08` å–汇总；
3. è¿è¡Œ `_tmp_cmp_dabiao2.py`：按大表页签的第 3 è¡Œè¡¨å¤´è¯†åˆ« 2026 å¹´å„月列，逐市州逐指标加总后与汇总接口逐值比对（容差 0.01）。