trafficAudit.git

			@@ -17,9 +17,97 @@
			- 普通国省道环比基期（2026-10-02 追加）：普通国省道 C 列为可选环比基期，仅 2026 年启用；填写后只影响普通国省道车流量自身环比 `当日 / 基期 - 1`，未填写按前一日。`holiday_vehicle_flow.comparison_base` 已入库，导入导出与历史变更确认均已接入；折算人员流动量、总人员流动量和 Word 快报继续按 Excel 原公式，不受基期影响。2024/2025 不使用。
			- 快报首日口径（2026-10-02 追加）：假期第1天没有前一日环比基数，正文不输出“环比增长/下降/持平”短语，表格当日环比列为“—”；第2天起仍按实际前一日输出环比。已用 2025-10-01/02 快报回归验证。
			- 快报百分比精度（2026-10-02 追加）：Word 快报中同比/环比百分比统一保留1位小数（如6.79%显示6.8%、11.46%显示11.5%）；人次、车流等业务数值仍保留2位小数。
			- 验证结果：后端编译、前端构建、权限/CRUD/负向导入、历史变更两阶段导入、Excel 导出、Word 快报、前端 admin/非 admin 烟测均通过；菜单顺序、客运系数 2.4 展示（系统配置页 + 节假日统计页）、`decimal(30,15)` 列型、历史变更两阶段导入回归均已实测；报告见 `docs/功能测试报告/功能测试报告_重要节假日专项统计_2026-10-02.md`，日结见 `docs/工作日结/工作日结_2026-10-02.md`。
			- 验证结果：后端编译、前端构建、权限/CRUD/负向导入、历史变更两阶段导入、Excel 导出、Word 快报、前端 admin/非 admin 烟测均通过；菜单顺序、客运系数 2.4 展示（系统配置页 + 节假日统计页）、`decimal(30,15)` 列型、历史变更两阶段导入回归均已实测；功能测试报告与工作日结按 2026-09-27 提交规范仅本地留存（不入库）：`docs/功能测试报告/功能测试报告_重要节假日专项统计_2026-10-02.md`、`docs/工作日结/工作日结_2026-10-02.md`。
			- 运行状态：后端 8090、前端 8080 已启动；数据库 `127.0.0.1:3305/traffic_audit`。测试产生的 2026 临时数据和导入批次已清理。
			- Git：用户已于 2026-10-02 明确验收通过；本次按要求合并远端 `origin/main` 后提交并推送，不覆盖远端同事提交。
			- 部署模板同步：节假日 4 张表已同步到 `deploy-templates/db/init.sql`；`sql_holiday.sql` 及两个旧库迁移脚本随部署包发布，避免新包缺表。

			## 最新（2026-09-28）

			- 用户用 WPS 编辑母版：改《班线包车》边框、《道路运输周转量》字号，并删除《中口径明细》`AW` 列（手工定稿同删）。已验证生成端正常：中口径明细 2024 及更早块整体左移（跨页/同页公式自动改引用，`#REF!` 2→0）、中口径排名块 J..R → A..I 均正确带入产物。
			- ⚠️ WPS 保存的连带损坏（待回补）：《班线包车》2019/2020 块约 590 格内容丢失（`FN/FO/FM`、`FP:FT`、`GE` 变空；`EO/EQ/ES/EU/EW/EY/DT/DW...EM` 共 144 格变 `#DIV/0!`）。生成件已带出（该页 `#DIV/0!` 228→372）。待用户确认后按备份/定稿回补（只补值与公式，保留其边框与字号）。
			- 口径落地「缺数留空」：母版《货运》行 90/93（仙桃规上两行）、108/111（林区）在 2021、2022 年块的 78 个 `0` 值已清空（与手工定稿按表头对齐逐格核对：母版=0 且定稿=空 78 格、冲突 0 格）；代码 `FreightCalc.buildMetrics` 当月分支改为「该月无规上记录 → 留空」，不再写 0（累计分支不变）。
			- 纠正一条错判：此前「程序少一列 11 月环比」不成立——生成件与手工定稿的环比期间集合完全一致（12月…1月共 12 列）；差异根因是手工定稿《货运》在 2025 年块多一列无表头辅助列（`U`，74 格），自该列起手工整体右移 1 列。比对必须按表头期间对齐，不能按列位置比。
			- 验证：生成两次（约 15 秒/次），第二次相对第一次仅 78 格 0→空，错误值数量不变；`公交!S5=98460.97` 等缓存值抽查保留。
			- 运行状态：后端已按 `start-dev.ps1` 重启（新 PID，8090/8080 在跑）；本机库仍为 `localhost:3308/traffic_audit`。
			- ✅ 班线包车回补完成（09-28 下午）：用户确认后按 09-27 母版备份（`_bak_202608母版文本数字转数值前_20260927.xlsx`）XML 精准回补《班线包车》2019/2020 块 —— 该页与 09-27 母版逐格一致（0 差异），错误值回到 `#REF!` 8 / `#DIV/0!` 228；母版其它页未受影响。验收生成：与 09-27 生成件 (6) 比对错误值逐页一致，差异仅剩既定改动（` 货运` 78 格清 0、中口径明细 4915 格删列位移、中口径排名 672 格块位移、班线包车 82 格浮点尾差/0-空）。
			- 差异清单口径更新（09-28，用户确认）：① ` 货运` 新增的「规上+规下货运量」「规下货运量」各 17 行（母版设计，共 34 行）不计差异；② ` 货运!U5:U112` 无表头草稿列不计；③ 排名表「当月块」为母版设计不计；④ 市州短名/全名不影响（工具归一化）；⑤ 小差异（取整尾差/文本型数字）只计数，只列差异大的并附原因。工具 `docs/工具/汇总大表差异比对.py` 已按此更新，两份清单已重生成。
			- 新发现（待核对）：`班线包车!EO36/FN36/FO36`（荆门客运量 2020 累计/累计同比）程序生成时重算为 -2731.41 / -1.0008 / -1.0002，而母版与手工定稿均为 0.181777 / 2312.2199 / -0.586419 → 疑母版 2020 年块分母为 0，需核对公式与数据。
			- 汇总大表差异比对（09-28，工具已固化口径）：`docs/工具/汇总大表差异比对.py`（逐页按行/列标签序列对齐，可处理多列/多行/重复表头）。清单属过程产物只留本地（`docs/问题汇总/_清单_*.md/.csv`，已 gitignore 不入库）。
			- 已确认口径（不再重复确认/上报）：① 货运每市州 6 行 vs 手工 4 行（新增「规上+规下货运量」「规下货运量」各 17 行）属母版设计，行号偏移按"地区+指标"对齐后一致；② ` 货运` U 列（U2:U118）为人工草稿；③ 仅手工有且无表头的列 = 草稿；④ 浮点尾差、文本型数字忽略；⑤ 排名表「当月块」为母版设计；⑥ 市州短名/全名不影响。
			- 需处理（数值）：`班线包车!EO36/FN36/FO36`（荆门客运量 2020 累计/累计同比）——程序生成时重算为 -2731.41 / -1.0008 / -1.0002，母版与手工定稿均为 0.181777 / 2312.2199 / -0.586419（疑母版 2020 年块分母为 0），待核对；` 货运` 2022 年各市州「累计同比」10 条（业务已确认软件对，不改）。
			- 其余待办：手工侧 4 处脏数据（`班线包车!IL4/IL5` 断链、`IL50` 反引号、` 货运!EA93/EA111` 的 `#DIV/0!`）、286 格文本型数字、304 格草稿列；母版 11 个 `#REF!` + 356 个 `#DIV/0!`；`城市客运` 第 2 行第 3 个月起表头为日期序列号；缺 2026-09 母版；导出前基数体检（P0-3）。
			- 09-28 收尾：`班线包车` 3 格重算问题已修：`EO36`/`FN36`/`FO36` 在母版里改为静态值（0.181777001400256 / 2312.2199 / -0.586418964965219，与手工定稿一致），并把受影响的共享公式组孤儿子格（35 格）一并静态化（值零变化）。重新生成验证：生成件/母版/定稿三边一致，与上一版生成件仅 34 格为精度表示差异、无数值变化。
			- 当前"需处理"仅剩 16 条（均属手工侧/业务已确认，非程序问题）：` 货运` EA92~EA112 共 12 条（2022 各市州累计同比，2021 年基数口径不同，业务已确认软件对；含手工 `#DIV/0!` 2 条）、`班线包车` IL4/IL5（手工 `#REF!`）/IL50（手工反引号）3 条、`城市汇总!G20` 表头措辞 1 条。其余全部按口径忽略（草稿列/行号偏移/当月块/浮点尾差/文本型数字）。
			- 未清项（有意保留）：母版 11 个 `#REF!` + 356 个 `#DIV/0!` 历史错误值未清——手工定稿同类约 15 + 358，单清一边会凭空多出单边差异；要清需两边一起。
			- 确认差异清单（本地）：`docs/问题汇总/_已确认差异清单_2026-08_20260928.md`（不入库）。
			- 09-28 口径全部落地，差异清单"需处理"归零：
			- ① 按软件：手工定稿《货运》EB64~EB78 等 12 格 2022 累计同比 + 《班线包车》IL4/IL5/IL50 已按软件值同步（备份 `2026年8月客运量、货运量定稿_同步软件前_20260928.xlsx`）。
			- ② 按手工统一措辞：母版《城市汇总!G20》改为手工写法"2025年1-12月全省累计完成城市客运量情况"（备份 `_bak_202608母版_0928措辞前.xlsx`）。
			- ③ 历史错误值留白：母版 363 格（`_bak_202608母版_0928留白前.xlsx`）、手工定稿 379 + 尾列 6 格（`..._留白尾列前_20260928.xlsx`）→ 两边现均为 0 个 `#REF!`/`#DIV/0!`。
			- 结果：按当前母版重新生成 2026-08 后，与手工定稿的需处理差异 = 0，其余全部落在"已忽略（约定差异）"。清单：`docs/问题汇总/_清单_母版最新生成件_20260928.md/.csv`（本地，不入库）。
			- 注意：桌面那份 `生成_道路运输量汇总表_2026-08.xlsx` 是旧导出（含旧错误值/旧基数），与更新后的定稿比对会显示较多差异，以"母版重新生成件"为准。
			- 无表头草稿列清单（9 处，共 539 格）：`公交/出租/网约车!U`（各 72）、`城市客运!U`（36）、`班线包车!DU`（55，表头"1-3月累计"）、`中口径明细!U`（90）、`中口径客运量!AB`（180）、` 货运!V` 与 ` 货运!AX`（各 74，用户所指 U 列在手工那份右移一列）。母版/生成件已全部清空，手工定稿仍保留 → 对比时归入「已知设计(无表头草稿列)」。其余"无表头列"是合并表头的正常列（` 货运!C…Q` 月份值列、各年块尾部累计/累计同比列、排名页 R 列等），两边都有、非草稿。明细见 `docs/问题汇总/_已确认差异清单_2026-08_20260928.md`。
			- 待办：① 排名页结构（块顺序、标题措辞、市州名短名/全名、周转量排名多 7 行）；② 排名页结构（块顺序、标题措辞、市州名短名/全名、周转量排名多 7 行）；③ 缺 2026-09 母版、导出前基数体检（P0-3）。

			## 最新（2026-09-27）

			- 提交规范改为同事方式（用户 09-27 决定，已写入 AGENTS.md）：
			1. 《功能测试报告》《工作日结》改为本地写、不入库（`docs/功能测试报告/`、`docs/工作日结/` 已 gitignore，本次 109 个文件移出仓库、本地文件全部保留；其中《模块功能验证状态矩阵_2026-09-02》属团队共享信息，已移到 `docs/` 根目录继续入库）；
			2. 入库的是结论：关键结论/口径/风险/待办写进本文件（`HANDOFF.md`）或 `docs/交接文档_*.md`、`docs/问题汇总/`，与该次代码改动放在同一条提交；
			3. 提交粒度与 message：一条提交一个改动（代码+相关文档），前缀 `feat(模块):` / `fix(模块):` / `docs:` / `docs(交接):`；禁止入库临时脚本/调试产物/构建产物/密钥/大体积 sql。
			> 参考数据：同事 xyc 55 次提交中 37 次更新本文件、功能测试报告仅 4 次、日结 7 次；此前我方 144 次提交里含 102 份报告 + 106 份日结。
			- 打包去密（根因已修）：旧部署包的 jar 内置 `BOOT-INF/classes/application.yml` 带着真实密钥与库口令（外层 application.yml 干净、运行时以外部为准，但 jar 可解压明文可见；且 zip 压缩导致直接 grep 搜不到）。
			现已改为：进 jar 的配置只有占位符（`${TRAFFIC_DB_}`、`${DEEPSEEK_API_KEY:}`、`${TRAFFIC_JWT_SECRET:...}`）；本机真实值走 Windows 用户环境变量*（`TRAFFIC_DB_PASSWORD` / `DEEPSEEK_API_KEY`），`start-dev.ps1` 增加了从注册表补齐的兜底。
			- 新增脚本（已入库）：`pack-deploy.ps1`（一键打包：构建 → 解压 jar 去密自检，命中真实密钥/明文口令即中止 → 重建前端 → 组装部署包到 `E:\试验\traffic-audit-deploy-<yyyyMMdd>`）、`set-secrets.ps1`（轮换后交互式更新本机环境变量）、`deploy-templates/`（打包模板入库：外部 application.yml、启动脚本、nginx 示例、db 建表 sql、部署 README——原先只在未跟踪的旧包里，删包即丢）。
			- 清理旧部署件（用户确认后执行）：删除 `E:\试验\traffic-audit-deploy-20260913`（目录 + 69.9 MB 的 zip）、`deploy\traffic-audit-deploy-20260913`、`_deploytest`、空 `out`/`deploy`；旧 `target` jar 由 `mvn clean` 覆盖。全盘复查（仓库 + `E:\试验`）：已无任何含明文 key 的 jar / 压缩包 / 文本文件。
			- 干净新包已产出：`E:\试验\traffic-audit-deploy-20260927`（336 文件 / 96 MB，前端含最新「按市州汇总」；jar 内置配置全占位符）。
			- 运行状态（09-27 实测）：dev 后端 `8090`、前端 `8080` 在运行；本机数据库为 MySQL80 `localhost:3308/traffic_audit`（root/口令走环境变量）——注意 `docs/交接文档_2026-09-23.md` 写的 `3305` 是同事机器的配置，本机没有 3305，别再照抄。
			- 待办（接手优先）：
			1. 【需用户】轮换已泄露的 DeepSeek key（控制台新建 + 删旧 → 跑 `set-secrets.ps1`）；
			2. 【需用户】服务器换包：删旧包/zip → 拷 `traffic-audit-deploy-20260927` → 改 `backend\application.yml` 数据库三处（需要 AI 分析再填 `deepseek.api-key`）→ `start-backend.cmd`；
			3. P0 三项不变：P0-2 亿元投资项目按 Q7 按月追列、P0-3 导出前基数体检 +《数据缺失清单》页、P0-4 缺 2026-06/09 母版；
			3.1 汇总大表现状复核（2026-09-27 实测，母版 `docs/生成汇总大表/2026年8月道路运输量汇总表.xlsx` + 最近生成件）：
			- 累计列公式没覆盖到当期（实测 306 格）未落实，确切位置（母版 `docs/生成汇总大表/2026年8月道路运输量汇总表.xlsx`）：
			· `公交!U5:U76`、`出租!U5:U76`、`网约车!U5:U76` 各 72 格 = 216 格，公式 `=V5+X5+Z5+AB5+AD5+AF5`（只累加 2025 年 1~6 月；U 列表头为空，位置在"2025年1月"块左侧，对应 2026 块的 `S` 列"2026年累计"，语义即"2025 年累计"）；
			· `城市客运!U4:U39` 36 格（同模式，只 6 个月）；`班线包车!DU4:DU57` 54 格（`DU2` 表头直接写"1-3月累计"，只 3 个月——属版式未随月份扩展）。
			→ 业务口径为"可清空留空"；生成件与母版逐格相同（证实程序只补当期列、不碰历史列）。09-22 差异报告按另一分页口径统计为"304 格（含中口径明细 88 格）"，本次按公式模式定位到的是上述 306 格，两者为同一类问题、分页归类不同。
			- 2026-09-27 已处置：母版里的"人工核算草稿累计列"整体清空（用户确认"这一列都可以留空，是人工核算时弄的草稿"）。清空范围共 577 格：`公交/出租/网约车!U5:U76`、`城市客运!U4:U39`、`班线包车!DU4:DU57`（含表头 `DU2`"1-3月累计"）、`中口径明细!U99:U188`、`中口径客运量!AB5:AB188`。
			· 依据：这些列在整本工作簿里没有任何公式引用（全簿扫描 0 命中），且程序不写它们（生成件与母版逐格相同）→ 只改母版即可，无需改代码。
			· 做法：直接改 xlsx 内部 XML（只去对应单元格的 `<f>/<v>`、保留样式），避免 openpyxl 保存导致全簿公式缓存值丢失（该坑已实测复现：用 openpyxl 存一次后 `公交!S5` 由 98460.97 变 None，会破坏"中口径排名用母版 2025 静态列"）。
			· 验证：重新生成 2026-08（母版变更使缓存自动失效，`staleCache=true`）→ 新旧生成件逐格比对：仅这 577 格变为空，19 页签与尺寸不变，其它一律不动；依赖母版缓存值的口径（中口径排名 M3、道路运输周转量 G4、货运量排名 B4、城市汇总 B3、公交 S5/Q5、中口径明细 C99、班线包车 Q4）全部一致。
			· 备份（本地保留、不入库）：`docs/生成汇总大表/_bak_202608母版清空草稿累计列前_20260927.xlsx`；新生成件已存 `D:\桌面\生成数据\生成_道路运输量汇总表_2026-08 (4).xlsx`。
			· 表头措辞修复（按人工定稿为准）：`轨道、轮渡!R2`、`R11` 由母版自带的"8月与去年同比"改为"同比"（与该页 `T2/T11`"累计同比"体例一致、与手工定稿一致；程序不写这两格，故只改母版）。
			验证：重新生成 2026-08 → 新旧生成件逐格比对仅这 2 格文字变化，19 页签与尺寸不变、其它一律不动。
			· 判定为"程序正确、不改"的两处：① `道路运输周转量!A23` 程序"2026年8月全省完成交通周转量情况"（该块是当月值：全省 2,301,720 vs 累计块 17,749,657 万吨公里）→ 手工定稿多写了"累计"；② ` 货运!EA92:EA112` 2022 年累计同比 10 条（业务已确认软件口径正确）。
			· 文本型数字统一为数值（用户口径"按程序对的改"）：母版 157 格文本型数字 → 数值（`公交` 153 = AF 68 + M 68 + G 17；`轨道、轮渡` 4 = M 2 + E 2），仍用 XML 精准改类型（缓存值全部保留）。重新生成 2026-08 → 与上一版比对：仅 68 格类型变化（str→数值、数值相同），无任何值/尺寸变化（其余 89 格程序本就会写数值）。注：比对里另有 286 条"文本型数字"差异在手工定稿侧（手工存文本），需手工侧统一或忽略。
			· 排名页"两个块顺序对调"（实为顺序问题，不是多了一张表）：程序以模板 `docs/货运/生成_货运量排名.xlsx`（模板本身=累计块在行1、当月块在行23）填充 → `货运量排名` 程序=行1累计/行22当月，手工=行1当月（"2026年8月各市州货运量排名"）/行22累计；`货运周转量排名` 程序 44×18（累计在前）vs 手工 51×18（当月在前、且多 7 行待细看）。用户口径：手工为准 → 需改模板（两块对调）+ 相应代码（块定位/标题写法 `ReportExportService:961-966/1315/1575-1583`）+ 市州名由 `RegionUtil.shortName()` 改全名；估 0.5~1 天含回归，待开工。
			· 手工多出的"辅助列"清单：` 货运` 多 1 列（无表头，位于"同比"之后、2025 年 1 月之前 → 实为 `U` 列"2025 年 1-8 月累计"辅助列，74 格，从 V 列起手工整体右移）；`城市客运` 多 `AJ`="2025年1-7月累计"（母版 09-20 已删、程序已不输出）；`班线包车` 多 `DU`="1-3月累计"（即本次清空的草稿列）；`道路运输周转量` 末尾多 2 列（Z/AA，表头与内容均为空）。
			· 取整尾差 194 条：用户明确"不用管"。

			· 仍待业务定的版式/措辞项：`货运量排名`/`货运周转量排名` 的标题、表头（程序"累计完成(万吨)" vs 手工"规上货运量(万吨）"）与市州名（程序按设计用短名"武汉/恩施/林区"、手工用"武汉市"等全名）——需业务确认以哪版为准。

			· ⚠ 待同事确认：手工定稿侧也把这些草稿列留空，否则比对会从"程序有值/手工有值"变成"程序空/手工有值"（同类差异、方向相反）。

			· 清空的 7 列对照表（供同事复核；引用数为清空前的全簿扫描）：

			\| 页签 \| 列 / 范围 \| 清空格数 \| 原表头 \| 公式语义 \| 清空前缓存值（首行样例） \| 同页引用 \| 跨页引用 \|
			\| --- \| --- \| ---: \| --- \| --- \| --- \| ---: \| ---: \|
			\| 公交 \| `U`（U5:U76） \| 72 \| （无表头） \| `=V5+X5+Z5+AB5+AD5+AF5` → 2025 年 1~6 月累计 \| 88908.91 \| 0 \| 0 \|
			\| 出租 \| `U`（U5:U76） \| 72 \| （无表头） \| `=V5+X5+Z5+AB5+AD5+AF5` → 2025 年 1~6 月累计 \| 39797.94 \| 0 \| 0 \|
			\| 网约车 \| `U`（U5:U76） \| 72 \| （无表头） \| `=V5+X5+Z5+AB5+AD5+AF5` → 2025 年 1~6 月累计 \| 16384.07 \| 0 \| 0 \|
			\| 城市客运 \| `U`（U4:U39） \| 36 \| （无表头） \| `=V4+X4+Z4+AB4+AD4+AF4` → 2025 年 1~6 月累计 \| 206639.67 \| 0 \| 0 \|
			\| 班线包车 \| `DU`（DU4:DU57） \| 54 \| 1-3月累计 \| `=DO4+DQ4+DS4` → 1~3 月累计 \| 5566.8922 \| 0 \| 0 \|
			\| 中口径明细 \| `U`（U99:U188） \| 90 \| （无表头） \| `=V99+X99+Z99+AB99+AD99+AF99+AH99` → 2025 年 1~7 月累计 \| 1102278.385724 \| 0 \| 0 \|
			\| 中口径客运量 \| `AB`（AB5:AB188） \| 184 \| （无表头） \| `=AC5+AE5` → 2024 年 1~2 月累计 \| 6088.1871 \| 0 \| 0 \|

			· ⚠ 同名列别清错（反例对照）：`中口径明细!AB3 = "2025年4月"` 是正常月份列，被 700+ 处同页 + 34 处跨页公式引用（例如 `中口径明细!J5 = I5/AB5-1` 2026 年 4 月同比、`T5 = S5/SUM(V5,X5,Z5,AB5,…)-1` 累计同比、`AT5 = X5+V5+Z5+AB5+…` 2025 累计、`中口径客运量!I11 = 中口径明细!AB11`），本次未动、也不能清。判据：该列有表头、被引用数远大于 0、公式语义是"被别的格引用"而不是引用其它月份列。

			- 生成件里错误值 356 个 `#DIV/0!` + 13 个 `#REF!`：班线包车 228+8、中口径明细 64+2、货运 38+3、中口径客运量 26；业务口径未定（是否清成空白）。
			- 城市客运页表头仍是日期序列号（确证未修）：母版与生成件第 2 行第 3 个月起均为序列号（G2=46082、I2=46113…），1、2 月是文字；`fixCityMonthHeaderText()` 未覆盖该页 → "按表头文字匹配列"方案在该页失效。（此前文档标"待核实"，现已确证。）
			- 缺 2026-09 母版（目录仅 7 月/8 月/版式原型 + 2 个 `_bak_*`）→ 9 月出表会 `ready=false`，需拍板方案 A（程序扩列）/ B（Excel 小工具）。
			4. 汇总大表 304 格「2025 累计列少加 7、8 月」清空（业务已确认口径，待执行）；
			5. 本机历史临时目录待清（`outputs/` 41MB、`_shots/`、`_test_check`、`_test_passenger`、`.tmp_`、`_tmp_codexhome`）；`_给同事_2026-09-21/`（52MB 全库备份）属交付件，未动。

			## 最新（2026-09-23）

			@@ -17,9 +17,97 @@
			- 普通国省道环比基期（2026-10-02 追加）：普通国省道 C 列为可选环比基期，仅 2026 年启用；填写后只影响普通国省道车流量自身环比 `当日 / 基期 - 1`，未填写按前一日。`holiday_vehicle_flow.comparison_base` 已入库，导入导出与历史变更确认均已接入；折算人员流动量、总人员流动量和 Word 快报继续按 Excel 原公式，不受基期影响。2024/2025 不使用。
			- 快报首日口径（2026-10-02 追加）：假期第1天没有前一日环比基数，正文不输出“环比增长/下降/持平”短语，表格当日环比列为“—”；第2天起仍按实际前一日输出环比。已用 2025-10-01/02 快报回归验证。
			- 快报百分比精度（2026-10-02 追加）：Word 快报中同比/环比百分比统一保留1位小数（如6.79%显示6.8%、11.46%显示11.5%）；人次、车流等业务数值仍保留2位小数。
			- 验证结果：后端编译、前端构建、权限/CRUD/负向导入、历史变更两阶段导入、Excel 导出、Word 快报、前端 admin/非 admin 烟测均通过；菜单顺序、客运系数 2.4 展示（系统配置页 + 节假日统计页）、`decimal(30,15)` 列型、历史变更两阶段导入回归均已实测；报告见 `docs/功能测试报告/功能测试报告_重要节假日专项统计_2026-10-02.md`，日结见 `docs/工作日结/工作日结_2026-10-02.md`。
			- 验证结果：后端编译、前端构建、权限/CRUD/负向导入、历史变更两阶段导入、Excel 导出、Word 快报、前端 admin/非 admin 烟测均通过；菜单顺序、客运系数 2.4 展示（系统配置页 + 节假日统计页）、`decimal(30,15)` 列型、历史变更两阶段导入回归均已实测；功能测试报告与工作日结按 2026-09-27 提交规范仅本地留存（不入库）：`docs/功能测试报告/功能测试报告_重要节假日专项统计_2026-10-02.md`、`docs/工作日结/工作日结_2026-10-02.md`。
			- 运行状态：后端 8090、前端 8080 已启动；数据库 `127.0.0.1:3305/traffic_audit`。测试产生的 2026 临时数据和导入批次已清理。
			- Git：用户已于 2026-10-02 明确验收通过；本次按要求合并远端 `origin/main` 后提交并推送，不覆盖远端同事提交。
			- 部署模板同步：节假日 4 张表已同步到 `deploy-templates/db/init.sql`；`sql_holiday.sql` 及两个旧库迁移脚本随部署包发布，避免新包缺表。

			## 最新（2026-09-28）

			- 用户用 WPS 编辑母版：改《班线包车》边框、《道路运输周转量》字号，并删除《中口径明细》`AW` 列（手工定稿同删）。已验证生成端正常：中口径明细 2024 及更早块整体左移（跨页/同页公式自动改引用，`#REF!` 2→0）、中口径排名块 J..R → A..I 均正确带入产物。
			- ⚠️ WPS 保存的连带损坏（待回补）：《班线包车》2019/2020 块约 590 格内容丢失（`FN/FO/FM`、`FP:FT`、`GE` 变空；`EO/EQ/ES/EU/EW/EY/DT/DW...EM` 共 144 格变 `#DIV/0!`）。生成件已带出（该页 `#DIV/0!` 228→372）。待用户确认后按备份/定稿回补（只补值与公式，保留其边框与字号）。
			- 口径落地「缺数留空」：母版《货运》行 90/93（仙桃规上两行）、108/111（林区）在 2021、2022 年块的 78 个 `0` 值已清空（与手工定稿按表头对齐逐格核对：母版=0 且定稿=空 78 格、冲突 0 格）；代码 `FreightCalc.buildMetrics` 当月分支改为「该月无规上记录 → 留空」，不再写 0（累计分支不变）。
			- 纠正一条错判：此前「程序少一列 11 月环比」不成立——生成件与手工定稿的环比期间集合完全一致（12月…1月共 12 列）；差异根因是手工定稿《货运》在 2025 年块多一列无表头辅助列（`U`，74 格），自该列起手工整体右移 1 列。比对必须按表头期间对齐，不能按列位置比。
			- 验证：生成两次（约 15 秒/次），第二次相对第一次仅 78 格 0→空，错误值数量不变；`公交!S5=98460.97` 等缓存值抽查保留。
			- 运行状态：后端已按 `start-dev.ps1` 重启（新 PID，8090/8080 在跑）；本机库仍为 `localhost:3308/traffic_audit`。
			- ✅ 班线包车回补完成（09-28 下午）：用户确认后按 09-27 母版备份（`_bak_202608母版文本数字转数值前_20260927.xlsx`）XML 精准回补《班线包车》2019/2020 块 —— 该页与 09-27 母版逐格一致（0 差异），错误值回到 `#REF!` 8 / `#DIV/0!` 228；母版其它页未受影响。验收生成：与 09-27 生成件 (6) 比对错误值逐页一致，差异仅剩既定改动（` 货运` 78 格清 0、中口径明细 4915 格删列位移、中口径排名 672 格块位移、班线包车 82 格浮点尾差/0-空）。
			- 差异清单口径更新（09-28，用户确认）：① ` 货运` 新增的「规上+规下货运量」「规下货运量」各 17 行（母版设计，共 34 行）不计差异；② ` 货运!U5:U112` 无表头草稿列不计；③ 排名表「当月块」为母版设计不计；④ 市州短名/全名不影响（工具归一化）；⑤ 小差异（取整尾差/文本型数字）只计数，只列差异大的并附原因。工具 `docs/工具/汇总大表差异比对.py` 已按此更新，两份清单已重生成。
			- 新发现（待核对）：`班线包车!EO36/FN36/FO36`（荆门客运量 2020 累计/累计同比）程序生成时重算为 -2731.41 / -1.0008 / -1.0002，而母版与手工定稿均为 0.181777 / 2312.2199 / -0.586419 → 疑母版 2020 年块分母为 0，需核对公式与数据。
			- 汇总大表差异比对（09-28，工具已固化口径）：`docs/工具/汇总大表差异比对.py`（逐页按行/列标签序列对齐，可处理多列/多行/重复表头）。清单属过程产物只留本地（`docs/问题汇总/_清单_*.md/.csv`，已 gitignore 不入库）。
			- 已确认口径（不再重复确认/上报）：① 货运每市州 6 行 vs 手工 4 行（新增「规上+规下货运量」「规下货运量」各 17 行）属母版设计，行号偏移按"地区+指标"对齐后一致；② ` 货运` U 列（U2:U118）为人工草稿；③ 仅手工有且无表头的列 = 草稿；④ 浮点尾差、文本型数字忽略；⑤ 排名表「当月块」为母版设计；⑥ 市州短名/全名不影响。
			- 需处理（数值）：`班线包车!EO36/FN36/FO36`（荆门客运量 2020 累计/累计同比）——程序生成时重算为 -2731.41 / -1.0008 / -1.0002，母版与手工定稿均为 0.181777 / 2312.2199 / -0.586419（疑母版 2020 年块分母为 0），待核对；` 货运` 2022 年各市州「累计同比」10 条（业务已确认软件对，不改）。
			- 其余待办：手工侧 4 处脏数据（`班线包车!IL4/IL5` 断链、`IL50` 反引号、` 货运!EA93/EA111` 的 `#DIV/0!`）、286 格文本型数字、304 格草稿列；母版 11 个 `#REF!` + 356 个 `#DIV/0!`；`城市客运` 第 2 行第 3 个月起表头为日期序列号；缺 2026-09 母版；导出前基数体检（P0-3）。
			- 09-28 收尾：`班线包车` 3 格重算问题已修：`EO36`/`FN36`/`FO36` 在母版里改为静态值（0.181777001400256 / 2312.2199 / -0.586418964965219，与手工定稿一致），并把受影响的共享公式组孤儿子格（35 格）一并静态化（值零变化）。重新生成验证：生成件/母版/定稿三边一致，与上一版生成件仅 34 格为精度表示差异、无数值变化。
			- 当前"需处理"仅剩 16 条（均属手工侧/业务已确认，非程序问题）：` 货运` EA92~EA112 共 12 条（2022 各市州累计同比，2021 年基数口径不同，业务已确认软件对；含手工 `#DIV/0!` 2 条）、`班线包车` IL4/IL5（手工 `#REF!`）/IL50（手工反引号）3 条、`城市汇总!G20` 表头措辞 1 条。其余全部按口径忽略（草稿列/行号偏移/当月块/浮点尾差/文本型数字）。
			- 未清项（有意保留）：母版 11 个 `#REF!` + 356 个 `#DIV/0!` 历史错误值未清——手工定稿同类约 15 + 358，单清一边会凭空多出单边差异；要清需两边一起。
			- 确认差异清单（本地）：`docs/问题汇总/_已确认差异清单_2026-08_20260928.md`（不入库）。
			- 09-28 口径全部落地，差异清单"需处理"归零：
			- ① 按软件：手工定稿《货运》EB64~EB78 等 12 格 2022 累计同比 + 《班线包车》IL4/IL5/IL50 已按软件值同步（备份 `2026年8月客运量、货运量定稿_同步软件前_20260928.xlsx`）。
			- ② 按手工统一措辞：母版《城市汇总!G20》改为手工写法"2025年1-12月全省累计完成城市客运量情况"（备份 `_bak_202608母版_0928措辞前.xlsx`）。
			- ③ 历史错误值留白：母版 363 格（`_bak_202608母版_0928留白前.xlsx`）、手工定稿 379 + 尾列 6 格（`..._留白尾列前_20260928.xlsx`）→ 两边现均为 0 个 `#REF!`/`#DIV/0!`。
			- 结果：按当前母版重新生成 2026-08 后，与手工定稿的需处理差异 = 0，其余全部落在"已忽略（约定差异）"。清单：`docs/问题汇总/_清单_母版最新生成件_20260928.md/.csv`（本地，不入库）。
			- 注意：桌面那份 `生成_道路运输量汇总表_2026-08.xlsx` 是旧导出（含旧错误值/旧基数），与更新后的定稿比对会显示较多差异，以"母版重新生成件"为准。
			- 无表头草稿列清单（9 处，共 539 格）：`公交/出租/网约车!U`（各 72）、`城市客运!U`（36）、`班线包车!DU`（55，表头"1-3月累计"）、`中口径明细!U`（90）、`中口径客运量!AB`（180）、` 货运!V` 与 ` 货运!AX`（各 74，用户所指 U 列在手工那份右移一列）。母版/生成件已全部清空，手工定稿仍保留 → 对比时归入「已知设计(无表头草稿列)」。其余"无表头列"是合并表头的正常列（` 货运!C…Q` 月份值列、各年块尾部累计/累计同比列、排名页 R 列等），两边都有、非草稿。明细见 `docs/问题汇总/_已确认差异清单_2026-08_20260928.md`。
			- 待办：① 排名页结构（块顺序、标题措辞、市州名短名/全名、周转量排名多 7 行）；② 排名页结构（块顺序、标题措辞、市州名短名/全名、周转量排名多 7 行）；③ 缺 2026-09 母版、导出前基数体检（P0-3）。

			## 最新（2026-09-27）

			- 提交规范改为同事方式（用户 09-27 决定，已写入 AGENTS.md）：
			1. 《功能测试报告》《工作日结》改为本地写、不入库（`docs/功能测试报告/`、`docs/工作日结/` 已 gitignore，本次 109 个文件移出仓库、本地文件全部保留；其中《模块功能验证状态矩阵_2026-09-02》属团队共享信息，已移到 `docs/` 根目录继续入库）；
			2. 入库的是结论：关键结论/口径/风险/待办写进本文件（`HANDOFF.md`）或 `docs/交接文档_*.md`、`docs/问题汇总/`，与该次代码改动放在同一条提交；
			3. 提交粒度与 message：一条提交一个改动（代码+相关文档），前缀 `feat(模块):` / `fix(模块):` / `docs:` / `docs(交接):`；禁止入库临时脚本/调试产物/构建产物/密钥/大体积 sql。
			> 参考数据：同事 xyc 55 次提交中 37 次更新本文件、功能测试报告仅 4 次、日结 7 次；此前我方 144 次提交里含 102 份报告 + 106 份日结。
			- 打包去密（根因已修）：旧部署包的 jar 内置 `BOOT-INF/classes/application.yml` 带着真实密钥与库口令（外层 application.yml 干净、运行时以外部为准，但 jar 可解压明文可见；且 zip 压缩导致直接 grep 搜不到）。
			现已改为：进 jar 的配置只有占位符（`${TRAFFIC_DB_}`、`${DEEPSEEK_API_KEY:}`、`${TRAFFIC_JWT_SECRET:...}`）；本机真实值走 Windows 用户环境变量*（`TRAFFIC_DB_PASSWORD` / `DEEPSEEK_API_KEY`），`start-dev.ps1` 增加了从注册表补齐的兜底。
			- 新增脚本（已入库）：`pack-deploy.ps1`（一键打包：构建 → 解压 jar 去密自检，命中真实密钥/明文口令即中止 → 重建前端 → 组装部署包到 `E:\试验\traffic-audit-deploy-<yyyyMMdd>`）、`set-secrets.ps1`（轮换后交互式更新本机环境变量）、`deploy-templates/`（打包模板入库：外部 application.yml、启动脚本、nginx 示例、db 建表 sql、部署 README——原先只在未跟踪的旧包里，删包即丢）。
			- 清理旧部署件（用户确认后执行）：删除 `E:\试验\traffic-audit-deploy-20260913`（目录 + 69.9 MB 的 zip）、`deploy\traffic-audit-deploy-20260913`、`_deploytest`、空 `out`/`deploy`；旧 `target` jar 由 `mvn clean` 覆盖。全盘复查（仓库 + `E:\试验`）：已无任何含明文 key 的 jar / 压缩包 / 文本文件。
			- 干净新包已产出：`E:\试验\traffic-audit-deploy-20260927`（336 文件 / 96 MB，前端含最新「按市州汇总」；jar 内置配置全占位符）。
			- 运行状态（09-27 实测）：dev 后端 `8090`、前端 `8080` 在运行；本机数据库为 MySQL80 `localhost:3308/traffic_audit`（root/口令走环境变量）——注意 `docs/交接文档_2026-09-23.md` 写的 `3305` 是同事机器的配置，本机没有 3305，别再照抄。
			- 待办（接手优先）：
			1. 【需用户】轮换已泄露的 DeepSeek key（控制台新建 + 删旧 → 跑 `set-secrets.ps1`）；
			2. 【需用户】服务器换包：删旧包/zip → 拷 `traffic-audit-deploy-20260927` → 改 `backend\application.yml` 数据库三处（需要 AI 分析再填 `deepseek.api-key`）→ `start-backend.cmd`；
			3. P0 三项不变：P0-2 亿元投资项目按 Q7 按月追列、P0-3 导出前基数体检 +《数据缺失清单》页、P0-4 缺 2026-06/09 母版；
			3.1 汇总大表现状复核（2026-09-27 实测，母版 `docs/生成汇总大表/2026年8月道路运输量汇总表.xlsx` + 最近生成件）：
			- 累计列公式没覆盖到当期（实测 306 格）未落实，确切位置（母版 `docs/生成汇总大表/2026年8月道路运输量汇总表.xlsx`）：
			· `公交!U5:U76`、`出租!U5:U76`、`网约车!U5:U76` 各 72 格 = 216 格，公式 `=V5+X5+Z5+AB5+AD5+AF5`（只累加 2025 年 1~6 月；U 列表头为空，位置在"2025年1月"块左侧，对应 2026 块的 `S` 列"2026年累计"，语义即"2025 年累计"）；
			· `城市客运!U4:U39` 36 格（同模式，只 6 个月）；`班线包车!DU4:DU57` 54 格（`DU2` 表头直接写"1-3月累计"，只 3 个月——属版式未随月份扩展）。
			→ 业务口径为"可清空留空"；生成件与母版逐格相同（证实程序只补当期列、不碰历史列）。09-22 差异报告按另一分页口径统计为"304 格（含中口径明细 88 格）"，本次按公式模式定位到的是上述 306 格，两者为同一类问题、分页归类不同。
			- 2026-09-27 已处置：母版里的"人工核算草稿累计列"整体清空（用户确认"这一列都可以留空，是人工核算时弄的草稿"）。清空范围共 577 格：`公交/出租/网约车!U5:U76`、`城市客运!U4:U39`、`班线包车!DU4:DU57`（含表头 `DU2`"1-3月累计"）、`中口径明细!U99:U188`、`中口径客运量!AB5:AB188`。
			· 依据：这些列在整本工作簿里没有任何公式引用（全簿扫描 0 命中），且程序不写它们（生成件与母版逐格相同）→ 只改母版即可，无需改代码。
			· 做法：直接改 xlsx 内部 XML（只去对应单元格的 `<f>/<v>`、保留样式），避免 openpyxl 保存导致全簿公式缓存值丢失（该坑已实测复现：用 openpyxl 存一次后 `公交!S5` 由 98460.97 变 None，会破坏"中口径排名用母版 2025 静态列"）。
			· 验证：重新生成 2026-08（母版变更使缓存自动失效，`staleCache=true`）→ 新旧生成件逐格比对：仅这 577 格变为空，19 页签与尺寸不变，其它一律不动；依赖母版缓存值的口径（中口径排名 M3、道路运输周转量 G4、货运量排名 B4、城市汇总 B3、公交 S5/Q5、中口径明细 C99、班线包车 Q4）全部一致。
			· 备份（本地保留、不入库）：`docs/生成汇总大表/_bak_202608母版清空草稿累计列前_20260927.xlsx`；新生成件已存 `D:\桌面\生成数据\生成_道路运输量汇总表_2026-08 (4).xlsx`。
			· 表头措辞修复（按人工定稿为准）：`轨道、轮渡!R2`、`R11` 由母版自带的"8月与去年同比"改为"同比"（与该页 `T2/T11`"累计同比"体例一致、与手工定稿一致；程序不写这两格，故只改母版）。
			验证：重新生成 2026-08 → 新旧生成件逐格比对仅这 2 格文字变化，19 页签与尺寸不变、其它一律不动。
			· 判定为"程序正确、不改"的两处：① `道路运输周转量!A23` 程序"2026年8月全省完成交通周转量情况"（该块是当月值：全省 2,301,720 vs 累计块 17,749,657 万吨公里）→ 手工定稿多写了"累计"；② ` 货运!EA92:EA112` 2022 年累计同比 10 条（业务已确认软件口径正确）。
			· 文本型数字统一为数值（用户口径"按程序对的改"）：母版 157 格文本型数字 → 数值（`公交` 153 = AF 68 + M 68 + G 17；`轨道、轮渡` 4 = M 2 + E 2），仍用 XML 精准改类型（缓存值全部保留）。重新生成 2026-08 → 与上一版比对：仅 68 格类型变化（str→数值、数值相同），无任何值/尺寸变化（其余 89 格程序本就会写数值）。注：比对里另有 286 条"文本型数字"差异在手工定稿侧（手工存文本），需手工侧统一或忽略。
			· 排名页"两个块顺序对调"（实为顺序问题，不是多了一张表）：程序以模板 `docs/货运/生成_货运量排名.xlsx`（模板本身=累计块在行1、当月块在行23）填充 → `货运量排名` 程序=行1累计/行22当月，手工=行1当月（"2026年8月各市州货运量排名"）/行22累计；`货运周转量排名` 程序 44×18（累计在前）vs 手工 51×18（当月在前、且多 7 行待细看）。用户口径：手工为准 → 需改模板（两块对调）+ 相应代码（块定位/标题写法 `ReportExportService:961-966/1315/1575-1583`）+ 市州名由 `RegionUtil.shortName()` 改全名；估 0.5~1 天含回归，待开工。
			· 手工多出的"辅助列"清单：` 货运` 多 1 列（无表头，位于"同比"之后、2025 年 1 月之前 → 实为 `U` 列"2025 年 1-8 月累计"辅助列，74 格，从 V 列起手工整体右移）；`城市客运` 多 `AJ`="2025年1-7月累计"（母版 09-20 已删、程序已不输出）；`班线包车` 多 `DU`="1-3月累计"（即本次清空的草稿列）；`道路运输周转量` 末尾多 2 列（Z/AA，表头与内容均为空）。
			· 取整尾差 194 条：用户明确"不用管"。

			· 仍待业务定的版式/措辞项：`货运量排名`/`货运周转量排名` 的标题、表头（程序"累计完成(万吨)" vs 手工"规上货运量(万吨）"）与市州名（程序按设计用短名"武汉/恩施/林区"、手工用"武汉市"等全名）——需业务确认以哪版为准。

			· ⚠ 待同事确认：手工定稿侧也把这些草稿列留空，否则比对会从"程序有值/手工有值"变成"程序空/手工有值"（同类差异、方向相反）。

			· 清空的 7 列对照表（供同事复核；引用数为清空前的全簿扫描）：

			\| 页签 \| 列 / 范围 \| 清空格数 \| 原表头 \| 公式语义 \| 清空前缓存值（首行样例） \| 同页引用 \| 跨页引用 \|
			\| --- \| --- \| ---: \| --- \| --- \| --- \| ---: \| ---: \|
			\| 公交 \| `U`（U5:U76） \| 72 \| （无表头） \| `=V5+X5+Z5+AB5+AD5+AF5` → 2025 年 1~6 月累计 \| 88908.91 \| 0 \| 0 \|
			\| 出租 \| `U`（U5:U76） \| 72 \| （无表头） \| `=V5+X5+Z5+AB5+AD5+AF5` → 2025 年 1~6 月累计 \| 39797.94 \| 0 \| 0 \|
			\| 网约车 \| `U`（U5:U76） \| 72 \| （无表头） \| `=V5+X5+Z5+AB5+AD5+AF5` → 2025 年 1~6 月累计 \| 16384.07 \| 0 \| 0 \|
			\| 城市客运 \| `U`（U4:U39） \| 36 \| （无表头） \| `=V4+X4+Z4+AB4+AD4+AF4` → 2025 年 1~6 月累计 \| 206639.67 \| 0 \| 0 \|
			\| 班线包车 \| `DU`（DU4:DU57） \| 54 \| 1-3月累计 \| `=DO4+DQ4+DS4` → 1~3 月累计 \| 5566.8922 \| 0 \| 0 \|
			\| 中口径明细 \| `U`（U99:U188） \| 90 \| （无表头） \| `=V99+X99+Z99+AB99+AD99+AF99+AH99` → 2025 年 1~7 月累计 \| 1102278.385724 \| 0 \| 0 \|
			\| 中口径客运量 \| `AB`（AB5:AB188） \| 184 \| （无表头） \| `=AC5+AE5` → 2024 年 1~2 月累计 \| 6088.1871 \| 0 \| 0 \|

			· ⚠ 同名列别清错（反例对照）：`中口径明细!AB3 = "2025年4月"` 是正常月份列，被 700+ 处同页 + 34 处跨页公式引用（例如 `中口径明细!J5 = I5/AB5-1` 2026 年 4 月同比、`T5 = S5/SUM(V5,X5,Z5,AB5,…)-1` 累计同比、`AT5 = X5+V5+Z5+AB5+…` 2025 累计、`中口径客运量!I11 = 中口径明细!AB11`），本次未动、也不能清。判据：该列有表头、被引用数远大于 0、公式语义是"被别的格引用"而不是引用其它月份列。

			- 生成件里错误值 356 个 `#DIV/0!` + 13 个 `#REF!`：班线包车 228+8、中口径明细 64+2、货运 38+3、中口径客运量 26；业务口径未定（是否清成空白）。
			- 城市客运页表头仍是日期序列号（确证未修）：母版与生成件第 2 行第 3 个月起均为序列号（G2=46082、I2=46113…），1、2 月是文字；`fixCityMonthHeaderText()` 未覆盖该页 → "按表头文字匹配列"方案在该页失效。（此前文档标"待核实"，现已确证。）
			- 缺 2026-09 母版（目录仅 7 月/8 月/版式原型 + 2 个 `_bak_*`）→ 9 月出表会 `ready=false`，需拍板方案 A（程序扩列）/ B（Excel 小工具）。
			4. 汇总大表 304 格「2025 累计列少加 7、8 月」清空（业务已确认口径，待执行）；
			5. 本机历史临时目录待清（`outputs/` 41MB、`_shots/`、`_test_check`、`_test_passenger`、`.tmp_`、`_tmp_codexhome`）；`_给同事_2026-09-21/`（52MB 全库备份）属交付件，未动。

			## 最新（2026-09-23）