| | |
| | | > **每天结束时**:把当天进展、踩过的坑、新需求、未完成事项更新到本文件,然后可以放心开新对话。 |
| | | > **协作约定(2026-08-31)**:说「提交」= 本地 commit + 推送到远端 git(origin main,Gitblit),不再只做本地 commit。 |
| | | |
| | | ## 最新(2026-10-07 上午,新开会话交接) |
| | | |
| | | ### 10-07:每日客流构成图右侧标签布局修复(验收通过) |
| | | |
| | | - **问题**:`image13`「每日客流构成变化」右侧外置百分比标签在相邻日期之间重叠 4 处;改为两列后引线交错,个别引线压住绿色块内数值。 |
| | | - **最终规则**:只有色块内放不下的标签进入右侧外置区;外置标签按原始图例序号排序,即道路→铁路→民航→水路;最多 2 列,按“先行后列、每行从左到右”填充;1 个标签整体居中,2 个标签两列各居中,3 个标签下排单标签跨两列居中,4 个标签为 2×2 格居中;两列布局不画引线,颜色对应色块。 |
| | | - **实现**:`HolidayTrendChartService` 将右侧标签带从 74 加宽到 140;`HorizontalStackCallout` 记录原始 `seriesIndex` 并按其排序;仅对每日客流构成图启用两列居中布局;公路出行结构仍走原单列带引线逻辑。 |
| | | - **验证**:真实库只读生成 2026-10-07 走势图;与原版相比 15 张图中仅 `image13` 变化,其余 14 张 SHA-256 完全一致;右侧标签区 OCR 重叠从 4 降为 0;无引线。后端全量 `mvn -q test -f traffic-audit-server\pom.xml` 通过。 |
| | | - **验收**:用户 2026-10-07 验收 `(12).docx` 通过。 |
| | | - **后续**:10-07 数据齐全后,按系统配置的假期天数(7 天)生成最终版走势图,用于分析报告;本轮不调整假日天数来源。 |
| | | - **数据边界**:未导入、覆盖或重导任何业务数据。 |
| | | |
| | | ### 10-07:普通国省道 2025-10-05 调整值更正(已核对) |
| | | |
| | | - **背景**:10-05 剔除 3 个环比降幅超过 50% 的站点(郑店、樊家庄、上津站)和 3 个 10-05 缺失站点(龙泉、华鲁交调站、大典河)。 |
| | | - **站点编号**:郑店 `S101L110420115`、樊家庄 `S120L105420702`、上津站 `G242L104420322`、龙泉 `S216L103420506`、华鲁交调站 `S223L117421024`、大典河 `S464L105422828`。 |
| | | - **各日剔除合计(中小客流量,辆次)**:2026-10-04 `16,484`;2026-10-05 `4,398`;2025-10-05 `14,239`;2024-10-05 `11,907`。调整时缺失站点按 0 处理。 |
| | | - **系统更正**:`holiday_vehicle_adjustment` 的 2025-10-05 调整值已由 `322.7801` 改为 `332.7801`(更新时间 2026-10-07 08:45:52);2024-10-05 `289.5557`、2025-10-04 `337.5009`、2024-10-04 `322.5277` 不变。 |
| | | - **工作簿更正**:`C:\Users\jcxiong\Downloads\2026年十一数据 (4).xlsx`(修改时间 08:46:52)中 `普通国省道!F7=332.7801`。联动结果已正确重算:`普通国省道!G7=-4.8%`;`人员流动量汇总` 的 `E7=1460.97`、`F7=-0.3%`、`K7=1372.85`、`Q7=1290.04`、`R7=-1.0%`、`V7=-4.28%`。 |
| | | - **公式更正已核实**:`普通国省道!E8=(D8-D7)/D7`、`G8=D8/F8-1`、`I8=D8/H8-1`、`E9=(D9-D8)/D8`。 |
| | | - **10-06 边界(重要)**:工作簿目前只有铁路 `C9=96.2`、水路 `C8=5.4932`、高速公路 `C8=206.1206`;民航 `C9`、道路 `C8`、普通国省道 `D8` 仍为空。因此 `人员流动量汇总!C8=596.38264` 只是部分合计,`D8=-59.06%` 以及各 `-100%/#DIV/0!` 都不可用于快报;补齐三项后重算。 |
| | | - **数据边界**:本轮只读核对,未导入、覆盖或重导任何业务数据。 |
| | | |
| | | ### 10-07:Codex 输入卡顿排查与交接建议 |
| | | |
| | | - 当前线程从 10-05 连续使用至今,rollout 约 `32.17 MB`,含 `3,751` 条 `response_item`、`3,469` 条 `event_msg`、`10` 次 compaction;用户已决定新开对话继续。 |
| | | - 已排除 `codex-plus-plus-manager --show-update`(未运行);重试风暴 guard 已安装,`dropped=859` 且连续 10 秒不增长,当前没有持续重试风暴。 |
| | | - 观测到 Codex 主进程累计约 `4.34 h` CPU、渲染进程约 `1.28 h`;短时峰值主进程约 `116%` 单核、渲染约 `44%`,属于间歇高负载。建议新对话继续;若仍卡,完全退出并重启 Codex。 |
| | | - **新对话接手**:先读根目录 `AGENTS.md` + 本文件。当前 git `HEAD` 与 `origin/main` 均为 `9b56330`,已跟踪文件无改动;dev 前端 `8080`、后端 `8090` 正在运行。 |
| | | |
| | | ## 历史(2026-10-07 早间关机快照) |
| | | |
| | | ### 10-07 关机快照 |
| | | |
| | | - **当前状态**:本轮仅做关机交接,无代码、测试口径或业务数据变更。上一任务“折线图纵向间距加高 20%”已于 10-06 验收,提交为 `54e10ae fix(holiday): 加大折线图纵向间距并同步 Word 尺寸`。 |
| | | - **Git**:`main` 的 `HEAD` 与 `origin/main` 均为 `54e10aee11aa4a10926df02782ca07d41eeb9b98`;无未提交的已跟踪文件,工作区仅有按约定不入库的 `_tmp_*` 临时目录/文件、`_tmp_pack_smoke_trend.docx` 和一份观测站原始 XLS。 |
| | | - **运行状态**:关机前本机 dev 前后端仍可访问(前端 8080、后端 8090 均返回 200);随计算机关机会自动停止,重启后按 `AGENTS.md` 用 `start-dev.ps1` 启动。 |
| | | - **本地留存**:折线图纵向间距的测试报告和工作日结已写入 `docs/功能测试报告/`、`docs/工作日结/`,均按约定不入库。 |
| | | - **下次接手**:先读根目录 `AGENTS.md` + 本文件;仓库级待办仍见第七节,本轮无新增待办。 |
| | | - **数据边界**:未导入、覆盖或重导任何业务数据。 |
| | | |
| | | ## 最新(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:往年国省道调整列表补充调整前值 |
| | | |
| | | - **改动**:调整列表接口在同一年份、同一日期、普通国省道口径下,从 `holiday_vehicle_flow` 补返回 `originalValue`;没有原始记录时保持空,页面不显示占位符。表格新增“调整前国省道车流量(万辆次)”,原“调整后国省道车流”改为“调整后国省道车流量”。 |
| | | - **弹窗**:新增/编辑弹窗同步增加只读“调整前国省道车流量(万辆次)”;编辑已有记录时展示 `originalValue`,无原值或新选择日期时不显示内容。切换年份或日期会清空旧原值,避免错日展示。 |
| | | - **随日期刷新**:新增接口 `GET /api/holiday/adjustments/source-value`,按所选年份和日期实时读取普通国省道原值;新增/编辑弹窗选日期后自动刷新,未查到源数据时显示为空。前端用请求序号丢弃迟到的旧请求,避免快速换日期时串值。 |
| | | - **边界**:`originalValue` 只是列表展示字段,标记为 `@TableField(exist = false)`,不写库、不参与调整、环比分母、累计或走势图计算。 |
| | | - **验证**:`mvn -o test` 11 个测试全部通过;`npm run build` 通过;本地重启后只读核对 2025-10-03/04/05 原值分别为 `362.0035/337.9501/334.2040`,无源数据的 2025-10-09 返回空。测试报告:`docs/功能测试报告/功能测试报告_往年国省道调整原值展示_2026-10-06.md`(本地留存,不入库)。 |
| | | |
| | | ### 10-06:方案 D 已实现(往年国省道调整表 + 环比基期只作用于前一日分母) |
| | | |
| | |
| | | 因此 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 位”的既有口径;若领导要求改为一次取整,需要单独改快报百分比路径。 |
| | | - **取整口径(用户 2026-10-06 确认)**:不做“从原始值一次取整”的备选。唯一要求是与 Excel 显示值一致:先按源 Excel 单元格格式生成显示值,再按快报统一 1 位小数。10-04 总计环比原始值约 `4.5481%`,源格显示 `4.55%`,快报取 1 位得到 `4.6%`;这属于既定口径,不是需要修正的边界问题。 |
| | | |
| | | > 说明:本文件早前“环比基期只作备用、不参与计算”的段落已作废。该版本针对的是旧实现误把 C 放到 C 所在日本身计算的问题;自方案 D 起,C 的正确语义是**前一日环比分母的调整值**。 |
| | | |