trafficAudit.git

			@@ -4,6 +4,71 @@
			> 每天结束时：把当天进展、踩过的坑、新需求、未完成事项更新到本文件，然后可以放心开新对话。
			> 协作约定（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` 通过。
			- Codex 输入卡顿复核（已完成）：电脑与 Codex 于 09-22 12:54 重启后，`Codex++` 修复脚本仍启用；主渲染进程空闲 CPU 约 13.3%（单核），调试守卫 `installed=true`、本次会话 `dropped=16`。对比修复前约 115%，卡顿问题已解决。
			- 今日已完成（远端提交）：数据查看补齐网约车/个体客运、按市州汇总与导出 Excel、汇总大表进度弹窗与结果落盘缓存。
			- 汇总大表差异复核（2026-09-22）：软件输出与手工定稿经 Excel 全量重算后逐格比对，930 条差异中实质数值差异 314 条；其中 304 条为 2025 累计列少加 7、8 月（业务已确认可清空），10 条 ` 货运` 历史同比业务已确认软件正确。报告见 `docs/问题汇总/汇总大表_软件输出与手工定稿差异清单_2026-08_20260922.md`，明细见同名目录 CSV。
			- 未完成重点不变：P0-2《亿元投资项目》按 Q7 追列、P0-3 导出前基数体检、P0-4 2026-09 母版；其余见 `docs/交接文档_2026-09-21.md` 第 4 章。

			### 补充（2026-09-22 下午，投资取数修复第一轮）

			- 已修（代码 + 重导 + 回归）：① 导出去标点归一化匹配（荆州）；② 同名双档优先取当月有数据的档（十堰快递产业园二期）；③ 未覆盖行逐行 WARN 留痕；④ 导入表头去换行（天门 H/J/K 不再丢）；⑤ 导入按表内报表期选 sheet（潜江不再把 2018 年数据当 2026-08）。
			- 结果：2026-08 物流/客运明细逐格差异 156 → 129，无新增差异；未覆盖清单已能自动列出（物流武汉 6 行；客运黄石1/黄冈9/恩施1/仙桃1）。
			- 遗留（下一轮）：L/D/E/F 覆盖口径（需《建设阶段归一表》）、武汉物流与黄冈客运 8 月源数据、潜江 2026-06/07 历史错值重导、未覆盖清单出文件/页面提示（P1-9）。
			- 报告：`docs/功能测试报告/功能测试报告_投资明细表取数修复_2026-09-22.md`。

			### 补充（2026-09-22 下午，投资明细表比对）

			- 已完成：软件《客运站投资明细表》《物流站场投资明细》与人工版逐格比对（156 格差异），报告 `docs/功能测试报告/数据比对报告_投资明细表软件生成与人工版_2026-09-22.md`。
			- 捞出 3 类「会静默出数」的问题（都指向取数而非算术）：
			1. 导出用底稿模板 + 按项目名匹配库内当月数，匹配不上/库内无当月数就沿用上期值 —— 武汉物流（库内 0 条月度记录）整段保留 7 月值；荆州「中国供销公安商贸物流园」因库内名多一个点未覆盖。
			2. 库内同名双档：十堰「快递物流产业园二期」`id=154`(竣工2026)/`id=181`(竣工2029) 并存，导出取到旧档。
			3. 导入丢数：天门「天门市物流中心建设项目」库内 2026-08 累计/自年初/本月全为 0，源文件是 16677.7/16677.7/500（P1-5 原记录「源文件 H/J/K 列为空」与现文件不符，需更正）。
			- 另：导出不覆盖 L（建设阶段）列、单渠道市州的分组小计行填法、0/空白写法差异，均已在报告第五节给出处置建议。

			### 补充（2026-09-22 下午，另一会话收尾）

			- 本会话已完成（已推送）：汇总大表进度弹窗优化（完成后不再出现重复下载按钮）；导出结果落盘缓存（`docs/生成汇总大表/_cache/`，已 gitignore）；
			缓存守卫升级为数据指纹（依赖源表 `CHECKSUM TABLE` + 母版等文件身份，排除投资/能耗/审核/系统/导入日志）——无关导入不再失效、换母版必定失效，失效时进度弹窗给出说明。
			- 当前环境：后端 8090、前端 8080 运行中；导出缓存对 2026-08 有效（文件名带指纹）；最新提交 `06b1cb7`。
			- 剩余待办（已逐条核查，同事未触碰）：P0-2 亿元表按 Q7 追列（`ReportExportService.java:6251` 仍写同一格）、P0-3 基数体检（`getLastMidIssues()` 无调用方）、
			P0-4 2026-06/09 母版缺失、P1-7 投资资金渠道字段、P1-9 投资导出按月分目录 + 运行日志、P2-1 D 组增速排名措辞。
			- 待核实：`docs/交接文档_2026-09-21.md` 的 P2-2「城市客运页表头仍是日期序列号」可能过时——代码已有 `fixCityMonthHeaderText()`（09-03 加入），
			建议跑一次 2026-08 导出核对后再改文档。
			- 入口：`HANDOFF.md`（本文件）→ `AGENTS.md` → `docs/交接文档_2026-09-21.md` 第 4 章（P0/P1/P2 全量遗留）。

			### 关机交接快照（2026-09-22 晚）

			- 今日交付（两项，均已推送）：
			1. 《投资明细表软件生成 vs 人工版》逐格比对（156 格差异）+ 根因定位 —— `docs/功能测试报告/数据比对报告_投资明细表软件生成与人工版_2026-09-22.md`；
			2. 第一轮取数修复（导出 3 处 + 导入 2 处，含新发现的"潜江导入 2018 年历史 sheet"）—— `docs/功能测试报告/功能测试报告_投资明细表取数修复_2026-09-22.md`；回归后逐格差异 156 → 129，无新增差异。
			- git：`main` = `db0ee92`，已同步公司 `origin/main`（已合并同事 `13c2d36` 汇总大表差异复核）。工作区干净；仅本地未跟踪的临时产物（`_tmp_diff_tables_0922.md`、`_tmp/gen_new_0922/`、`_tmp__0922.`）和用户自己的 `docs/确认.docx` 未入库。
			- 运行状态（17:2x 实测）：dev 后端 `8090`、前端 `8080` 均在运行（HTTP 200；后端为本次修复后的构建，16:43 经 `start-dev.ps1` 重启）；关机后自然停止、不需手工处理。数据库 `3308`（本项目）与 `3305/3306` 按惯例保留，数据已持久化。
			- 下次启动：项目根目录 `powershell -NoProfile -ExecutionPolicy Bypass -File start-dev.ps1`（脚本会跳过已在跑的端口；前后端需在沙箱外运行）。
			- 保留产物（未经确认不删）：汇总大表 930 条差异报告/CSV、投资比对与修复报告、`_tmp_0922.`、`_tmp/gen_new_0922/`。
			- 本轮数据变更：仅重导修正 `investment_monthly` 天门、潜江 2026-08 两处数值，未删除任何项目主档、未动其他市州/期间。
			- 接手优先（明日）：
			1. L/D/E/F 列覆盖口径（需先确认《建设阶段归一表》：源表主体施工/竣工收尾/未开工/本年正式施工/暂停施工/前期 → 输出用词）；
			2. 补源数据：武汉物流 8 月无单表、黄冈客运 8 月无源文件（导出已能自动告警，共 15 行受影响）；
			3. 潜江 2026-06 / 2026-07 月度仍是 2018 历史 sheet 错值，用 6/7 月源表重导（不要用 8 月文件重导）；
			4. 「未覆盖行清单」目前只进 `backend.log`，按 P1-9 可再做成《校验报错_<年月>.xlsx》或页面提示；
			5. 既有 P0/P1 不变（亿元表按 Q7 追列、导出前基数体检、2026-09 母版等，见 `docs/交接文档_2026-09-21.md` 第 4 章）。

			## 最新（2026-09-21）

			- 最新总入口：`docs/交接文档_2026-09-21.md`（系统现状、P0/P1/P2 遗留、操作手册）；汇总大表专项见 `docs/问题汇总/汇总大表问题交接_2026-09-21.md`。

			@@ -4,6 +4,71 @@
			> 每天结束时：把当天进展、踩过的坑、新需求、未完成事项更新到本文件，然后可以放心开新对话。
			> 协作约定（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` 通过。
			- Codex 输入卡顿复核（已完成）：电脑与 Codex 于 09-22 12:54 重启后，`Codex++` 修复脚本仍启用；主渲染进程空闲 CPU 约 13.3%（单核），调试守卫 `installed=true`、本次会话 `dropped=16`。对比修复前约 115%，卡顿问题已解决。
			- 今日已完成（远端提交）：数据查看补齐网约车/个体客运、按市州汇总与导出 Excel、汇总大表进度弹窗与结果落盘缓存。
			- 汇总大表差异复核（2026-09-22）：软件输出与手工定稿经 Excel 全量重算后逐格比对，930 条差异中实质数值差异 314 条；其中 304 条为 2025 累计列少加 7、8 月（业务已确认可清空），10 条 ` 货运` 历史同比业务已确认软件正确。报告见 `docs/问题汇总/汇总大表_软件输出与手工定稿差异清单_2026-08_20260922.md`，明细见同名目录 CSV。
			- 未完成重点不变：P0-2《亿元投资项目》按 Q7 追列、P0-3 导出前基数体检、P0-4 2026-09 母版；其余见 `docs/交接文档_2026-09-21.md` 第 4 章。

			### 补充（2026-09-22 下午，投资取数修复第一轮）

			- 已修（代码 + 重导 + 回归）：① 导出去标点归一化匹配（荆州）；② 同名双档优先取当月有数据的档（十堰快递产业园二期）；③ 未覆盖行逐行 WARN 留痕；④ 导入表头去换行（天门 H/J/K 不再丢）；⑤ 导入按表内报表期选 sheet（潜江不再把 2018 年数据当 2026-08）。
			- 结果：2026-08 物流/客运明细逐格差异 156 → 129，无新增差异；未覆盖清单已能自动列出（物流武汉 6 行；客运黄石1/黄冈9/恩施1/仙桃1）。
			- 遗留（下一轮）：L/D/E/F 覆盖口径（需《建设阶段归一表》）、武汉物流与黄冈客运 8 月源数据、潜江 2026-06/07 历史错值重导、未覆盖清单出文件/页面提示（P1-9）。
			- 报告：`docs/功能测试报告/功能测试报告_投资明细表取数修复_2026-09-22.md`。

			### 补充（2026-09-22 下午，投资明细表比对）

			- 已完成：软件《客运站投资明细表》《物流站场投资明细》与人工版逐格比对（156 格差异），报告 `docs/功能测试报告/数据比对报告_投资明细表软件生成与人工版_2026-09-22.md`。
			- 捞出 3 类「会静默出数」的问题（都指向取数而非算术）：
			1. 导出用底稿模板 + 按项目名匹配库内当月数，匹配不上/库内无当月数就沿用上期值 —— 武汉物流（库内 0 条月度记录）整段保留 7 月值；荆州「中国供销公安商贸物流园」因库内名多一个点未覆盖。
			2. 库内同名双档：十堰「快递物流产业园二期」`id=154`(竣工2026)/`id=181`(竣工2029) 并存，导出取到旧档。
			3. 导入丢数：天门「天门市物流中心建设项目」库内 2026-08 累计/自年初/本月全为 0，源文件是 16677.7/16677.7/500（P1-5 原记录「源文件 H/J/K 列为空」与现文件不符，需更正）。
			- 另：导出不覆盖 L（建设阶段）列、单渠道市州的分组小计行填法、0/空白写法差异，均已在报告第五节给出处置建议。

			### 补充（2026-09-22 下午，另一会话收尾）

			- 本会话已完成（已推送）：汇总大表进度弹窗优化（完成后不再出现重复下载按钮）；导出结果落盘缓存（`docs/生成汇总大表/_cache/`，已 gitignore）；
			缓存守卫升级为数据指纹（依赖源表 `CHECKSUM TABLE` + 母版等文件身份，排除投资/能耗/审核/系统/导入日志）——无关导入不再失效、换母版必定失效，失效时进度弹窗给出说明。
			- 当前环境：后端 8090、前端 8080 运行中；导出缓存对 2026-08 有效（文件名带指纹）；最新提交 `06b1cb7`。
			- 剩余待办（已逐条核查，同事未触碰）：P0-2 亿元表按 Q7 追列（`ReportExportService.java:6251` 仍写同一格）、P0-3 基数体检（`getLastMidIssues()` 无调用方）、
			P0-4 2026-06/09 母版缺失、P1-7 投资资金渠道字段、P1-9 投资导出按月分目录 + 运行日志、P2-1 D 组增速排名措辞。
			- 待核实：`docs/交接文档_2026-09-21.md` 的 P2-2「城市客运页表头仍是日期序列号」可能过时——代码已有 `fixCityMonthHeaderText()`（09-03 加入），
			建议跑一次 2026-08 导出核对后再改文档。
			- 入口：`HANDOFF.md`（本文件）→ `AGENTS.md` → `docs/交接文档_2026-09-21.md` 第 4 章（P0/P1/P2 全量遗留）。

			### 关机交接快照（2026-09-22 晚）

			- 今日交付（两项，均已推送）：
			1. 《投资明细表软件生成 vs 人工版》逐格比对（156 格差异）+ 根因定位 —— `docs/功能测试报告/数据比对报告_投资明细表软件生成与人工版_2026-09-22.md`；
			2. 第一轮取数修复（导出 3 处 + 导入 2 处，含新发现的"潜江导入 2018 年历史 sheet"）—— `docs/功能测试报告/功能测试报告_投资明细表取数修复_2026-09-22.md`；回归后逐格差异 156 → 129，无新增差异。
			- git：`main` = `db0ee92`，已同步公司 `origin/main`（已合并同事 `13c2d36` 汇总大表差异复核）。工作区干净；仅本地未跟踪的临时产物（`_tmp_diff_tables_0922.md`、`_tmp/gen_new_0922/`、`_tmp__0922.`）和用户自己的 `docs/确认.docx` 未入库。
			- 运行状态（17:2x 实测）：dev 后端 `8090`、前端 `8080` 均在运行（HTTP 200；后端为本次修复后的构建，16:43 经 `start-dev.ps1` 重启）；关机后自然停止、不需手工处理。数据库 `3308`（本项目）与 `3305/3306` 按惯例保留，数据已持久化。
			- 下次启动：项目根目录 `powershell -NoProfile -ExecutionPolicy Bypass -File start-dev.ps1`（脚本会跳过已在跑的端口；前后端需在沙箱外运行）。
			- 保留产物（未经确认不删）：汇总大表 930 条差异报告/CSV、投资比对与修复报告、`_tmp_0922.`、`_tmp/gen_new_0922/`。
			- 本轮数据变更：仅重导修正 `investment_monthly` 天门、潜江 2026-08 两处数值，未删除任何项目主档、未动其他市州/期间。
			- 接手优先（明日）：
			1. L/D/E/F 列覆盖口径（需先确认《建设阶段归一表》：源表主体施工/竣工收尾/未开工/本年正式施工/暂停施工/前期 → 输出用词）；
			2. 补源数据：武汉物流 8 月无单表、黄冈客运 8 月无源文件（导出已能自动告警，共 15 行受影响）；
			3. 潜江 2026-06 / 2026-07 月度仍是 2018 历史 sheet 错值，用 6/7 月源表重导（不要用 8 月文件重导）；
			4. 「未覆盖行清单」目前只进 `backend.log`，按 P1-9 可再做成《校验报错_<年月>.xlsx》或页面提示；
			5. 既有 P0/P1 不变（亿元表按 Q7 追列、导出前基数体检、2026-09 母版等，见 `docs/交接文档_2026-09-21.md` 第 4 章）。

			## 最新（2026-09-21）

			- 最新总入口：`docs/交接文档_2026-09-21.md`（系统现状、P0/P1/P2 遗留、操作手册）；汇总大表专项见 `docs/问题汇总/汇总大表问题交接_2026-09-21.md`。