| | |
|---|
| | | > **每天结束时**：把当天进展、踩过的坑、新需求、未完成事项更新到本文件，然后可以放心开新对话。 |
|---|
| | | > **协作约定（2026-08-31）**：说「提交」= 本地 commit + 推送到远端 git（origin main，Gitblit），不再只做本地 commit。 |
|---|
| | | |
|---|
| | | ## 最新（2026-10-08 上班前关机快照） |
|---|
| | | ## 最新（2026-10-08 铁路客运量走势图10月3日标签避让） |
|---|
| | | |
|---|
| | | ### 10-08：铁路客运量走势图 10月3日 `72.4` 标签上移，避免被 `70.6` 遮挡 |
|---|
| | | |
|---|
| | | - **需求（用户）**：走势图其余部分一律不动，只把 `“十一”假期铁路客运量情况` 图中 10月3日 `72.4` 的标签从点的右边移到点正上方；该位置原本空白，放右边会被 2024 年绿色 `70.6` 标签压住一部分导致看不全。 |
|---|
| | | - **数据背景（2026 十一铁路客运量，万人次）**：2026 年 10月3日 = 72.4，2025 年同日 = 72.3，2024 年同日 = 70.6。三条线同日数值非常接近，自动布局把 `72.4` 放到了点右侧。 |
|---|
| | | - **根因**：标签自动布局（`HolidayTrendChartService.drawXYItemLabels` 动态规划）只对“按数值排序后相邻的两个标签”做重叠惩罚；`72.4` 与 `70.6` 之间隔着 `72.3`，二者不相邻，重叠未被惩罚，因此允许互相覆盖。 |
|---|
| | | - **改动**：`HolidayTrendChartService.lineChart` 新增可选 `List<LineLabelOverride> labelOverrides` 入参（配合 `LineLabelAnchor{ABOVE,BELOW,LEFT,RIGHT}`），可把指定 `(seriesIndex,itemIndex)` 的标签固定到某个方位；不传参时完全走原自动布局，渲染逐字节不变。`HolidayTrendService` 仅对铁路图传一条 override：`seriesIndex=0`（2026 年）、`itemIndex=2`（10月3日）、`ABOVE`。 |
|---|
| | | - **验证**：`mvn -o test` 17/17 通过（新增标签锚点单测：空/不匹配 override 不改变渲染、ABOVE 高于 BELOW）；真实库端到端重新生成走势图，15 张图中仅 `image5.png`（铁路图）SHA-256 变化，其余 14 张逐字节一致；铁路图前后像素差包围盒 `x 313-436, y 395-438`，正是该标签区域；本地 OCR 确认 `72.4` 完整可读、位于点（y≈427）上方，不再与 `70.6`（y431-450）重叠。 |
|---|
| | | - **边界**：只改了铁路这一张图的这一处标签；快报、数据导入、其它统计逻辑均未触碰；未导入/覆盖/重导任何业务数据。 |
|---|
| | | - **重启**：为让按钮下载用上新代码，已用 `start-dev.ps1` 重启后端（前端未动）；可直接在系统里重新下载走势图验收。 |
|---|
| | | - **待办/风险**：这条 override 绑定 `seriesIndex=0`（2026 年）与 `itemIndex=2`（10月3日）；若后续铁路图系列顺序或天数口径调整，需要同步核对。其余年份/日期如再出现标签遮挡，可复用该 override 机制，但需逐图人工确认后再加。 |
|---|
| | | - **验收**：用户 2026-10-08 已看图确认效果可以。 |
|---|
| | | |
|---|
| | | ## 历史（2026-10-08 走势图附录二观测站图天数修正） |
|---|
| | | |
|---|
| | | |
|---|
| | | |
|---|
| | | ### 10-08：观测站速度/拥挤度走势图改用系统配置假期天数（已验收，commit e958585） |
|---|
| | | |
|---|
| | | - **需求（用户）**：走势图最后两张图“普通国省道观测站平均机动车速度”“…平均拥挤度”只含今年数据，横轴天数不应是固定 8 天，而应为系统配置的假期天数。 |
|---|
| | | - **改动**：`HolidayTrendChartService.lineChart` 新增可传 `dayLabels` 的重载（默认仍为 `DAY_LABELS` 8 天，其余 13 张图零改动）；`HolidayTrendService.observationData` 改为按 `configService.findHolidayDays(year, holidayType)`（`day_index>=1`）的天数与日期生成数据点和横轴标签，最后两张图传入该标签。 |
|---|
| | | - **配置依据**：`holiday_calendar` 2026 十一 `day_index 1..7`（7 天，`day_index 0` = 09-30 环比基期）；2025 = 8 天、2024 = 7 天。 |
|---|
| | | - **验证**：`mvn -o test` 16/16 通过（新增自定义横轴标签单元测试）；真实云只读生成走势图，与用户已下载版逐图对比：image1~13 的 SHA-256 完全一致，仅 image14（速度）、image15（拥挤度）变化；OCR 确认新图横轴为 10月1日~10月7日、无 10月8日。 |
|---|
| | | - **边界**：其余图仍固定 8 天口径，未改；未导入/覆盖/重导任何业务数据。 |
|---|
| | | - **重启**：为让按钮下载用上新代码，已用 `start-dev.ps1` 重启后端（前端未动），重启时间 2026-10-08 10:38:53；可直接在系统里重新下载走势图验收。 |
|---|
| | | - **验收**：用户 2026-10-08 在系统里重新下载走势图后审核，验收通过。 |
|---|
| | | |
|---|
| | | ## 历史（2026-10-08 上班前关机快照） |
|---|
| | | |
|---|
| | | ### 10-08：走势图 `(14)` 与已验收 `(12)` 比对（内容一致） |
|---|
| | | |
|---|
| | | - **用户任务**：比对系统重新下载的 `C:\Users\jcxiong\Downloads\2026年十一假期全省综合运输客流量走势图 (14).docx` 与此前验收通过的 `(12)`。 |
|---|
| | | - **比对方法**：按 DOCX 包逐项比对。`(12)`、`(13)`、`(14)` 的 31 个内部文件（含正文 XML、样式、关系文件和全部图表图片）逐个 SHA-256 完全相同。 |
|---|
| | | - **比对结果**：三个文件整体 SHA-256 不同，仅因 ZIP 容器时间戳等打包元数据不同；文件长度相同，差异为 234 个字节，集中在 3 字节时间戳段，文档内容没有任何差异。 |
|---|
| | | - **结论**：`(14)` 就是已验收的 `(12)` 同一版本，图表数值、标签、版式均未变化，不需要重新验收。 |
|---|
| | | - **边界**：只读比对，未修改下载文件、代码、系统数据或业务库。 |
|---|
| | | - **当前运行**：2026-10-08 重启后，已用 `start-dev.ps1` 恢复 dev 环境；前端 `8080`、后端 `8090` 均在监听并访问正常。Git 在本次交接提交前为 `HEAD = origin/main = c7b6553`；工作区无已跟踪改动，只剩约定不入库的 `_tmp_*`、`_tmp_pack_smoke_trend.docx` 和观测站原始 XLS。 |
|---|
| | | - **数据与下一步**：当前业务库仍只覆盖到 `2026-10-06`，`2026-10-07` 未导入。新对话先读 `AGENTS.md` + `HANDOFF.md`；等 10-07 数据齐全后，先只读核对源 Excel 和异常项，得到用户明确指示后再导入或改动，再生成最终走势图和分析报告。折线图横轴仍按已确认的固定 8 天口径，不能改成按年度截断。 |
|---|
| | | |
|---|
| | | ### 10-08：同事分析报告趋势核对（只读，未改动文档） |
|---|
| | | |
|---|
