trafficAudit.git

			@@ -4,6 +4,41 @@
			> 每天结束时：把当天进展、踩过的坑、新需求、未完成事项更新到本文件，然后可以放心开新对话。
			> 协作约定（2026-08-31）：说「提交」= 本地 commit + 推送到远端 git（origin main，Gitblit），不再只做本地 commit。

			## 最新（2026-10-06）

			### 10-06：方案 D 已实现（往年国省道调整表 + 环比基期只作用于前一日分母）

			- 最终口径：`HolidayStatService.loadVehicleByDate` 先用 `holiday_vehicle_adjustment` 覆盖对应历史年份的“当日值”，供走势图、同比、累计和快报使用；随后构造“前一日环比分母”，若前一日普通国省道 C 列有值，则用 C 替换该日前一日国省道值，并据此重算非营业性人员流动量、公路人员流动量和总计。所有环比行只继承这份分母。
			- 关键边界：C 只影响“下一日的环比分母”，不影响 C 所在日的当日值、累计或走势图；调整表只维护历史年份（`year < 当前年份`），2026 年调整仍由导入 Excel 的 D 列进入当日值。
			- 本轮实现：新增 `holiday_vehicle_adjustment` 表及 mapper/service/controller；前端在专项统计-节假日页的“节假日数据”和“观测站分日调查数据”之间新增“往年国省道数据调整”卡片（后续按用户提议保持该位置），支持年份筛选、新增、编辑、删除和原因留痕；部署脚本与 migration 清单已同步。
			- 10-04 导入预检（只读，不写库）：用 `C:\Users\jcxiong\Downloads\2026年十一数据 (2).xlsx` 以 `allowHistoricalOverwrite=false` 调导入接口，返回确认项：
			- `第4日 2026-10-04 普通国省道：原值 323.6551，导入值 322.7695`
			- `第3日 2026-10-03 普通国省道环比基期：原值空，导入值 320.2418`
			因此 C5 由空变有值不会硬拒绝导入，只会要求历史变更确认；用户确认后即可随调整后的 Excel 重导写入。
			- 当前库状态：本地 `traffic_audit.holiday_vehicle_adjustment` 已执行 DDL（0 行）；2026-10-04 业务值仍为旧值 `323.6551`，等待用户自行重导调整后的 Excel。助手未执行任何业务数据导入、覆盖或重导。
			- 验证：后端 `mvn -o test` 9 个测试全绿（含 C5 只改 10-04 环比分母、历史调整进入 2025 当日值）、前端 `npm run build` 通过；页面实测“往年国省道数据调整”卡片与新增弹窗正常。
			- 已知取整边界（需沿用现有口径或另作决策）：快报百分比目前按既定规则先复现源 Excel 单元格格式，再取 1 位小数。10-04 总计环比原始值约 `4.5481%`，源格显示 `4.55%`，再取 1 位得到 `4.6%`；若直接从原始值一次取 1 位则是 `4.5%`。当前代码保留“先 Excel 显示、再快报 1 位”的既有口径；若领导要求改为一次取整，需要单独改快报百分比路径。

			> 说明：本文件早前“环比基期只作备用、不参与计算”的段落已作废。该版本针对的是旧实现误把 C 放到 C 所在日本身计算的问题；自方案 D 起，C 的正确语义是前一日环比分母的调整值。

			### 10-06（已作废，见上方方案 D）：普通国省道「环比基期」改为人工备用值（不再参与计算）

			- 背景：10-04 鄂州樊家庄站中小客流量断崖下跌（35419 -> 8856），领导要求剔除。手工稿快报的做法是：先用剔站后的数值算出 10-04 环比，把 10-03 国省道值挪到「环比基期」C 列备用，再把 10-03 恢复原值以免影响累计。用户明确口径：「环比基期」只用于数据备用，不参与任何计算。
			- 旧行为（错）：`HolidayStatService.nationalProvincialRingRatio` 在 2026 年只要 `comparison_base` 有值就按「当日 / 环比基期 - 1」算国省道环比；导出时 E 列写 `=(D{行}-C{行})/C{行}`。按手工稿的 C 列摆法（基期放在被比日那行），这样算还会错位（10-03 环比被算成 +1.11%）。
			- 新行为（本次已改）：国省道环比固定「当日 / 前一日 - 1」，2024/2025/2026 一致；`comparison_base` 只在导入/导出/页面展示时原样保存与回写，不参与环比、折算、累计。导出 E 列改为 `=(D{行}-D{上一日行})/D{上一日行}`，C 列照常回写备用值。
			- 改动：`HolidayStatService.java`（`nationalProvincialRingRatio` 去掉 year/comparisonBase 形参）、`HolidayWorkbookService.java`（新增 `ringRatioFormula`，导出按上一行同年 D 列）、`docs/database.md`（`comparison_base` 与计算口径两处）。
			- 验证：新增 `HolidayComparisonBaseTest`：① 库内存 `comparison_base=320.2418` 时，10-04 国省道环比仍按前一日 323.7837 计算，且不等于按基期算出的值；② 导出公式 = `=(D6-D5)/D5`。`mvn -o test` 全绿（4 个测试类）。

			### 10-06：待确认——10-04 国省道剔站（鄂州樊家庄）怎么进系统

			- 手工口径已逐项核对，与库内 `observation_station_flow` 完全对得上：
			- 10-04 国省道值（2026/2025/2024）= 原值 − 樊家庄当日值 -> 322.7695 / 337.5009 / 322.5277 万辆次（樊家庄 8856 / 4492 / 2328）。
			- 10-04 环比分母 = 2026-10-03 原值 − 樊家庄 10-03 值 = 323.7837 − 3.5419 = 320.2418 万辆次 -> 环比 = 322.7695/320.2418 − 1 = +0.79%。
			- 10-03 显示值与累计仍用原值 323.7837，被剔的 320.2418 只落到 C 列备用。
			- 趋势结论（需先跟领导对齐）：只剔樊家庄，10-04 国省道环比只有 +0.79%；同日高速小客车 +9.78%、铁路 +9.94%、民航 +11.69%、道路 +4.99%、水路 +4.33%。剔一站填不平约 9 个百分点的趋势差，与「让国省道和高速趋势一致」的预期并不相符，建议同时请鄂州核实原始记录。
			- 待决策的代码方案：因 `comparison_base` 已定为纯备用，系统无法从「当日值」反推剔站基期，需要另设机制。推荐新增「异常站剔除」配置（站点编号 + 生效日期 + 年份），算环比分母时用 `observation_station_flow` 的「该日站点合计 − 剔站值」作基期；显示值与累计仍用原值。
			- 决策点：① 做成可配置的通用「异常站剔除」（推荐，可复用于其他节假日/站点），还是只按本次 10-04 一次性处理；② 剔站只影响国省道环比分母，还是也要下沉到非营业性小客车/公路/全社会的环比（手工稿实际把 4.17% / 4.55% 也一起改了）。

			## 最新（2026-10-05）

			### 10-05 上午：关机快照（当前状态）
			@@ -11,7 +46,7 @@
			- 已完成：v1.0.0 正式发布包 `deploy/traffic-audit-deploy-20261005-v1.0.0/`（zip 77.78 MB）已生成，去密自检、版本自检、结构核对与真实启动冒烟均通过，待上传服务器。版本管理代码与文档均已提交推送（`main` = `93b36c8`）。
			- 运行状态：关机前本机 dev 服务仍在运行（后端 8090 java PID 64112、前端 8080 node PID 46472），随关机停止，无需处理；打包冒烟用的 8095 实例已停止、端口已释放。
			- 工作区：除若干本地临时文件（`_tmp_*`）与一份专项统计 xls 外，git 工作区与远端 `main` 一致；`docs/工作日结/`、`docs/功能测试报告/` 等按约定不入库。
			- 下次接手：先读根目录 `AGENTS.md` + 本文件；待办见第九节（数值精度统一改造、态势感知图、AI 助手 RAG、经济指标试算等），首要事项是跟进正式包在服务器的部署结果。
			- 下次接手：先读根目录 `AGENTS.md` + 本文件；待办见第七节（数值精度统一改造、态势感知图、AI 助手 RAG、经济指标试算等），首要事项是跟进正式包在服务器的部署结果。

			### 10-05 上午：正式发布包按新版本管理重新生成（v1.0.0，单端口瘦包）

			@@ -286,7 +321,7 @@
			- Excel 浮点精度（2026-10-02 追加）：参考 `docs/Excel浮点数存储.txt`，新增 `HolidayNumberUtils`（`NumberToTextConverter.toText` + `BigDecimal`，`MathContext(15, HALF_UP)`）；节假日模块由 `Double` 全面改 `BigDecimal`；三张表数值列改 `DECIMAL(30,15)`；库内 6 条客运系数由 2.3999999999999995 校正为 2.4。迁移脚本 `docs/sql_holiday_decimal_migration.sql`。
			- 菜单顺序：“专项统计”已移到“报表生成”之后，当前为报表生成 -> 专项统计 -> 规则管理 -> 用户管理 -> 系统配置。
			- 节假日删除复活修复（2026-10-02 追加）：原初始化逻辑每次启动补齐缺失的第 N 日，导致 admin 删除 2026-10-08 后被重新插入；现改为仅 `holiday_calendar` 整表为空时首次初始化。重启后 2026 年十一保持 10-01 至 10-07 共 7 天。
			- 普通国省道环比基期（2026-10-02 追加）：普通国省道 C 列为可选环比基期，仅 2026 年启用；填写后只影响普通国省道车流量自身环比 `当日 / 基期 - 1`，未填写按前一日。`holiday_vehicle_flow.comparison_base` 已入库，导入导出与历史变更确认均已接入；折算人员流动量、总人员流动量和 Word 快报继续按 Excel 原公式，不受基期影响。2024/2025 不使用。
			- 普通国省道环比基期（2026-10-02 追加，2026-10-06 方案 D 已修正）：C 列语义最终确定为“下一日环比分母的调整值”；填写后只影响下一日的环比分母，不影响 C 所在日及累计、走势图。`holiday_vehicle_flow.comparison_base` 已入库，导入导出与历史变更确认均已接入。
			- 快报首日口径（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)` 列型、历史变更两阶段导入回归均已实测；功能测试报告与工作日结按 2026-09-27 提交规范仅本地留存（不入库）：`docs/功能测试报告/功能测试报告_重要节假日专项统计_2026-10-02.md`、`docs/工作日结/工作日结_2026-10-02.md`。

			@@ -4,6 +4,41 @@
			> 每天结束时：把当天进展、踩过的坑、新需求、未完成事项更新到本文件，然后可以放心开新对话。
			> 协作约定（2026-08-31）：说「提交」= 本地 commit + 推送到远端 git（origin main，Gitblit），不再只做本地 commit。

			## 最新（2026-10-06）

			### 10-06：方案 D 已实现（往年国省道调整表 + 环比基期只作用于前一日分母）

			- 最终口径：`HolidayStatService.loadVehicleByDate` 先用 `holiday_vehicle_adjustment` 覆盖对应历史年份的“当日值”，供走势图、同比、累计和快报使用；随后构造“前一日环比分母”，若前一日普通国省道 C 列有值，则用 C 替换该日前一日国省道值，并据此重算非营业性人员流动量、公路人员流动量和总计。所有环比行只继承这份分母。
			- 关键边界：C 只影响“下一日的环比分母”，不影响 C 所在日的当日值、累计或走势图；调整表只维护历史年份（`year < 当前年份`），2026 年调整仍由导入 Excel 的 D 列进入当日值。
			- 本轮实现：新增 `holiday_vehicle_adjustment` 表及 mapper/service/controller；前端在专项统计-节假日页的“节假日数据”和“观测站分日调查数据”之间新增“往年国省道数据调整”卡片（后续按用户提议保持该位置），支持年份筛选、新增、编辑、删除和原因留痕；部署脚本与 migration 清单已同步。
			- 10-04 导入预检（只读，不写库）：用 `C:\Users\jcxiong\Downloads\2026年十一数据 (2).xlsx` 以 `allowHistoricalOverwrite=false` 调导入接口，返回确认项：
			- `第4日 2026-10-04 普通国省道：原值 323.6551，导入值 322.7695`
			- `第3日 2026-10-03 普通国省道环比基期：原值空，导入值 320.2418`
			因此 C5 由空变有值不会硬拒绝导入，只会要求历史变更确认；用户确认后即可随调整后的 Excel 重导写入。
			- 当前库状态：本地 `traffic_audit.holiday_vehicle_adjustment` 已执行 DDL（0 行）；2026-10-04 业务值仍为旧值 `323.6551`，等待用户自行重导调整后的 Excel。助手未执行任何业务数据导入、覆盖或重导。
			- 验证：后端 `mvn -o test` 9 个测试全绿（含 C5 只改 10-04 环比分母、历史调整进入 2025 当日值）、前端 `npm run build` 通过；页面实测“往年国省道数据调整”卡片与新增弹窗正常。
			- 已知取整边界（需沿用现有口径或另作决策）：快报百分比目前按既定规则先复现源 Excel 单元格格式，再取 1 位小数。10-04 总计环比原始值约 `4.5481%`，源格显示 `4.55%`，再取 1 位得到 `4.6%`；若直接从原始值一次取 1 位则是 `4.5%`。当前代码保留“先 Excel 显示、再快报 1 位”的既有口径；若领导要求改为一次取整，需要单独改快报百分比路径。

			> 说明：本文件早前“环比基期只作备用、不参与计算”的段落已作废。该版本针对的是旧实现误把 C 放到 C 所在日本身计算的问题；自方案 D 起，C 的正确语义是前一日环比分母的调整值。

			### 10-06（已作废，见上方方案 D）：普通国省道「环比基期」改为人工备用值（不再参与计算）

			- 背景：10-04 鄂州樊家庄站中小客流量断崖下跌（35419 -> 8856），领导要求剔除。手工稿快报的做法是：先用剔站后的数值算出 10-04 环比，把 10-03 国省道值挪到「环比基期」C 列备用，再把 10-03 恢复原值以免影响累计。用户明确口径：「环比基期」只用于数据备用，不参与任何计算。
			- 旧行为（错）：`HolidayStatService.nationalProvincialRingRatio` 在 2026 年只要 `comparison_base` 有值就按「当日 / 环比基期 - 1」算国省道环比；导出时 E 列写 `=(D{行}-C{行})/C{行}`。按手工稿的 C 列摆法（基期放在被比日那行），这样算还会错位（10-03 环比被算成 +1.11%）。
			- 新行为（本次已改）：国省道环比固定「当日 / 前一日 - 1」，2024/2025/2026 一致；`comparison_base` 只在导入/导出/页面展示时原样保存与回写，不参与环比、折算、累计。导出 E 列改为 `=(D{行}-D{上一日行})/D{上一日行}`，C 列照常回写备用值。
			- 改动：`HolidayStatService.java`（`nationalProvincialRingRatio` 去掉 year/comparisonBase 形参）、`HolidayWorkbookService.java`（新增 `ringRatioFormula`，导出按上一行同年 D 列）、`docs/database.md`（`comparison_base` 与计算口径两处）。
			- 验证：新增 `HolidayComparisonBaseTest`：① 库内存 `comparison_base=320.2418` 时，10-04 国省道环比仍按前一日 323.7837 计算，且不等于按基期算出的值；② 导出公式 = `=(D6-D5)/D5`。`mvn -o test` 全绿（4 个测试类）。

			### 10-06：待确认——10-04 国省道剔站（鄂州樊家庄）怎么进系统

			- 手工口径已逐项核对，与库内 `observation_station_flow` 完全对得上：
			- 10-04 国省道值（2026/2025/2024）= 原值 − 樊家庄当日值 -> 322.7695 / 337.5009 / 322.5277 万辆次（樊家庄 8856 / 4492 / 2328）。
			- 10-04 环比分母 = 2026-10-03 原值 − 樊家庄 10-03 值 = 323.7837 − 3.5419 = 320.2418 万辆次 -> 环比 = 322.7695/320.2418 − 1 = +0.79%。
			- 10-03 显示值与累计仍用原值 323.7837，被剔的 320.2418 只落到 C 列备用。
			- 趋势结论（需先跟领导对齐）：只剔樊家庄，10-04 国省道环比只有 +0.79%；同日高速小客车 +9.78%、铁路 +9.94%、民航 +11.69%、道路 +4.99%、水路 +4.33%。剔一站填不平约 9 个百分点的趋势差，与「让国省道和高速趋势一致」的预期并不相符，建议同时请鄂州核实原始记录。
			- 待决策的代码方案：因 `comparison_base` 已定为纯备用，系统无法从「当日值」反推剔站基期，需要另设机制。推荐新增「异常站剔除」配置（站点编号 + 生效日期 + 年份），算环比分母时用 `observation_station_flow` 的「该日站点合计 − 剔站值」作基期；显示值与累计仍用原值。
			- 决策点：① 做成可配置的通用「异常站剔除」（推荐，可复用于其他节假日/站点），还是只按本次 10-04 一次性处理；② 剔站只影响国省道环比分母，还是也要下沉到非营业性小客车/公路/全社会的环比（手工稿实际把 4.17% / 4.55% 也一起改了）。

			## 最新（2026-10-05）

			### 10-05 上午：关机快照（当前状态）
			@@ -11,7 +46,7 @@
			- 已完成：v1.0.0 正式发布包 `deploy/traffic-audit-deploy-20261005-v1.0.0/`（zip 77.78 MB）已生成，去密自检、版本自检、结构核对与真实启动冒烟均通过，待上传服务器。版本管理代码与文档均已提交推送（`main` = `93b36c8`）。
			- 运行状态：关机前本机 dev 服务仍在运行（后端 8090 java PID 64112、前端 8080 node PID 46472），随关机停止，无需处理；打包冒烟用的 8095 实例已停止、端口已释放。
			- 工作区：除若干本地临时文件（`_tmp_*`）与一份专项统计 xls 外，git 工作区与远端 `main` 一致；`docs/工作日结/`、`docs/功能测试报告/` 等按约定不入库。
			- 下次接手：先读根目录 `AGENTS.md` + 本文件；待办见第九节（数值精度统一改造、态势感知图、AI 助手 RAG、经济指标试算等），首要事项是跟进正式包在服务器的部署结果。
			- 下次接手：先读根目录 `AGENTS.md` + 本文件；待办见第七节（数值精度统一改造、态势感知图、AI 助手 RAG、经济指标试算等），首要事项是跟进正式包在服务器的部署结果。

			### 10-05 上午：正式发布包按新版本管理重新生成（v1.0.0，单端口瘦包）

			@@ -286,7 +321,7 @@
			- Excel 浮点精度（2026-10-02 追加）：参考 `docs/Excel浮点数存储.txt`，新增 `HolidayNumberUtils`（`NumberToTextConverter.toText` + `BigDecimal`，`MathContext(15, HALF_UP)`）；节假日模块由 `Double` 全面改 `BigDecimal`；三张表数值列改 `DECIMAL(30,15)`；库内 6 条客运系数由 2.3999999999999995 校正为 2.4。迁移脚本 `docs/sql_holiday_decimal_migration.sql`。
			- 菜单顺序：“专项统计”已移到“报表生成”之后，当前为报表生成 -> 专项统计 -> 规则管理 -> 用户管理 -> 系统配置。
			- 节假日删除复活修复（2026-10-02 追加）：原初始化逻辑每次启动补齐缺失的第 N 日，导致 admin 删除 2026-10-08 后被重新插入；现改为仅 `holiday_calendar` 整表为空时首次初始化。重启后 2026 年十一保持 10-01 至 10-07 共 7 天。
			- 普通国省道环比基期（2026-10-02 追加）：普通国省道 C 列为可选环比基期，仅 2026 年启用；填写后只影响普通国省道车流量自身环比 `当日 / 基期 - 1`，未填写按前一日。`holiday_vehicle_flow.comparison_base` 已入库，导入导出与历史变更确认均已接入；折算人员流动量、总人员流动量和 Word 快报继续按 Excel 原公式，不受基期影响。2024/2025 不使用。
			- 普通国省道环比基期（2026-10-02 追加，2026-10-06 方案 D 已修正）：C 列语义最终确定为“下一日环比分母的调整值”；填写后只影响下一日的环比分母，不影响 C 所在日及累计、走势图。`holiday_vehicle_flow.comparison_base` 已入库，导入导出与历史变更确认均已接入。
			- 快报首日口径（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)` 列型、历史变更两阶段导入回归均已实测；功能测试报告与工作日结按 2026-09-27 提交规范仅本地留存（不入库）：`docs/功能测试报告/功能测试报告_重要节假日专项统计_2026-10-02.md`、`docs/工作日结/工作日结_2026-10-02.md`。