| | |
|---|
| | | - **正常导入口径**：只读取所选年份的当年列（2026 年铁路/民航/道路/水路为 C 列、高速为 C 列、普通国省道为 D 列）；同时只额外读取当前年份铁路/民航的“前一日”行。2019/2024/2025 历史列不参与导入。 |
|---|
| | | - **快报口径**：同比只使用 2025、2024；假期第 1 日的铁路、民航环比使用“前一日”数据，公路、水路、总计及其他口径第 1 日仍显示“—”；第 2 日起正常计算环比。 |
|---|
| | | - **迁移脚本**：`docs/sql_holiday_previous_day_migration.sql`，部署包同步为 `deploy-templates/db/sql_holiday_previous_day_migration.sql`，脚本可重复执行。 |
|---|
| | | - **2019 显示补齐（10-03 晚追加）**：`holiday_calendar` 增加 2019-10-01 至 2019-10-08 配置；系统配置-节假日管理和专项统计-节假日均增加 2019 年份，历史库执行幂等迁移后即可查看 2019 年 8 天道路数据。 |
|---|
| | | - **验证（本机 3305 库 + 真实模板）**：接口导入结果 `passengerRows=10, vehicleRows=4, successRows=14, failRows=0`；数据库抽查 2026-09-30 铁路=82.1、民航=6.6994，2026-10-01 铁路=113.8、民航=6.7482、道路=78.82、水路=1.311，2026-10-02 铁路=82.0、民航=6.3914、道路=75.61、水路=3.3373；2026-10-01 快报铁路环比=+38.6%、民航环比=+0.7%，总行环比为“—”；2026-10-02 铁路环比=-27.9%、民航环比=-5.3%。 |
|---|
| | | - **运行状态**：后端 8090（重启后已加载新代码）、前端 8080 均在运行；访问 `http://localhost:8080`。 |
|---|
| | | |
|---|
| | | ### 10-03 深夜：快报表格百分比与模板样式修复（已验收） |
|---|
| | | - **问题**：生成快报表格使用“增长/下降”文字，数字拆行并多出 1 页；复核发现模板路径正确，根因是 `HolidayBulletinService#setCellText` 替换单元格时只保留段落属性，未保留模板 run 的字体/字号属性。 |
|---|
| | | - **口径**：表格环比/同比改为带符号一位小数（正数不加 `+`，负数保留 `-`），零或一位小数后为零显示 `0%`，缺失/基数为空或为零显示 `—`；正文继续使用“增长/下降”。 |
|---|
| | | - **修复**：单元格替换时继承模板 `rPr`；新增 `HolidayBulletinServiceTest` 覆盖正数、负数、零、四舍五入为零、缺失和零基数。 |
|---|
| | | - **验证**：Maven 编译和测试通过；重新生成 2026-10-01 快报，正文仍为“增长2.3%”且不含“增长了”；Word 导出由 2 页恢复为 1 页，数字不再拆行。最终样报见本地 `_tmp_holiday_verify/bulletin_final_signed_styled_2026-10-01.docx`。 |
|---|
| | | - **状态**：2026-10-03 用户验收通过；本次提交只包含代码、回归测试和本交接记录，不包含 `_tmp_*` 过程产物及用户未提交的数据文件重命名。 |
|---|
| | | |
|---|
| | | ### 10-03 深夜（2）：缺当日民航数据时的累计同比对比期间修正 |
|---|
| | | - **快报民航累计同比对比期间修正（2026-10-03，缺当日民航数据场景）**：当某运输方式当年累计覆盖的日期短于所选日期（典型为 10 月 2 日民航数据未出、民航累计只有 10-01），累计同比改为「只和往年已经覆盖到的日期比较」——先找当年最后一个有该指标数据的日期，再取往年同日累计。修复后缺失民航的 10 月 2 日快报民航累计同比由 `-50.5%/-49.9%` 变为 `-10.0%/-0.9%`（与手工稿 -10.03%/-0.87% 的 1 位小数值一致）。实现见 `HolidayBulletinService.comparableCumulative`（仅作用于民航行），其余行与总人员流动量口径不变。 |
|---|
| | | - **「累计同比 -4.65% vs 快报 -4.6%」结论（2026-10-03，无需改代码）**：Excel 显示的 -4.65% 是**两位小数**结果；底层精确比值是 `-4.64633%`（2026 累计 3082.23818、2025 累计 3232.42742），**一次四舍五入到 1 位小数就是 -4.6%**。把已经取到两位小数的 -4.65 再取一位才得到 -4.7，属二次取整，不采用。同理 2026 对 2024 为 `-1.7710%` → `-1.8%`。快报百分比统一 1 位小数口径不变。 |
|---|
| | | - **「暂缺民航」提示**：用户确认由人工在生成的快报稿上修改，系统不生成该提示行，**不做代码改动**。 |
|---|
| | | - **验证**：`HolidayBulletinServiceTest` 3 个用例通过（新增 2 个覆盖民航累计对比期间与无数据返回 null）；端到端用库内真实 2026-10-02 数据（铁路/道路/水路/车流齐全、缺民航）重新生成快报，民航累计同比 `-10.0%/-0.9%`、民航累计 `6.75`、总计累计 `3082.24`、总计累计同比 `-4.6%/-1.8%`，与手工稿口径一致。 |
|---|
| | | - **Git**：本次改动待用户「验收通过」后再提交/推送。 |
|---|
| | | |
|---|
| | | ### 10-03 深夜（3）：快报累计正文单位由「亿人次」改「万人次」（待验收） |
|---|
| | | |
|---|
| | | - **口径（用户/领导确认）**：假期累计数值目前偏小（0.31 亿），正文可读性差，改为与当日一致的**万人次**；例如 `假期以来，全省全社会跨区域人员流动量累计3088.63万人次`，不再输出「0.31亿人次」。表格与其余口径不变。 |
|---|
| | | - **实现**：`HolidayBulletinService` 抽出 `cumulativeParagraph(...)`，直接按万人次（2 位小数）输出累计值；同比仍为「增长/下降 + 一位小数」，**保持一次取整不变**（总计累计同比 2025 精确 -4.4486% → `-4.4%`；手工稿的 -4.5% 属二次取整，不采用）。 |
|---|
| | | - **验证**：`HolidayBulletinServiceTest` 4 个用例通过（新增 `cumulativeParagraphUsesWanUnitAndSingleRounding` 固化「万人次 + 一次取整」）；重启后端后重新生成 2026-10-02 快报，正文为 `累计3088.63万人次，比2025年同期下降4.4%，比2024年同期下降1.6%`，与手工稿仅差既定的取整口径；2026-10-01 回归正常（`累计1643.17万人次`）。 |
|---|
| | | - **状态**：待用户「验收通过」后提交/推送。 |
|---|
| | | |
|---|
| | | ### 10-03 晚（4）：新增「观测站分日调查数据」原始数据导入（待验收） |
|---|
| | | - **背景（用户 2026-10-03 提出）**：普通国省道车流量的来源之一是观测站分日调查数据（模板 `docs/专项统计/重要节假日/观测站分日调查数据 (2026年10月1日).xls`，其中字段「中小客流量」即普通国省道车流量来源）。**系统内不做关联**，节假日统计仍走原有导入；本功能只做原始数据留存，为后续分析挖掘积累数据基础。 |
|---|
| | | - **数据表**：新增 `observation_station_flow`，DDL 见 `docs/sql_observation_station.sql`，部署包同步为 `deploy-templates/db/sql_observation_station.sql`。保留模板全部 26 列（观测站编号/名称/观测里程/地市/区县/行驶方向 + 各车型流量 + 客车/货车/汽车/机动车流量 + 各类当量 + 机动车速度 + 拥挤度 + 来源文件名）。唯一键 `(obs_date, station_code, direction)`；**数值列一律 `DECIMAL(30,15)`**，Java 实体字段一律 `BigDecimal`，与节假日表同口径，无 float/double。 |
|---|
| | | - **导入实现**：新增包 `com.trafficaudit.observation`（entity / mapper / dto / service / controller）。用 POI `WorkbookFactory` 同时支持 `.xls` 和 `.xlsx`；**表头按列名匹配**（列顺序变化不影响导入），扫描前 10 行定位表头；日期兼容 Excel 日期格式与 `yyyy-M-d`/`yyyy/M/d`/`yyyyMMdd`/中文年月日；同一日期**重复导入即整体覆盖**（先删该日期再插入），幂等。 |
|---|
| | | - **接口**：`POST /api/observation/import`、`GET /api/observation/dates`（按日期汇总站数、中小客流量合计、最近导入时间）、`GET /api/observation/rows?date=&limit=`、`POST /api/observation/delete?date=`。 |
|---|
| | | - **前端**：`traffic-audit-web/src/views/HolidayStat.vue`（专项统计 - 节假日）新增「观测站分日调查数据」卡片：选择文件 → 导入 → 按日期汇总表 → 查看明细（弹窗）→ 删除。 |
|---|
| | | - **实测（真实模板，本机 3305）**：导入 692 行 / 692 站 / 0 跳过 / 0 失败；三项合计与源文件逐项一致（中小客流量 3,523,873、机动车流量 5,487,965、机动车当量 7,140,575）；**692 行 × 25 字段全量逐行比对 0 处不一致**；中文（站名/地市/区县）落库无乱码；重复导入仍为 692 行（覆盖而非累加）；上传非 Excel 返回明确错误。旁证：692 站中小客流量合计 3,523,873 辆 = 352.3873 万辆，与 2026-10-01 节假日「普通国省道」入库值完全一致，印证了数据来源关系。 |
|---|
| | | - **顺带修复**：`pack-deploy.ps1` 把 db 脚本复制进包内 docs 的清单里漏了 `sql_holiday_previous_day_migration.sql`，本次一并补上 `sql_observation_station.sql`；`deploy-templates/README-部署说明.txt` 的 db 清单同步更新。 |
|---|
| | | - **10-03 深夜追加（观测站界面微调）**：①「查看」明细弹窗按模板表头展示原始数据全部字段（观测日期/站号/站名/里程/地市/区县/方向 + 全部车型流量、客货汽车机动车流量、各类当量、速度、拥挤度，另附来源文件名，共 27 列，横向滚动）；②汇总表「中小客流量合计」单位由辆次改为**万辆次**、保留 4 位小数（`formatWanVehicles`，如 3,523,873 → 352.3873）。前端 dev server 已热更新编译通过。 |
|---|
| | | - **10-03 深夜追加（观测站列表/明细修正）**：①**明细行序**原来按 `stationCode` 排序，与 Excel 行序对不上，改为按导入顺序（`id ASC`，即 Excel 行序），便于逐行比对；②明细**列顺序**与模板 26 列完全一致（末尾附来源文件名）；③**观测里程/机动车速度/拥挤度**改为按原始小数显示（`formatPlain`，去尾零，如 50.92 / 43.882 / 0.777 / 58），不再固定 2 位；④**17 个流量与当量列**改为整数显示（`formatInteger`，如 6413），与 Excel 一致；⑤汇总列表「观测日期」改为**正序**（mapper `ORDER BY obs_date ASC`）。已用 10-01/10-02 真实数据验证行序与 Excel 前 5 行一致（中帮/万店/沼山站/邾城站/白云）。 |
|---|
| | | - **状态**：待用户「验收通过」后提交/推送。 |
|---|
| | | |
|---|
| | | --- |
|---|
| | | |
|---|
| | |
|---|
| | | - **2026-08-28 复核「点数据导入浏览器崩溃」（打包测试环境，部分用户）**：重点排查 `GET /api/import/batches`——后端 limit 上限 200；全表 81 条、error_detail 最长 2.6KB、全量响应约 17KB（前端只取 50 条）；前端表格仅 8 列短字段（errorDetail 不渲染）、无轮询/定时器。**结论：接口不是崩溃根因**（若接口有问题，所有用户都会崩，而非"部分用户"）。现象符合客户端环境差异（第三方扩展注入/旧显卡驱动/低配内存，与 08-27 迅雷扩展+Intel 旧驱动结论一致）。建议对崩溃用户依次验证：无痕模式→换 Edge→禁扩展，并看 chrome://crashes。 |
|---|
| | | - 【新需求·仅记录未实现·2026-08-28】增加**经济指标试算功能**：领导非常关注经济指标，**货运是大头**；常驻现场的所有人都要会计算货运相关数据（货运量/周转量等）。领导经常要求把某个数据「压一压」，今后考虑在软件里增加试算功能——可按需要调整/测算指标数值（如模拟下调某企业/某口径的货运量后看汇总与趋势影响），辅助现场人员快速试算与应对。 |
|---|
| | | |
|---|
| | | - 【待办·2026-10-03】**数值精度统一改造**：把既有业务表的数值列由 `double` 改为 `DECIMAL(30,15)`，Java 实体字段由 `Double/Float` 改为 `BigDecimal`，与节假日表、观测站表统一口径（用户 2026-10-03 明确要求，择机实施）。 |
|---|
| | | - 现状盘点（traffic_audit，2026-10-03 查询）：**16 张表、共 228 个 double 列**——`freight_turnover_import` 48、`city_bus_monthly` 34、`h2032_enterprise_monthly` 33、`city_taxi_monthly` 29、`wyc_order_monthly` 22、`h2031_enterprise_monthly` 18、`h204_vehicle_quarterly` 12、`scale_split_transport` 9、`investment_monthly` 5、`investment_system` 5、`wyc_total_monthly` 4、`h204_auth_vehicle` 2、`investment_project` 2、`passenger_individual_monthly` 2、`transport_auth_vehicle` 2、`vehicle_track_mileage` 1。 |
|---|
| | | - 已是 decimal 口径、无需改动：`holiday_calendar` / `holiday_passenger_coefficient` / `holiday_passenger_flow` / `holiday_vehicle_flow` / `observation_station_flow`。 |
|---|
| | | - 改造范围不只是改列类型：实体类字段类型、导入解析（不要经 double 中转）、计算与取整逻辑、报表导出格式化，以及存量数据的迁移脚本，都要一起改；改完要做逐表数值抽查。 |
|---|
| | | |
|---|
| | | ## 八、每日交接约定 |
|---|
| | | 1. 新对话第一步：读 `AGENTS.md` + `HANDOFF.md`；涉及 AI 分析/审核时参考 `docs/` 与数据库表结构。 |
|---|
| | | 2. 每天结束时：更新 `HANDOFF.md`（进展、坑、新需求、待办），再关对话。 |
|---|
