docs: 修正潜江投资物流重导验证记录

xyc

8 天以前 3b68e9e811b9edc5a7abf7c53be37d6274f51d7d

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

@@ -60,19 +60,68 @@
- **表头补单位**：12 ç±»è¡¨ 60 ä½™åˆ—按库内注释/源文件核对补齐（万人次、万人公里、吨、吨公里、万吨、万吨公里、人、人公里、辆、座、公里、车次、万元、平方米、名、%）；
  èƒ½è€—燃料三项库内无单位注释，标注"(按燃料单位)"未臆造。

### 8. æ•°æ®æŸ¥çœ‹ã€ŒæŒ‰å¸‚州汇总 + å¯¼å‡º Excel」落地（第五轮，主线功能）

- æ–°å¢ž `CityRollupService` + ä¸‰ä¸ªæŽ¥å£ï¼š`/api/data/rollupTypes`、`/api/data/summary`、`/api/data/export`；
- æ”¯æŒ 7 ç±»ï¼šå…¬äº¤ã€å·¡æ¸¸å‡ºç§Ÿã€è´§è¿ä¼ä¸šã€å…¬è·¯æ—…客企业、个体客运、网约车（拆分口径）、货运量周转量；
- å£å¾„：任意起止月；流量求和、**时点列不参与**、比率按累计重算（累计同比自动取上年同期）；排名可选「留空 / æŒ‰ç´¯è®¡å€¼é‡æŽ’」；结果 = 17 å¸‚å·ž + å…¨çœåˆè®¡ï¼›
- å‰ç«¯ï¼šå·¥å…·æ åŠ ã€Œè§†å›¾ï¼šæ˜Žç»† / æŒ‰å¸‚州汇总」，汇总模式提供起止月、排名、汇总、导出 Excel；
- ä¿®å¤ä¸¤ä¸ªå£å¾„坑：货运量周转量表的"行内累计 + æ¹–北省合计行"重复计算（1,149,579 â†’ 130,311.89 ä¸‡å¨ï¼‰ã€ç»“束月无数据自动回退；
- ä¸Žæ‰‹å·¥æ ¸ç®—一致：公交 1-8 æœˆ 110776.34 ä¸‡äººæ¬¡ã€è´§è¿ä¼ä¸š 313,998,248 å¨ã€è´§è¿é‡å‘¨è½¬é‡ 130,311.89 ä¸‡å¨ã€‚
- æ”¶å°¾ï¼šæŒ‰ç”¨æˆ·è¦æ±‚把「全省合计」行提到最前面（武汉市之上），导出 Excel ä¸­åˆè®¡è¡ŒåŠ ç²—。

### 9. æ±‡æ€»å¤§è¡¨å¯¼å‡ºç»“果落盘缓存（用户："下载过就不该再等很久，能不能记住上次结果"）

- **背景**：原来只有「10 åˆ†é’Ÿå†… + æœŸé—´æ— æ–°å¯¼å…¥ã€çš„**内存**缓存，窗口短、重启即失效 â†’ ç¬¬äºŒæ¬¡ä¸‹è½½è¿˜è¦ç­‰ 13~17 ç§’。
- **改动**（`ReportExportTaskService.java` ä¸ºä¸»ï¼‰ï¼š
  1. ç»“æžœ**落盘**到 `docs/生成汇总大表/_cache/`，文件名 `<key>_v<数据版本>.xlsx`（数据版本=`MAX(import_batch.id)`），已加 `.gitignore`；
  2. æäº¤é¡ºåºï¼šå†…存缓存 â†’ è½ç›˜ç¼“存（同报表期 + åŒæ•°æ®ç‰ˆæœ¬ + 7 å¤©å†…）→ çœŸç®—；生成成功后写盘并删除同 key æ—§ç‰ˆæœ¬ï¼›
  3. å‰ç«¯æ–‡æ¡ˆï¼šå‘½ä¸­ç¼“存显示「本次直接沿用 <时间> ç”Ÿæˆçš„结果（期间没有新的数据导入）」，元信息改为「上次生成于 â€¦ã€ã€‚
- **顺带修 bug**：落盘命中时 `elapsedMs` ä¸ºè´Ÿæ•°ï¼ˆä»»åŠ¡èµ·ç‚¹ç”¨çŽ°åœ¨ã€ç»“束时间是历史生成时间）→ å·²æ”¹ä¸ºä»¥ç”Ÿæˆæ—¶é—´ä½œèµ·ç‚¹ã€‚
- **实测**：首次 12.4 s å†™ç¼“存；再次提交 **164 ms** å‘½ä¸­å†…存；**重启后端后提交 1.19 s å‘½ä¸­è½ç›˜**；临时插一条导入记录后 `fromCache=false` é‡æ–°ç”Ÿæˆï¼ˆéªŒè¯ã€Œæœ‰æ–°å¯¼å…¥å³å¤±æ•ˆã€ï¼‰ï¼›æµè§ˆå™¨ç‚¹å¯¼å‡ºç§’出、文案与按钮正确、控制台 0 æŠ¥é”™ã€‚

### 10. å¯¼å‡ºç¼“存守卫升级为「数据指纹」+ å¤±æ•ˆæç¤ºï¼ˆç”¨æˆ·ï¼šæŒ‰ä½ è¯´çš„做）

- **背景**：上一版缓存守卫用全局 `MAX(import_batch.id)`，①导入投资/能耗等无关数据会白失效；②**不含母版文件**，换母版时会错误命中旧结果（正确性漏洞）。
- **改动**（`ReportExportTaskService.java`）：
  1. æŒ‡çº¹ =「依赖源表 `CHECKSUM TABLE` æ ¡éªŒå’Œï¼ˆèƒ½æ•æ‰åŽŸåœ° UPDATE）」+「母版目录全部文件 + ç½‘约车订单 xlsx çš„名称/大小/修改时间」，SHA-256 å‰ 8 å­—节写进缓存文件名；
  2. æºè¡¨èŒƒå›´ç”¨**排除法**：排除投资 3 / èƒ½è€— 2 / å®¡æ ¸ 4 / ç³»ç»Ÿ 6 / `import_batch`，其余全纳入（宁可多算不可出错）；
  3. å¤±æ•ˆæç¤ºï¼ˆç¬¬ 3 æ­¥æç¤ºç‰ˆï¼‰ï¼šæ²¡å‘½ä¸­ä¸”有旧结果时，进度弹窗显示「上次生成的结果已因数据或母版变化失效，本次按最新数据重算。」
- **实测**：无关导入（投资项目 + å¯¼å…¥è®°å½•å„插一行）**仍命中**缓存；相关源表原地 UPDATE、改母版 mtime **必定失效**并重算；命中缓存时不再残留提示；浏览器实测提示行显示正常、控制台 0 æŠ¥é”™ï¼›æµ‹è¯•æ•°æ®å·²å…¨éƒ¨è¿˜åŽŸï¼ˆ419 æ‰¹æ¬¡ / 152 é¡¹ç›®ï¼‰ã€‚

### 11. äº¤æŽ¥æ”¶å°¾ï¼šåŒæ­¥åŒäº‹è¿›å±• + å‰©ä½™é¡¹æ ¸æŸ¥ï¼ˆç”¨æˆ·å‡†å¤‡å¼€æ–°ä¼šè¯ï¼‰

- **同事进展核实**（近三天 xyc / zyj è´¦å·çš„提交）：改动**全部集中在汇总大表线**——
  `abf468c` ä¸­å£å¾„排名累计同比基数改用母版 2025 é™æ€åˆ—（方案 A，`ReportExportService.java`）、`47a8734` è½¯ä»¶è¾“出与手工定稿差异报告、
  `ceaa5f2` AGENTS æ”¹å…¬å¸ gitea å•ä»“库、`a5a9545` 09-22 è®°å½•ä¸Ž Codex å¡é¡¿å¤æ ¸ã€`zyj` çš„ 8 æœˆæ¯ç‰ˆ 196 æ ¼æ–‡æœ¬è½¬æ•°å€¼ + å·®å¼‚清单。
- **剩余待办逐条核查，同事均未触碰**（有证据）：
  1. P0-2《亿元投资项目》按 Q7 è¿½åˆ— â€”— `ReportExportService.java:6251` ä»å†™åŒä¸€æ ¼ï¼ˆç¬¬ 24 åˆ—），无追列逻辑；
  2. P0-3 å¯¼å‡ºå‰åŸºæ•°ä½“检 +《数据缺失清单》页 â€”— `getLastMidIssues()` å…¨ä»“库无调用方；
  3. P0-4 ç¼º 2026-06 / 2026-09 æ¯ç‰ˆ â€”— æ¯ç‰ˆç›®å½•æ— è¿™ä¸¤ä¸ªæœˆæ–‡ä»¶ï¼›
  4. P1-7 æŠ•èµ„资金渠道分组 â€”— æ—  `fund_channel` å­—段；
  5. P1-9 æŠ•èµ„导出按月分目录 + è¿è¡Œæ—¥å¿—/校验报错 â€”— æ— å®žçŽ°ï¼›
  6. P2-1 D ç»„「增速排名」措辞 â€”— æ— ã€Œæš‚不排名」逻辑。
- **交接文档已同步**（commit `06b1cb7`）：§0 æœ€ç´§æ€¥æ¸…单 4→3 ä»¶å¹¶åˆ—出三项已闭环（十堰源文件 / ä¸­å£å¾„基数双轨制 / å¯¼å‡ºç¼“存）；
  P1-1 è¡¥æäº¤å· `abf468c`；§1.3 ä¸Ž Â§7.4 ä»Žã€ŒåŒä»“库」改为**公司 gitea å•ä»“库**；§6 ç´¢å¼•è¡¥åŒäº‹ä¸¤ä»½æ–‡æ¡£ã€‚
- **待核实（留给新会话）**：P2-2「城市客运页表头仍是日期序列号」可能已过时——代码里有 `fixCityMonthHeaderText()`（09-03 åŠ å…¥ï¼‰
  ä¼šæŠŠåŸŽå¸‚客运类表头序列号改写成「YYYYå¹´M月」；建议跑一次 2026-08 å¯¼å‡ºæ ¸å¯¹å®žé™…表头后再更新交接文档。

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

- æŠ¥å‘Šï¼š`docs/功能测试报告/功能测试报告_数据查看补齐网约车与个体客运类型_2026-09-22.md`
- æŠ¥å‘Šï¼š`docs/功能测试报告/功能测试报告_数据查看冻结列与数据类型下拉框_2026-09-22.md`（冻结列/下拉框真机用例 12 æ¡å…¨é€šè¿‡ï¼‰
- æŠ¥å‘Šï¼š`docs/功能测试报告/功能测试报告_数据查看展示优化与网约车按市州竖排_2026-09-22.md`（接口 6 æ¡ + çœŸæœº 6 æ¡å…¨é€šè¿‡ï¼‰
- æŠ¥å‘Šï¼š`docs/功能测试报告/功能测试报告_数据查看口径筛选与表头单位_2026-09-22.md`（接口 7 æ¡ + çœŸæœº 2 æ¡å…¨é€šè¿‡ï¼‰
- æŠ¥å‘Šï¼š`docs/功能测试报告/功能测试报告_数据查看按市州汇总与导出_2026-09-22.md`（接口 10 æ¡ + çœŸæœº 4 æ¡å…¨é€šè¿‡ï¼‰
- æŠ¥å‘Šï¼š`docs/功能测试报告/功能测试报告_汇总大表进度弹窗优化_2026-09-22.md`（6 æ¡ç”¨ä¾‹é€šè¿‡ï¼šç”Ÿæˆä¸­çŠ¶æ€ / å®Œæˆæç¤º / å†æ¬¡ä¸‹è½½èµ°ç¼“å­˜ / å…³é—­ / æ— æŽ§åˆ¶å°æŠ¥é”™ / å…¶å®ƒå¯¼å‡ºæœªå—影响）
- æŠ¥å‘Šï¼š`docs/功能测试报告/功能测试报告_汇总大表导出结果落盘缓存复用_2026-09-22.md`（10 æ¡ç”¨ä¾‹é€šè¿‡ï¼šé¦–次生成写缓存 / å†…存命中 164ms / **重启后落盘命中 1.19s** / æœ‰æ–°å¯¼å…¥å³å¤±æ•ˆ / åŒ key åªç•™æœ€æ–°ç‰ˆæœ¬ / æ—¶é•¿æ˜¾ç¤ºä¿®å¤ / æµè§ˆå™¨ç«¯åˆ°ç«¯ï¼‰
- æŠ¥å‘Šï¼š`docs/功能测试报告/功能测试报告_导出缓存改用数据指纹_2026-09-22.md`（12 æ¡ç”¨ä¾‹é€šè¿‡ï¼šæ— å…³å¯¼å…¥ä»å‘½ä¸­ / ç›¸å…³æºè¡¨åŽŸåœ° UPDATE å¿…失效 / **换母版必失效** / å¤±æ•ˆæç¤ºæ˜¾ç¤º / å‘½ä¸­æ— æç¤º / æ•°æ®è¿˜åŽŸæ ¸å¯¹ï¼‰
- çŽ¯å¢ƒï¼šåŽç«¯ `mvn spring-boot:run`（8090，`Started TrafficAuditApplication`）；前端 `npm run serve`（8080，`Compiled successfully in 4769ms`）；MySQL `localhost:3308/traffic_audit`；登录 admin/123456 å– JWT。
- ç»“果：3 ä¸ªæ–°ç±»åž‹æ­£å‘（含期间/关键字筛选）、负向（未知类型、无数据期、无 token）全部通过；入库抽查条数与库内一致（20 / 20 / 139）；原有 15 ç±»å›žå½’正常。

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

1. ã€ä¸‹ä¸€æ­¥ä¸»ä½“工作】数据查看"按市州汇总"：任意起止月（年初至 N æœˆå³ 01~N）+ 17 å¸‚å·ž + åˆè®¡è¡Œï¼›**不放时点列**；比率列按累计口径重算；并支持导出 Excel。
1. ã€å·²å®Œæˆã€‘数据查看"按市州汇总 + å¯¼å‡º Excel"（见第 8 èŠ‚与《功能测试报告_数据查看按市州汇总与导出_2026-09-22.md》）。
2. æ±‡æ€»å£å¾„细则待业务确认：排名字段跨期需重新排名（先留空）；累计同比需要自动取上年同期期间。
3. å…³é”®å­—框对无名称列的表（网约车总数、网约车订单）无效，待优化。
4. å†»ç»“列依赖"标识列连续排在前面"的列序假设，若以后调整列序/新增类型需同步维护 `stickyProps`/`nameProps`。
@@ -83,3 +132,69 @@

1. å¼€å·¥"按市州汇总 + å¯¼å‡º Excel"：后端加 `/api/data/summary` ä¸Ž `/api/data/export`，前端加"明细/汇总"切换与导出按钮。
2. æ±‡æ€»ç»“果与报表/手工作业抽样核对（1-8 æœˆå…¬äº¤ã€å·¡æ¸¸å‡ºç§Ÿã€è´§è¿è§„上企业）。

## äº”、Codex æ¡Œé¢ç«¯è¾“入卡顿复核（2026-09-22）

- æŒ‰ 09-21 çš„修复方案，用户重启电脑和 Codex åŽå¤æ ¸ã€‚
- è¿›ç¨‹ï¼šChatGPT äºŽ 2026-09-22 12:54 æ–°å¯åŠ¨ï¼›ä¿®å¤è„šæœ¬ `fix-codex-typing-retry-storm.js` å­˜åœ¨ä¸” `user_scripts.json` ä»ä¸º `enabled=true`。
- æ€§èƒ½ï¼šä¸»æ¸²æŸ“进程（PID 7044）连续 10 ç§’采样约 `13.28%` å•æ ¸ï¼›ä¿®å¤å‰çº¦ `115%` å•æ ¸ã€‚
- å®ˆå«ï¼šè°ƒè¯•ç«¯å£ 9229 è¯»å– `window.__codexPlusRetryTimerGuardInstalled=true`，本次会话 `window.__codexPlusRetryTimerGuardDropped=16`。
- ç»“论：输入卡顿修复在重启后仍生效，问题已解决。


## å…­ã€æŠ•èµ„明细表「软件生成 vs äººå·¥ç‰ˆã€æ•°æ®æ¯”对（2026-08）

用户要求：把软件生成的《客运站投资明细表》《物流站场投资明细》与人工维护的两份定稿逐格比对，列出所有不同。

- **比对文件**：人工版 `D:\05_数据分类\投资\8月\8月客运站投资明细表.xlsx`、`8月物流站场投资明细.xls`
  vs è½¯ä»¶ç‰ˆ `D:\桌面\生成数据\生成_所选报表_2026-08 (1)\生成_客运站投资明细表.xlsx`、`生成_物流站场投资明细.xls`。
- **比对方法**：脚本逐页签逐格比对（`_tmp_diff_invest_0922.py`）；先核对 B åˆ—项目名逐行对齐（192/121 è¡Œå…¨éƒ¨ä¸€è‡´ï¼Œæ— é”™ä½ï¼‰ï¼Œå†ç»Ÿè®¡å·®å¼‚，最后回溯源文件 / æ•°æ®åº“ / åº•ç¨¿æ¨¡æ¿å®šä½æ ¹å› ã€‚
- **结果**：共 **156 æ ¼å·®å¼‚** â€”— å®¢è¿ã€Šæ˜Žç»†ã€‹12 +《汇总》4；物流《分项目投资完成情况》108 +《分市州规划内外》15 +《市州汇总》17，《月2》无差异。
- **根因（三方证据锁定）**：
  1. è½¯ä»¶å¯¼å‡º = åœ¨åº•ç¨¿ã€Šæ¨¡æ¿_X月…投资明细》上，把库内当月数据**按项目名称匹配**覆盖 H/J/K ä¸Ž M；**匹配不上或库内无当月数就静默沿用上期值** â€”— æ­¦æ±‰å¸‚物流（库内 0 æ¡æœˆåº¦è®°å½•ï¼‰æ•´æ®µä¿ç•™ 7 æœˆå€¼ï¼›è†å·žã€Œä¸­å›½ä¾›é”€å…¬å®‰å•†è´¸ç‰©æµå›­ã€ï¼ˆåº“内名多一个点，匹配失败）保留 7 æœˆå€¼ 7758.5/1600.1（库内/源表实际 15986/8227.5）。
  2. åº“内**同名双档**：十堰「快递物流产业园二期」有 `id=154`（竣工 2026）与 `id=181`（竣工 2029）两档，导出取到旧档，写了 7 æœˆå€¼ 20081/2900/214（应 20377/3196/296）。
  3. **导入丢数**：天门「天门市物流中心建设项目」库内 2026-08 çš„累计/自年初/本月全是 0，源文件是 16677.7/16677.7/500（P1-5 åŽŸè®°å½•ã€Œæºæ–‡ä»¶ H/J/K åˆ—为空」与现文件不符）。
  4. å¯¼å‡º**不覆盖 L（建设阶段）等非金额列** â†’ é»„石大冶湖冷链 L=暂停、十堰枢纽 L=前期、襄阳冷链中心 L=在建、随州民生物资 M çš„ 7 æœˆæ–‡å­—，都是底稿残留。
  5. å•æ¸ é“市州的**分组小计行**：软件填=市州合计，人工版不填；0 ä¸Žç©ºç™½çš„写法两边不同（不影响金额）。
  6. å®¢è¿éƒ¨åˆ†å·®å¼‚主要是**人工版手写四舍五入**（203 / 2531 / 43225.9 ç­‰ï¼‰ï¼Œä»¥åŠ 3 å¤„形象进度/建设阶段：M26、M85 äººå·¥ç‰ˆç©ºï¼ˆè½¯ä»¶ç‰ˆå–自源表与库内、是对的），L91 äººå·¥ç‰ˆã€Œåœ¨å»ºã€æ­£ç¡®ã€è½¯ä»¶ç‰ˆæ˜¯åº•ç¨¿æ—§å€¼ã€Œæš‚停施工」。
- **影响金额**：软件版物流「自开始累计」「自年初累计」各少 **34399.2 ä¸‡å…ƒ**、「本月完成」少 **6291.4 ä¸‡å…ƒ**。
- **报告**：`docs/功能测试报告/数据比对报告_投资明细表软件生成与人工版_2026-09-22.md`（含 156 æ ¼å…¨é‡æ¸…单 + é€æ¡æ ¸å¯¹ç»“论 + å¤„置建议）。
- **临时脚本（保留）**：`_tmp_diff_invest_0922.py`、`_tmp_dump_invest_full_0922.py`、`_tmp_diff_invest_annot_0922.py`、`_tmp_diff_tables_0922.py`、`_tmp_src_spotcheck_0922.py`、`_tmp_src_spotcheck2_0922.py`、`_tmp_db_probe*_0922.py`、`_tmp_tpl_*_0922.py` åŠå¯¹åº” `_*.txt` è¾“出。



## ä¸ƒã€æŠ•èµ„明细表取数修复（第一轮，已编译/重启/端到端验证）

按第六节比对结论动手修了三处"会静默出数"的取数缺陷，并顺带端到端暴露+修复了潜江导入选错历史页签。

- **导出**（`ReportExportService.java`）：
  1. `normInvestName()` å½’一化补标点（半/全角句点、顿号、分号等）→ è†å·žã€Œä¸­å›½ä¾›é”€.公安商贸物流园」可匹配，写入库内 15986/15986/8227.5；
  2. æ–°å¢ž `preferMonthlyCandidate()`：同名多档优先取「当月有数据」的档 â†’ åå °ã€Œå¿«é€’物流产业园二期」改取 id=181，写入 20377/3196/296、竣工 2029；
  3. æ–°å¢ž `logSkippedRows()`：未覆盖行逐行 WARN（`[未覆盖] ç¬¬N行 å¸‚å·ž é¡¹ç›®å â†’ åŽŸå› ` + æŒ‰å¸‚州统计），不再静默结转上期值。
- **导入**（`DataImportService.java`）：
  1. `investHeaderKey()` å…ˆåŽ»å…¨éƒ¨ç©ºç™½ï¼ˆå«æ¢è¡Œ/全角空格）再判定关键词 â†’ å¤©é—¨ H/J/K ä¸‰åˆ—恢复识别，2026-08 å…¥åº“ 16677.7/16677.7/500（原为 0/0/0）；
  2. æ–°å¢ž `investSheetPeriodCellHit()` + è¯„分加权 2000000：按表内报表期（`2026.08.24`）选 sheet，优先于「sheet åå«åŒæœˆã€â†’ æ½œæ±Ÿä¸å†æŠŠ **2018 å¹´**「潜江（8月）」当 2026-08，重导后 2026-08 å…¥åº“「中国虾谷冷链仓储物流园」11947.9/1135/0。
- **验证**：`mvn -o compile` é€šè¿‡ï¼›åœæ—§èµ·æ–°åŽç«¯ï¼ˆ8090 å°±ç»ªï¼‰ï¼›æŽ¥å£é‡å¯¼ + é‡è·‘ 2026-08 å¯¼å‡ºï¼›é€æ ¼æ¯”对**156 æ ¼ â†’ 129 æ ¼**（降 27 æ ¼ï¼šç‰©æµåˆ†é¡¹ç›® 108→91、分市州 15→11、市州汇总 17→11），无新增差异。
- **未覆盖清单（新增能力，来自日志）**：物流 6 è¡Œï¼ˆå…¨éƒ¨æ­¦æ±‰ï¼Œåº“内无当月数据）；客运 12 è¡Œï¼ˆé»„石 1「阳新综合客运枢纽站」、黄冈 9、恩施 1「咸丰县坪坝营旅游客运站」、仙桃 1「仙桃市毛嘴客运站」）。
- **报告**：`docs/功能测试报告/功能测试报告_投资明细表取数修复_2026-09-22.md`。
- **遗留（需拍板/补数）**：① L/D/E/F æ˜¯å¦æŒ‰å½“月覆盖（需《建设阶段归一表》）；② æ­¦æ±‰ç‰©æµã€é»„冈客运 8 æœˆæºæ•°æ®ç¼ºå¤±ï¼›â‘¢ æ½œæ±Ÿ 2026-06/07 æœˆåº¦ä»æ˜¯åŽ†å² sheet é”™å€¼ï¼Œéœ€ç”¨ 6/7 æœˆæºè¡¨é‡å¯¼ï¼ˆ**不要**用 8 æœˆæ–‡ä»¶é‡å¯¼ï¼‰ï¼›â‘£ æœªè¦†ç›–清单目前只进日志，建议按 P1-9 å‡ºã€Šæ ¡éªŒæŠ¥é”™_<年月>.xlsx》或页面提示。
- **数据变更**：仅重导修正了天门、潜江两处 2026-08 æœˆåº¦å€¼ï¼Œæœªåˆ é™¤ä»»ä½•é¡¹ç›®ä¸»æ¡£ã€æœªåŠ¨å…¶ä»–市州/期间；临时脚本与产物保留（`_tmp_*_0922.*`、`_tmp/gen_new_0922/`）。


## å…«ã€æ±‡æ€»å¤§è¡¨è½¯ä»¶è¾“出与手工定稿差异复核（2026-08）

- æ¯”对文件：软件输出 `生成_道路运输量汇总表_2026-08 (5).xlsx`，手工定稿 `2026å¹´8月客运量、货运量定稿.xlsx`。
- æ–¹æ³•ï¼šå…ˆç”¨ Excel COM å¯¹ä¸¤ä»½å‰¯æœ¬å…¨é‡é‡ç®—，再按页签、数据块、行标签、列头做语义对齐后逐格比对，避免读取 XLSX æ—§ç¼“存造成 `#VALUE!` å‡å·®å¼‚。
- ç»“果：930 æ¡é€æ ¼å·®å¼‚中，实质数值差异 314 æ¡ã€‚其中 304 æ¡æ˜¯å…¬äº¤/出租/网约车/中口径明细的 2025 ç´¯è®¡åˆ—少加 7、8 æœˆï¼Œä¸šåŠ¡å·²ç¡®è®¤è¯¥åˆ—可清空；另 10 æ¡æ˜¯ ` è´§è¿` 2022 å¹´ç´¯è®¡åŒæ¯”，业务已确认软件正确。
- å…¶ä½™å·®å¼‚：文本型数字 286 æ¡ã€å–整尾差 194 æ¡ã€ä»…软件有值 129 æ¡ã€ä»…手工有值 2 æ¡ã€é”™è¯¯å€¼ 2 æ¡ã€æ–‡æœ¬ä¸åŒ 2 æ¡ã€ç±»åž‹ä¸åŒ 1 æ¡ã€‚
- ç»“构差异：城市汇总/城市分市州/中口径分析/中口径排名存在软件多出的 8 æœˆå—或不同布局；两个货运排名页签块顺序相反；城市客运手工多一列 AJ；道路运输周转量手工多 AA/AB ç©ºåˆ—。可比业务数据均已逐块对齐核对。
- ä¸Šç‰ˆæŠ¥å‘Šä¸­çš„ `班线包车` 2019、2020 å¹´åŽ†å²å— `#VALUE!` ç»é‡ç®—确认是缓存假差异，本次已剔除。
- äº¤ä»˜ï¼š`docs/问题汇总/汇总大表_软件输出与手工定稿差异清单_2026-08_20260922.md`，逐格明细 `docs/问题汇总/汇总大表_差异明细_2026-08_20260922.csv`。

## ä¹ã€å…³æœºäº¤æŽ¥å¿«ç…§ï¼ˆ2026-09-22 17:20）

- **git**：拉取并合并公司仓库最新 `db0ee92`（投资明细取数/导入修复 + æ—¥ç»“第七/八节）；合并后本地编译 `mvn -q -DskipTests compile` é€šè¿‡ã€‚关机前将 HANDOFF、本日结快照提交并推送 `origin/main`。
- **运行状态**：dev åŽç«¯ `8090`、前端 `8080` å‡æœªè¿è¡Œï¼Œæœªå‘现对应 Java/Node è¿›ç¨‹ï¼›`backend.log` æœ€åŽå†™å…¥ 09-21 17:29，`frontend.log` æœ€åŽå†™å…¥ 09-21 17:36。MySQL80(`3305`)、MySQL57(`3306`) Running，关机后自动停止，无需手工处理。
- **下次启动**：项目根目录执行 `powershell -NoProfile -ExecutionPolicy Bypass -File start-dev.ps1`；数据库和生成缓存已持久化。
- **保留产物**：汇总大表差异报告/CSV、投资 156→129 æ ¼æŠ¥å‘Šã€`_tmp*_0922.*` ä¸Ž `_tmp/gen_new_0922/` ç­‰å‡ä¿ç•™ï¼Œæœªç»ç¡®è®¤ä¸åˆ é™¤ã€‚
- **下次优先**：P0-2《亿元投资项目》按 Q7 è¿½åˆ—、P0-3 å¯¼å‡ºå‰åŸºæ•°ä½“检、P0-4 2026-09 æ¯ç‰ˆï¼›æŠ•èµ„遗留需补武汉物流/黄冈客运 8 æœˆæºæ•°æ®ã€é‡å¯¼æ½œæ±Ÿ 2026-06/07 åŽ†å²é”™å€¼ã€å°†æœªè¦†ç›–清单落文件或页面。