fix(deploy): -NoFrontendDist 保留 backend/web，单端口瘦包改用 -SkipServiceWrapper

xyc

3 天以前 5d11297d2368760e77a5494008b0a821ae507b97

 HANDOFF.md

@@ -5,6 +5,122 @@
> **协作约定（2026-08-31）**：说「提交」= 本地 commit + 推送到远端 git（origin main，Gitblit），不再只做本地 commit。

## 最新（2026-10-04）
### 10-04 深夜：折线数值标签回到贴近本点（v35，待用户验收）

- **用户反馈**：v31「避开折线」版本不如上一版 v27 —— 虽然标签不压线了，但很多标签离自己的数据点太远，一眼看不出标的是哪个点。要求回到贴近本点的效果。
- **新问题与旧需求的冲突**：更早的原始诉求是「数字压线看不清」；这次诉求是「数字必须贴近本点」。两者并存，必须同时满足。
- **实现（`HolidayTrendChartService`）**：
  - 标签排版**完整回退到 v27 算法**：按同日点位距离做代价（`ownDistance ×10`），候选含近/远的上、下、左、右及四角，动态规划保证同日标签与点位上下顺序一致（`lineLabelCost`、`lineLabelCandidates`）。v31 的线条掩膜、Chamfer 距离场、颜色亲和项全部移除。
  - **新增粗白描边（halo）** 解决「压线看不清」：`drawLabelWithHalo` 用 `TextLayout` 取字形轮廓，先以白色 `HALO_OUTLINE_WIDTH=4.0f` 圆角描边，再用本色填充。数字即使落在折线上也清晰可读，从而允许标签贴回本点。折线图、堆叠图外置标签、饼图标签统一走该方法。
  - 顺带清理调试遗留：删除 `LABEL_DEBUG`/`CHART_SEQ`/`TRENDDBG` 打印，以及不再使用的 `lineNormal(...)` 与 `DayLabel.normalX/normalY`。
- **量化验证（RapidOCR 标签包围框中心 ↔ 真实数据点坐标）**：标签到本点平均距离 v27=`36.8px`、v31=`53.2px`、v35=`36.7px`（越小越贴近本点）。v35 与用户认可的 v27 基本一致，明显优于被否的 v31。
- **其余验证**：`mvn compile`/`mvn test` 通过（无编译告警遗留）；Word COM 8 页 15 图（1+2×7）；RapidOCR 复检 12 张折线图数值标签包围框重叠数 = 0；`label_affinity` 复检图 11 每个数据标签到本线 3~8px 且本线是最近线（无「CLOSER TO 其他色」）；放大 6× 复核图 11 左上标签确为 `630.99`（低分辨率 OCR 曾误读为 `1630.99`）。v27↔v35 像素差约 1%，集中在标签处，即白描边生效且未破坏折线。
- **产物与状态**：`_tmp_holiday_verify/holiday_trend_2026-10-04_v35.docx`；下载副本 `C:\Users\jcxiong\Downloads\2026年十一假期全省综合运输客流量走势图（修改版-数字贴近折线-白边清晰）.docx`。未导入、覆盖或重导任何数据。待用户验收；验收前不提交、不推送；现有 `deploy/traffic-audit-deploy-20261004.zip` 仍是 v24 行为，验收后需重建。

### 10-05：走势图 v35 验收通过 + 单端口发布包（-NoFrontendDist -SkipServiceWrapper）

- **验收**：v35（折线数值标签回到贴近本点 + 白描边）2026-10-05 用户验收通过。
- **打包需求（用户澄清）**：服务器单端口，只需要 `backend\web`，不要独立的 `frontend/dist`；为保证包完整，`backend\web` + jar + docs 都要。服务器非首次发布、服务已装，可加 `-SkipServiceWrapper` 去掉服务注册器。
- **打包工具修正**：先前加的 `-NoFrontend` 语义错了（把 `backend\web` 也去掉了），现改为 `-NoFrontendDist`。它只跳过独立 `frontend\` 目录（不复制 dist / nginx 示例），**仍构建（或要求）dist 并同步 `backend\web`**（单端口必需，否则页面 404）。`-SkipFrontend` 仍为“不重建、复用现有 dist”。
- **发布包**：`deploy/traffic-audit-deploy-20261005-2/`（351 文件 / 94.55 MB；zip **77.78 MB**）。已核对：无 `frontend/`、无 `trafficAudit.exe/.xml/install-service*`（服务包装器已排除）；`backend\web` 44 文件与 `frontend\dist` 逐文件哈希一致；jar 内置配置全占位符（去密自检通过）；包内 `HolidayTrendChartService.class` 与 `target/classes` 一致（含 v35 代码）。较上一完整包（110.49 MB / zip 83.77 MB）省约 16 MB 解压 / 6 MB 压缩。
- **作废**：`deploy/traffic-audit-deploy-20261005/`（错误语义下的产物，缺 `backend\web`）已被 `-2` 取代，勿用。
- **部署注意**：覆盖 jar（及按需 `application.yml`）即可；`backend\web` 已随包提供。服务已装，无需重新注册。
- **状态**：已打包，待用户上传到服务器。

### 10-04 深夜：折线数值标签避开折线并贴近本线（v31，待用户验收）

- **用户反馈（领导看后，两轮）**：① 各年份数字离本线有远有近，希望贴近各自色线且不错乱；② 仍有数字压在折线上看不清（第一轮只是“贴近”，标签会落在线上）。用户建议：调纵轴刻度拉开折线、或加左右避让让标签不压线。
- **实现（`HolidayTrendChartService`）**：
  - 标签排版改为「动态规划 + 线条像素避让」。图表先画折线和标记，再把所有系列颜色像素（容差 45）做成掩膜，对每个候选标签位置统计其覆盖的线条像素数，`×700` 重罚——数字不再压线。
  - 为每条系列建立 Chamfer 距离场（到该色最近像素的距离）。代价新增两项：`max(0, 自己那条线的距离-3)×40`（把标签拉回本线旁，防止飘远）与颜色亲和项 `max(0, 自己线距 - 别的线距 + 4)×200`（要求本线是最近的线，避免贴到别的系列）。
  - 旧的「离别的同日点位更近」惩罚由 `×5000` 降到 `×400`，避免它压倒亲和项；`ITEM_LABEL_GAP` 12→10；候选含近/远的上、下、左、右及四角。
  - 保留同日标签与数据点一致的上下顺序，避免标签与折线上下反转。
- **调参过程提示**：v27（只按点位距离排序）→ 标签压线；v28（只加覆盖像素惩罚）→ 标签离本线、贴到别的色线旁；v31（覆盖惩罚 + 本线距离 + 颜色亲和）→ 两者兼顾。验证标签是否“贴错线”不能只看 OCR 包围框到异色的距离：相邻的异色**标签**会被误判为异色**线**，必须肉眼核对整图。
- **验证**：`mvn test -f traffic-audit-server\pom.xml` 通过。真实库只读生成 `_tmp_holiday_verify/holiday_trend_2026-10-04_v31.docx`；Word COM 8 页 15 图（1+2×7）。RapidOCR 复检 15 张图数值标签包围框重叠数为 0。肉眼核对图 1（跨区域人员流动量）、图 2（累计）、图 4（自驾）、图 6（水路）、图 9（高速）、图 11（车流总量）：数值标签均离开折线、位于各自色线旁、颜色对应正确；图 11 的 630.99/601.04/571.31 分别紧贴蓝/红/绿折线。
- **产物与状态**：`C:\Users\jcxiong\Downloads\2026年十一假期全省综合运输客流量走势图（修改版-数值标签避开折线）.docx`。未导入、覆盖或重导任何数据。待用户验收，验收前不提交、不推送；现有 `deploy/traffic-audit-deploy-20261004.zip` 仍是 v24 行为，需验收后重建。

### 10-04 晚：走势图 3 项坐标轴调整（v24，用户已验收）

- **用户修改项**：① 坐标轴单位（万人次、万辆次、公里/小时、拥挤度、日期）改成和刻度一样的颜色；② 两个堆叠图的坐标轴改成与其他图一样的黑色；③ “万人次/占比”继续放在堆叠图右上角。
- **实现**：`HolidayTrendChartService` 把 `drawUnitLabel`、`drawUnitLabelTopRight`、`drawDateLabel` 的文字色由黑色改为刻度灰 `(102,102,102)`；横向堆叠图在数据区底边补画 `2.2px` 纯黑基线，覆盖 JFreeChart 默认偏灰的 1px 轴线和抗锯齿边缘，不添加箭头。折线图黑色坐标轴逻辑未改，堆叠图单位仍绘制在右上角。
- **验证**：`mvn test -f traffic-audit-server\pom.xml` 通过。真实库只读生成 `_tmp_holiday_verify/holiday_trend_2026-10-04_v24.docx`；Word COM 实测 8 页、15 张图。像素检查：折线图左上单位、日期及堆叠图右上单位均为 `(102,102,102)`；图 12/13 底轴在 y=529 为纯黑连续线；普通折线图底轴仍为纯黑。
- **产物与状态**：`C:\Users\jcxiong\Downloads\2026年十一假期全省综合运输客流量走势图（修改版-最新）.docx` 当时被 Word/WPS 占用，已另存为 `C:\Users\jcxiong\Downloads\2026年十一假期全省综合运输客流量走势图（修改版-最新-坐标轴调整）.docx`；原“最新”文件未覆盖。未导入、覆盖或重导任何数据。2026-10-04 用户已验收通过，随本次提交推送。

### 10-04 晚：走势图 4 项修改（v23，待用户验收）

- **用户修改项**：① 折线数值标签与折线上下顺序反了（累计流动量图：蓝线在上、标签却在下；第一张图首日最高是蓝点、最近的标签却是棕色）；② 公路出行结构图例把自驾放前面（棕色），与每日客流构成一致；③ 横坐标应为万人次/占比（数值轴放到底部）、去掉纵轴线与箭头；④ 每日客流构成恢复 5 条（自驾/道路/铁路/民航/水路），占比小的数字标在色块右边、用颜色区分。
- **实现**：
  - `HolidayTrendChartService.drawXYItemLabels` 重写：先把同一日期各系列按点位 y 从上到下排序，标签再按该顺序从上往下摆（下界为前一个标签底部 +3），**从而不会出现标签与折线上下反转**；避让权重改为「标签重叠 × 1000 + 数据点重叠 × 1」，并删除原来会把标签一路推到图表下方的非白像素惩罚项（`nonWhiteRatio`）。
  - 横向堆叠图：`plot.setRangeAxisLocation(AxisLocation.BOTTOM_OR_LEFT)` 把数值轴放到底部（万人次 / 占比 就是横坐标）；`domainAxis.setAxisLineVisible(false)` + `setTickMarksVisible(false)` 去掉纵轴线和刻度；`render` 对横向堆叠图不再画坐标轴箭头；单位改到右上角（`drawUnitLabelTopRight`）。
  - 堆叠图块内放不下的小数字，改为在色块右侧用同色文字标注（同一行按色块位置排成一列，列 x 取该行最右色块端 +8，并限制在预留 74px 右边距内）；放得下仍用白字写在块内。
  - `HolidayTrendService.roadStructureSeries` 顺序改为 自驾出行量（棕）、道路客运量（蓝）；`dailyShareSeries` 恢复 自驾/道路/铁路/民航/水路 5 条，删除上一轮临时合并用的 `sumNullableLists`。
- **验证**：`mvn test -f traffic-audit-server\pom.xml` 通过；v23 Word COM 实测 8 页（1+2×7，15 张图）。RapidOCR 复检 12 张折线图无标签重叠；逐日比对标签颜色顺序与折线点位顺序一致（累计图 10月4日 点位 2025 在上/2024 在下，标签同样 2025 在上、2024 在下；修改前 v20 恰好相反）；首图 10月1日最高点（蓝色 2025）的数值标签就在该点位正上方。图 12 图例为「自驾出行量·道路客运量」，数值轴在底部 0–12,000，单位万人次在右上角，无箭头、无纵轴线；452/228 以蓝字标在蓝块右侧，648 白字在块内。图 13 图例恢复 5 项，87.8% 等大占比白字在块内，道路/民航/水路等小占比以同色数字标在右侧一列。
- **数据操作与状态**：未导入、覆盖或重导任何数据。最终文件已覆盖到 `C:\Users\jcxiong\Downloads\2026年十一假期全省综合运输客流量走势图（修改版-最新）.docx`；待用户验收，验收前不提交、不推送。

### 10-04 傍晚：走势图 5 项微调（v20，待用户验收）

- **用户修改项**：① 纵轴单位仍与纵轴重叠，继续上移；② 第 1 页除标题外全空白，需放 1 张图到第 1 页；③ 横纵坐标刻度与图例偏黑，稍微调淡；④ 饼图标签颜色改为与扇区一致；⑤ 两个堆叠图效果仍不好，块做大、数字写进块里。
- **实现**：`HolidayTrendChartService` 为坐标类图表预留 `UNIT_LABEL_BAND=58px` 的顶部空白（`reserveUnitLabelBand` 调 `plot.setInsets`），单位标签基线改为 `dataArea.getY()-22`，彻底脱离轴线与最高刻度；刻度/图例文字色由 (70,70,70) 调淡为 (102,102,102)，坐标轴线与箭头仍为黑色；饼图标签（含引线框内文字）通过 `TextFragment` 反射改为对应扇区色；堆叠图维持横向，`categoryMargin 0.08->0.05`、`itemMargin 0.05` 让色块变厚，块内放得下就用 17px 白字写在块内，放不下才用同色引线拉到块外；折线数据标签左侧最小留白 `dataArea.minX+16`，避免紧贴纵轴刻度。
- **验证**：`mvn test -f traffic-audit-server\pom.xml` 通过。真实库只读生成 `_tmp_holiday_verify/holiday_trend_2026-10-04_v20.docx`（571 KB，15 张图）；Word COM 实测 8 页，第 1 页标题+1 张图，第 2-8 页各 2 张图，无空白页。RapidOCR 复检 12 张折线图文字包围框重叠数为 0；单位“万人次/占比”与最高刻度、轴线已分离（图 1 单位 y=17..44、顶部刻度 y=53..77）；堆叠图 12 的 452/8,595、648/10,410、228/3,962 与堆叠图 13 的 87.8%/7.4% 均在块内，个别过窄的 4.8% 用同色引线拉到块外；饼图标签颜色与扇区一致（铁路绿、民航紫、道路蓝、水路青）。
- **口径变化提醒**：图 13「每日客流构成变化」（附录一）由原先 5 条（自驾/道路/铁路/民航/水路）合并为 3 条（自驾/道路/其他方式=铁路+民航+水路），目的是让色块足够宽、数字能写进块内；正文 5 种运输方式走势图未受影响。
- **数据操作与状态**：未导入、覆盖或重导任何数据。最终文件已覆盖到 `C:\Users\jcxiong\Downloads\2026年十一假期全省综合运输客流量走势图（修改版-最新）.docx`；待用户验收，验收前不提交、不推送。

### 10-04 下午（3）：走势图 8 项修改（待用户验收）

- **用户修改项**：纵轴单位上移避开箭头；删除附录二同比走势；同日期的三年折线点恢复垂直对齐；图表标题去掉“2026年”；“观测站”改为“普通国省道观测站”；堆叠图小占比改为柱外引线标注；文档改为每页 2 图；图例“道路营业性客运量”改为“道路客运量”、“非营业性自驾折算客流”改为“自驾出行量”。
- **实现**：`HolidayTrendChartService` 恢复所有年份同一 x 坐标，纵轴单位绘制在数据区上方，堆叠图小占比使用同色引线拉到柱外；折线数值标签改为对其他数值标签设置极高避让优先级，白描边保留。`HolidayTrendService` 删除附录二同比 2 图，原附录三顺延为附录二，并更新标题和图例文字，当前共 15 张图。`HolidayTrendWordService` 封面后强制分页，取消章节标题后的多余空段，再按每 2 图自动分页。
- **验证**：`mvn test -f traffic-audit-server\pom.xml` 通过。真实库只读生成 `_tmp_holiday_verify/holiday_trend_2026-10-04_v17.docx`；Word COM 实测 9 页，封面单独第 1 页，第 2–8 页均为 2 张图，最后 1 张图单独第 9 页，无空白页。RapidOCR 复检 12 张折线图的数值标签重叠数为 0；堆叠图图 12、13 的小占比数字均可见；图 3“水路 0.23%”仍在右侧；图例已识别为“道路客运量”“自驾出行量”，图表标题中不再出现“2026年”。
- **数据操作与状态**：未导入、覆盖或重导任何数据。最终验收文件已复制到 `C:\Users\jcxiong\Downloads\2026年十一假期全省综合运输客流量走势图（修改版-最新）.docx`（原“修改版”文件当时被 WPS 占用，未覆盖）；待用户验收，验收前不提交、不推送。

### 10-04 下午（2）：走势图标签、折线间距与横坐标准确性修正（待用户验收）

- **用户反馈**：饼图“水路”引线难辨认需固定到右侧；堆叠图要显示数值；图例改黑色放大；横轴“日期”上移；纵轴单位放到箭头上方；坐标轴和刻度改黑色并放大；折线加粗、尽量拉开；修复横轴错位一天；折线数值标签要与折线同色，并检查标签重叠。
- **修复**：`HolidayTrendChartService` 饼图子类改为在 JFreeChart 已分好的左右标签集合中把“水路”从左集合移到右集合；折线宽度由 4px 调至 6px，多序列按 ±0.08 做轻微横向错开；关闭 JFreeChart 默认折线标签，改为逐点自定义排版：按上/下/远上/远下/左/右候选位置避让已放标签和数据点，并对单位区域留空；标签使用对应折线颜色并加白色描边。横轴错位根因是原 `XYSeries.add(i + 1, ...)` 与 `SymbolAxis` 实际整数位置 `0..7` 不一致，已改为 `add(i, ...)`。
- **验证**：`mvn test -f traffic-audit-server\pom.xml` 通过；真实库只读生成 `_tmp_holiday_verify/holiday_trend_2026-10-04_v14.docx`。RapidOCR 复检 14 张折线图，数值标签包围框重叠数为 0，未再识别出两个数值粘连；三年折线每图均识别出 2026 年 3 个、2025 年 8 个、2024 年 7 个，共 18 个数值标签，颜色计数为红 3、蓝 8、绿 7。饼图“水路 0.23%”位于右侧（OCR 中心 x≈801.5），其他小占比标签在左侧；堆叠图数值可见。10 月 1 日轴刻度 x≈123.5，首日数据点已落在第一格。
- **数据操作与状态**：未导入、覆盖或重导任何数据。新版已复制到 `C:\Users\jcxiong\Downloads\2026年十一假期全省综合运输客流量走势图（修改版）.docx`；待用户验收，验收前不提交、不推送。

### 10-04 中午：走势图外观按模板重制（待用户验收）

- **用户反馈的 7 项问题**：章节标题重复、图比模板大、字小线细、网格和浅灰背景、坐标轴无箭头且单位位置不符、纵轴范围不合适、饼图小占比标签应拉到圆外。
- **修复**：`HolidayTrendWordService` 克隆章节时移除模板自动编号；每张图按模板对应尺寸设置 `wp:extent` 和内部 `a:ext`，并移除模板旧 `srcRect`。`HolidayTrendChartService` 改为纯白背景、无网格/无交替灰色带、黑色坐标轴带箭头、左上方水平单位、右下角日期；折线字号按 Word 纸张实际显示尺寸放大、加粗线宽和点径；纵轴不强制从 0 开始并按数据上下留白；百分比堆积图固定 0%-100%；饼图关闭 `simpleLabels`，使用外部标签和引线。
- **验证**：`mvn test` 全部通过，新增图表浅灰背景与 Word 编号/尺寸回归断言；前端 `npm run build` 通过（仅原有 bundle 体积警告）。真实库生成最终稿 `C:\Users\jcxiong\Downloads\2026年十一假期全省综合运输客流量走势图（修改版）.docx`，Word COM 实测 9 页、17 张图；程序检查全部 `gray243=0` 且 6 个章节段 `numPr=false`，图片尺寸与模板 7 种目标框一致。最终版 PNG 按模板显示框宽高比输出（不再被 Word 拉伸变形），刻度/图例 18px、数据标签 20px、单位 22px，线宽 4px。
- **数据操作**：全程只读，未导入、覆盖或重导任何数据。状态：待用户验收，验收后再提交/推送。

### 10-04 下午：新增节假日综合运输客流量走势图初版（外观已按反馈重制）

- **需求口径（用户 2026-10-04 确认）**：走势图分 12 张正文 + 附录；领导原话为“各种运输方式客流量走势图，高速和国省道车流量走势图”。最终正文分为三部分：`一、总体情况`（当日总客流、累计总客流、运输方式占比）；`二、各种运输方式客流量走势`（自驾、铁路、水路、民航、道路，共 5 种方式）；`三、车流量走势`（高速、普通国省道、车流总量、公路出行结构）。附录分为每日客流构成变化、同比走势、观测站路网运行。自驾作为运输方式之一，使用非营业性自驾折算客流，单位万人次；高速/普通国省道/车流总量单位万辆次。
- **实现**：新增 `HolidayTrendService`、`HolidayTrendChartService`、`HolidayTrendWordService` 和 `ObservationDailyOperation`，使用 JFreeChart 生成 17 张 PNG；Word 仍以 `docs/专项统计/重要节假日/2026年十一假期全省综合运输客流量走势图.docx` 为模板，重建正文、保留模板页眉页脚和图片尺寸，替换/追加媒体并重建图片关系。新增后端接口 `GET /api/holiday/trend?year=2026&holidayType=NATIONAL_DAY`；前端节假日统计页新增“下载走势图”按钮。
- **数据与口径**：2024/2025/2026 三年，横轴固定 8 天；2024、2026 无第 8 天数据时留空，2025 显示第 8 天。累计曲线只连接实际已有日期，缺日不延续最后累计值。观测站附录按 2026-10-01 至 10-08 查询每日平均机动车速度和平均拥挤度；2026 当前覆盖 10-01/02/03。
- **验证**：`mvn test` 全通过；前端 `npm run build` 成功（仅 bundle 体积原有警告）。真实库数据生成 `_tmp_holiday_verify/holiday_trend_2026-10-04_v3.docx`，Word 统计 12 页、17 张图；下载接口返回约 399 KB DOCX。未执行任何数据导入、覆盖或重导。
- **未跟踪项**：走势图模板和 `_tmp_holiday_verify/` 仍为未跟踪文件；本地可运行，若后续提交/部署需把模板纳入部署包或仓库。状态：外观问题已由本日中午段修复，最终稿待用户验收。

### 10-04 上午：10 月 3 日数据导入并生成快报

- **源文件**：`D:\03_公司\02_项目\27_湖北省道路运输事业发展中心\10_业务\99_专项统计\01_重要节假日\2026\十一\10月3日\2026年十一数据10月3日.xlsx`（2026-10-04 10:11 更新）；观测站原始数据为同目录 `观测站分日调查数据2026.10.3.xls`。
- **导入过程（修正）**：用户先于 10:13:34 导入主数据；助手随后在 10:17:41 又用同一文件重复导入了一次。接口返回 `passengerRows=14, vehicleRows=6, skippedRows=24, successRows=20, failRows=0`，未检测到 10 月 1、2 日历史数据变化。唯一键命中后仅更新 `updated_at`，没有新增重复行。
- **10 月 3 日入库值**：铁路 72.4、民航 5.7571、道路 73.12、水路 5.5668 万人次；高速 193.3634、普通国省道 323.7837 万辆次；合计人员流动量 1397.99694 万人次。
- **观测站数据（修正）**：用户先导入；助手重复导入时按同日覆盖重插，当前 2026-10-03 为 691 行 / 691 个唯一键，无重复；中小客流量合计 3,237,837 辆次（323.7837 万辆次），与普通国省道入库值一致。
- **快报**：已生成 `C:\Users\jcxiong\Downloads\湖北省国庆假期综合运输客流快报（10月3日）.docx`。正文：当日 1398.00 万人次，环比下降 3.3%，同比 2025 下降 10.1%，同比 2024 下降 5.0%；累计 4486.63 万人次，同比 2025 下降 6.3%，同比 2024 下降 2.7%。
- **人工稿比对（10-04 更新）**：手工稿与系统修正版提取文本逐行一致；系统原版仅有两处累计数差异，已随本次代码修正消除。今日走势图功能暂停。

### 10-04 上午（2）：快报累计数按 Excel 亿单位显示精度后再换算

- **问题**：系统原版与手工稿仅两处差异：非营业性小客车累计 `3961.76` 应为 `3961.77`；公路合计累计 `4189.31` 应为 `4189.32`。
- **根因**：源表 `人员流动量汇总!X5/AA5`（总计对应 `U5`）存的是亿单位，单元格格式为 `0.0000000_`。人先看到 7 位小数的显示值，再换算成万人次并保留 2 位；旧代码直接拿原始累计值换算后取 2 位，漏掉了 Excel 显示这一步。
- **修复**：`HolidayBulletinService` 新增 `displayedCumulativeWan(...)`，先按源单元格 7 位小数取整，再乘 10000，最后按快报 2 位输出；应用于总计、非营业性小客车、公路合计三处累计数。
- **验证**：新增单测覆盖 `3961.76472 -> 3961.77`、`4189.31472 -> 4189.32`、`4486.62652 -> 4486.63`；`mvn test` 全通过。重启后基于现有库重新生成 10 月 3 日快报，与手工稿提取文本逐行比对结果为 `NO DIFFERENCES`。本次未执行任何数据导入。
- **产物**：`_tmp_holiday_verify/bulletin_cumulative_display_2026-10-03.docx`。
- **状态**：待用户验收/提交；走势图功能仍暂停。

### 10-04 上午（3）：快报其余 Excel 显示精度路径审计

- **审计范围**：逐项映射快报正文和表格的所有数值来源，核对源工作簿的实际单元格格式、Excel 显示值和代码传入的显示精度。
- **结论**：除已修复的累计值 `U/X/AA` 外，没有发现其他未处理的快报取值路径。源表直接参与快报的 `0.00%` 单元格共 11 处：`人员流动量汇总` D/P/J、V/W/Y/Z/AB/AC，道路 H（同比2024年），水路 D（当日环比）；代码均先按源格式取 2 位，再按快报 1 位处理。
- **补修边界**：道路 H 原按 1 位源格式处理，10 月 3 日碰巧仍为 `6.6%`；改为先按 `0.00%` 得到 `6.62%` 后再取 1 位，边界值不会差 0.1 个百分点。
- **未纳入直接快报路径的格式**：`普通国省道` E/N 虽为 `0.00%`，快报使用的是 `人员流动量汇总` 汇总后的 P/R/T，不使用该两列；高速公路/普通国省道内部 4 位小数人员流动量同理只作为源公式中间列，不直接输出。
- **验证**：`mvn test` 全通过；重启后端后重新生成 10 月 3 日快报，与手工稿逐块、逐单元格比较无任何差异。10 月 2 日与手工稿的内容和表格文本一致，仅有 Word run 分段格式差异。`_tmp_holiday_verify/bulletin_after_road_format_2026-10-01/02/03.docx` 为本轮核对产物。
- **数据操作**：只读核对，未导入、覆盖或重导任何数据。
- **状态**：待用户验收/提交。

### 10-04：快报百分比按 Excel 单元格显示精度后再取 1 位