| | |
|---|
| | | > **每天结束时**：把当天进展、踩过的坑、新需求、未完成事项更新到本文件，然后可以放心开新对话。 |
|---|
| | | > **协作约定（2026-08-31）**：说「提交」= 本地 commit + 推送到远端 git（origin main，Gitblit），不再只做本地 commit。 |
|---|
| | | |
|---|
| | | ## 最新（2026-10-09，zyj 线） |
|---|
| | | |
|---|
| | | ### 10-09：2025 数据现状核验（结论：已在库，无需补录）+ M0 规格补第十二节 |
|---|
| | | |
|---|
| | | - **核验方式**：只读查询库 `127.0.0.1:3308/traffic_audit`（MySQL 8.0.29），未导入、未修改任何数据。 |
|---|
| | | - **2025-01~12 各 12 个月齐全**：`city_bus_monthly`、`city_taxi_monthly`、`wyc_order_monthly`、`wyc_total_monthly`、`h2031_enterprise_monthly`、`h2032_enterprise_monthly`、`passenger_individual_monthly`。 |
|---|
| | | - **两张"不以为缺口"的表**：`freight_turnover_import` 仅 2025-12，但表带 `last_freight_m01..m12` / `last_turnover_m01..m12`，2026 各期文件自带去年同月值；`scale_split_transport` 无 2025，但表带 `above/below/total_yoy`，同比已随 2026 各期入库。 |
|---|
| | | - **修正早前判断**：09-07 方案文档"2025 未入库"的说法已过期（09-16 后补录过多年度数据）；`ReportExportService.java:499 / 558 / 561` 三处"待 2025 年定稿数据导入后自动出现"的提示条件已不成立。同比取数走库内去年同期（`aggOf(data, year-1, m, "湖北省")`，约 540 行）。 |
|---|
| | | - **遗留的是口径问题，不是缺数据**：中口径排名/明细的 2025 列仍以母版静态定稿值为准（`readMidDetailLastYearCumulative`，`ReportExportService.java:2745` 起），注释（2686-2689 行）说明原因是"排名页原先查库现算，两者在 2025-03/04 网约车拆分上不同"。→ 需先做「库内 2025 vs 母版 2025」逐项 diff，交业务确认基准后再决定是否切换读库（切换必须过 diff=0 回归）。 |
|---|
| | | - **规格更新**：`docs/汇总大表M0版式重建器规格_2026-10-06.md` 新增第十二节（三层职责 / 一表一粒度 / 调整值覆盖层 / 2025 实测核验 / 结果层可选 / 「母版不留数据」红线 / 与 M0 的依赖顺序）。 |
|---|
| | | - **状态**：本节与规格第十二节均为【待验收】；未改动代码、未导入数据。 |
|---|
| | | ## 最新（2026-10-06，zyj 线） |
|---|
| | | |
|---|
| | | ### 10-06：拉取合并 + 验收门禁分级 + 汇总大表 M0 立项 |
|---|
| | | |
|---|
| | | - **拉取合并**：`origin/main` 由 `8b739ce` 更新到 `54e10ae`（同事 xyc 38 个提交：节假日专项统计、观测站分日调查导入、v1.0.0 版本管理、打包与 Windows 服务自启等）。本地未推送提交 `ef85b05`（09-29 交接）保留，合并提交 `bee9e18`，无冲突；合并后相对远端的差异正好只有本地的 3 个文件。 |
|---|
| | | - **验收门禁分级（用户 2026-10-06 确认，参考同事做法）**：一般功能 / 修复 / 重构沿用「测试通过即提交推送」；口径类 / 版式类 / 任何会改输出数字或表格版式的改动，照常提交推送，但必须在 HANDOFF 标注 **【待验收】**，用户验收通过后再补一条 `docs(交接): …` 提交改为「已验收（日期）」。规则已写入 `AGENTS.md` 第 5 条。 |
|---|
| | | - **汇总大表 M0 立项（规格待审定）**：新增 `docs/汇总大表M0版式重建器规格_2026-10-06.md`。结论 **不重写**——计算层（`reportexport/calc` 约 900 行）、回填层（`SummaryWorkbookFiller` 899 行）、扩列原语（`moveColumnPair` / `cloneColumnPair` / `cloneCellForMonth` / `cloneMergedRegion` / `copyColumnWidth` / `fixCumulativeFormulas`，`ReportExportService.java:1039-1200`）均已在用；缺口只是把这些原语编排到 10 个需扩列长表页（已列页规格表，约 2.45 万处公式平移）。 |
|---|
| | | - **工作量重估**：M0 约 **3.5–5 天**（含测试与验收），此前 09-29 记的「0.5~1 天」偏乐观，只算了原语复用。 |
|---|
| | | - **卡点未变**：`resolveSummaryMother`（`ReportExportService.java:4576`）只精确匹配《{year}年{month}月道路运输量汇总表.xlsx》，目标月无母版即报错；9 月母版仍为用户 09-29 手工扩列产物（本机未入库）。 |
|---|
| | | - **待确认**：① 扩列蓝本用 9 月手工版还是 8 月版；② 是否一次建成 12 月满版式（方案 v1 建议满版式）。 |
|---|
| | | - **状态**：本段与 M0 规格均为【待验收】；本轮未改动任何代码。工作区未跟踪的 `docs/生成汇总大表/2026年9月道路运输量汇总表*.xlsx` 与 `docs/确认.docx` 按约定保留。 |
|---|
| | | |
|---|
| | | ## 最新（2026-10-06） |
|---|
| | | |
|---|
| | | ### 10-06：折线图纵向间距加高（验收通过） |
|---|
| | | |
|---|
| | | - **用户背景**：客运量图线间距较好、标签摆放合理；其他多序列折线图因线距偏近，标签仍可能压线。用户同意适当增加图高，Word 只是取图来源，不要求当前分页为最终版，但图不能过高。 |
|---|
| | | - **实现**： |
|---|
| | | - `HolidayTrendChartService`：折线纵轴留白收紧为 `lowerMargin=0.04 / upperMargin=0.07`；`LINE_CHART_HEIGHT_SCALE=1.20`，所有折线 PNG 高度放大约 20%。 |
|---|
| | | - `HolidayTrendService`：12 张折线图的 Word 内嵌图片高度同步放大约 20%，保持 PNG 与 Word 图片框比例一致；饼图、堆叠图未改。 |
|---|
| | | - `HolidayTrendChartServiceTest`：新增折线图高度缩放断言。 |
|---|
| | | - **验收**：用户于 2026-10-06 查看 `C:\Users\jcxiong\Downloads\2026年十一假期全省综合运输客流量走势图（折线加高20实验）.docx` 后验收通过。 |
|---|
| | | - **验证结果**： |
|---|
| | | 1. 15% 加高版在铁路客运量图 `image5` 检出 OCR 标签框重叠；20% 版 12 张折线图（`image1/2/4/5/6/7/8/9/10/11/14/15`）未检出标签框重叠。 |
|---|
| | | 2. PNG 宽高比与 Word `wp:extent` 宽高比最大误差约 `0.162%`，未发生明显拉伸。 |
|---|
| | | 3. Word 仍为 8 页、每页 2 张图（首页 1 张），与 15% 加高实验相同。 |
|---|
| | | 4. 后端全量 `mvn -q test -f traffic-audit-server\pom.xml` 通过；`HolidayTrendChartServiceTest` 聚焦测试通过。 |
|---|
| | | 5. 标签亲和度检查记录到 3 处标签框更靠近邻近线（`image1` 的 `1,518.02`、`image4` 的 `1,346.17`、`image9` 的 `248.65`）；白描边保证可读，用户整体验收通过并保留该排版策略。 |
|---|
| | | 6. `image13` 堆叠图有 4 处 OCR 标签重叠，但该图未参与本实验且代码未改。 |
|---|
| | | - **数据边界**：未导入、覆盖或重导任何业务数据；仅本地只读生成走势图做实验。 |
|---|
| | | |
|---|
| | | ### 10-06：平均拥挤度标签恢复为 2 位小数 |
|---|
| | | |
|---|
| | | - **调整**：按用户要求，“普通国省道观测站平均拥挤度”不再单独使用 3 位小数，恢复为折线图默认 2 位。 |
|---|
| | | - **一致性**：由于折线图现已统一按显示标签精度绘制，10-04、10-05 的拥挤度都会显示并绘制为 `0.49`，不会再出现同标签不同高度。 |
|---|
| | | - **验证**：后端全量 `mvn -q test -f traffic-audit-server\pom.xml` 通过。 |
|---|
| | | |
|---|
| | | ### 10-06：折线图统一按显示标签精度绘制 |
|---|
| | | |
|---|
| | | - **口径（用户 2026-10-06 确认）**：同一张折线图中，同一个显示标签必须对应同一个点位高度；分析文字不得引用比该图显示精度更细的差异。 |
|---|
| | | - **实现**：`HolidayTrendChartService.lineChart` 在所有原始统计计算完成后，于最终入图边界调用 `displayValue`；普通图按该图 `valueDecimals` 做 `HALF_UP` 舍入，百分比点标签按 1 位百分比精度（即原始小数 3 位）舍入。折线坐标和点标签共用同一舍入值，纵轴格式沿用该图精度。 |
|---|
| | | - **边界**：只在最终图表显示层舍入，不改数据库、不改累计、快报、同比、环比或调整口径；该规则用于静态分析报告图，不能让文字引用图上无法分辨的微小差异。 |
|---|
| | | - **验证**：`HolidayTrendChartServiceTest` 聚焦测试通过；后端全量 `mvn -q test -f traffic-audit-server\pom.xml` 通过。新增测试覆盖“两个不同原值按 2 位标签舍入后生成相同几何”和百分比精度换算。测试报告：`docs/功能测试报告/功能测试报告_折线图按标签精度绘制_2026-10-06.md`（本地留存，不入库）。 |
|---|
| | | |
|---|
| | | ### 10-06：观测站平均拥挤度走势图改为 3 位小数 |
|---|
| | | |
|---|
| | | - **问题**：用户导入 10-05 观测站数据后反馈，最后一张拥挤度图中 10-04、10-05 标签都显示 `0.49`，但点位高度不同。 |
|---|
| | | - **根因**：平均拥挤度原值分别为 `0.490890014472` 和 `0.492414492754`，折线按未取整原值绘制，标签原为最多 2 位小数，导致标签精度与图形精度不一致，不是日汇总或点位计算错误。 |
|---|
| | | - **修正**：`HolidayTrendChartService.lineChart` 新增可选 `valueDecimals`，默认仍为 2；仅“普通国省道观测站平均拥挤度”图传 3 位。10-04、10-05 现在分别显示 `0.491`、`0.492`，其余图口径不变。 |
|---|
| | | - **验证**：后端全量 `mvn -q test -f traffic-audit-server\pom.xml` 通过；重启后只读生成新 DOCX，OCR 标签为 `0.504/0.476/0.467/0.491/0.492`；与用户提供的文档逐图比对，15 张图中仅拥挤度图 `image15` 变化，其他 14 张 SHA-256 完全一致。测试报告：`docs/功能测试报告/功能测试报告_拥挤度走势图精度_2026-10-06.md`（本地留存，不入库）。 |
|---|
| | | - **数据边界**：未导入、覆盖或重导任何业务数据。 |
|---|
| | | |
|---|
| | | ### 10-06：往年国省道调整列表补充调整前值 |
|---|
| | | |
|---|
| | |
|---|
| | | - 结果：按当前母版重新生成 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`。 |
|---|
| | | - **09-29：用户手工改母版（仅格式 + 删除草稿），并立项母版扩列器** |
|---|
| | | - 用户说明本次母版改动仅"调格式 + 删草稿"，未动业务口径；指纹变化缓存自动失效，已重新生成核对：需处理 2 条 → `城市汇总!G20` 按"以用户手工改动为准"登记为**已知差异(用户手工改动)**（工具新增 `USER_EDITS`）；剩 `班线包车!EO6` = `#DIV/0!`（WPS 保存重算产生，待定留白）。 |
|---|
| | | - **母版扩列器（方案 B）**：复用 `cloneColumnPair/moveColumnPair/cloneCellForMonth/cloneMergedRegion/copyColumnWidth/fixCumulativeFormulas` 与 `SummaryWorkbookFiller.ensureMonth*`；需新写"扩列编排 + 每页规则配置 + 回归自检"。**当年内每期一键、跨年加一次性"新年块"逻辑**；首次估 0.5~1 天。等同事确认后先出《19 页扩列规格表》。 |
|---|
| | | - 运行状态：后端 8090 / 前端 8080 已由 `start-dev.ps1` 启动。 |
|---|
| | | - 用户母版改动尚未提交，待确认后与扩列器一起提交。 |
|---|
| | | - **待办**：① 排名页结构（块顺序、标题措辞、市州名短名/全名、周转量排名多 7 行）；② 排名页结构（块顺序、标题措辞、市州名短名/全名、周转量排名多 7 行）；③ 缺 2026-09 母版、导出前基数体检（P0-3）。 |
|---|
| | | |
|---|
| | | ## 最新（2026-09-27） |
|---|
