交通统计审核
编辑 | blame | 历史 | 原始文档

工作日结_2026-10-02

一、今日完成

  1. 新增“专项统计-重要节假日”完整模块。
  • 后端新增 4 张表：节假日配置、营业性客流、非营业性车流、客运系数。
  • 后端新增节假日配置、统计、工作簿导入导出、Word 快报服务。
  • 前端新增“专项统计-节假日”和“系统配置”菜单/页面。
  1. 权限控制已实现。
  • 节假日管理、客运系数管理仅 admin 可维护，非 admin 返回 403，菜单隐藏且直访重定向。
  1. 模板初始化已实现。
  • 从《2026年十一数据.xlsx》初始化 2024/2025 年十一客流和车流。
  • 从同一工作簿初始化 2024-2026 年客运系数。
  1. 导入导出已实现。
  • 导入仅读取所选年份的当年列（2026 年为客流 C 列、普通国省道 D 列），历史 2024/2025 数据只做初始化，不要求日常重导。
  • 导入按“年份 + 节假日分类”匹配“第N日”，覆盖写入客流与车流。
  • 导入前检查更早的历史日期是否被改动；有变化时先不写库并列出差异，用户确认后才允许覆盖。
  • 导出以源工作簿为模板，回填数据库数据并保留公式。
  1. 快报已实现。
  • 下载文件名：湖北省国庆假期综合运输客流快报（10月X日）.docx。
  • 环比/同比文案按正数增长、负数下降、0 持平输出，百分比保留1位小数。
  1. 文档已同步。
  • 更新 docs/sql_holiday.sql、docs/init.sql、docs/database.md、docs/打包部署说明.md。
  1. Excel 浮点精度整改（2026-10-02 追加）。
  2. 节假日删除后重启复活修复（2026-10-02 追加）。
  3. 普通国省道环比基期（2026-10-02 追加）。
  • 普通国省道 C 列确认为“环比基期”：填写后按“当日/环比基期-1”计算环比，未填写时仍按“当日/前一日-1”。
  • holiday_vehicle_flow 新增 comparison_base 字段；仅 2026 年导入、导出和参与计算，2024/2025 历史数据不使用。
  • 按 Excel 原公式口径，基期只影响普通国省道车流量自身环比；折算人员流动量、公路人员流动量、总人员流动量和 Word 快报均不受影响。
  • 基期变化仍纳入历史日期变更确认；导出时对应日 E 列公式改为 (D-C)/C。
  • 快报第1天正文不输出“环比增长/下降/持平”短语，表格环比列为“—”；第2天起保留环比。
  • 快报同比/环比百分比改为保留1位小数；人次、车流等数值仍保留2位小数。
  • 原逻辑每次启动都会补齐缺失的第 N 日，导致 admin 删除 2026-10-08 后重启被重新插入。
  • 修复为仅当 holiday_calendar 整表为空时执行首次初始化；复测重启后 2026 年十一保持 7 天。
  • 新增 HolidayNumberUtils，Excel 数值统一用 NumberToTextConverter.toText(double) 转 BigDecimal，计算用 MathContext(15, HALF_UP)。
  • 节假日模块实体/服务/导入导出/快报由 Double 改为 BigDecimal；三张表数值列改为 DECIMAL(30,15)；库内 6 条客运系数由 2.3999999999999995 校正为 2.4。
  • “专项统计”菜单移到“报表生成”之后；前端系数展示去除浮点尾差。

二、测试结果摘要

  • 后端编译通过，前端生产构建通过。
  • 源工作簿与数据库抽查：90 个单元格，差异 0。
  • 权限、正向 CRUD、负向导入、历史数据变更确认、Excel 导出、Word 快报、页面烟测全部通过。
  • 历史变更端到端实测：未确认时数据不落库，确认后历史日值按导入文件更新；测试数据已清理。
  • 无头浏览器烟测：admin 页面正常，非 admin 系统配置隐藏并重定向，模板下载 HTTP 200，无 JS 错误。
  • 精度回归：系统配置-客运系数列表与节假日统计页均显示 2.4，接口 coefficient=2.4，三张表数值列为 decimal(30,15)。
  • 菜单回归：侧边菜单顺序为 报表生成 -> 专项统计 -> 规则管理 -> 用户管理 -> 系统配置。
  • 历史变更两阶段导入回归：不确认时零写入并列 6 条差异，确认后第1日覆盖为 110/110/110/110/210/310，第2日不变；导入口径仅读当年列。
  • 页面表头补单位：节假日数据一览列头已带单位（万人次/万辆次），浏览器实测通过。
  • 删除复活回归：admin 删除 2026-10-08 后重启，数据库 7 天、统计接口 7 行，最后一日为 2026-10-07，未再自动补回。
  • 环比基期回归：导入 C=320、D=360 后库内和接口均正确；国省道车流环比为 12.50%，导出 E 列公式为 (D-C)/C；快报总人员流动量仍为 17.00%、未受基期影响；历史基期变化返回确认提示且未写库；2024/2025 导出 C 列保持为空。
  • 快报首日回归：2025-10-01 正文无“环比”短语，仅保留同比；2025-10-02 仍输出“环比下降11.5%”。
  • 快报百分比精度回归：正文和表格同比/环比均为1位小数，如6.79%显示6.8%、11.46%显示11.5%；人数1714.41/1518.02仍保留2位小数。
  • 测试报告：docs/功能测试报告/功能测试报告_重要节假日专项统计_2026-10-02.md。

三、遗留问题与待办

  1. 真实 2026 年十一数据尚未导入；页面默认快报日期为系统日期前一天，当前系统日期 2026-10-02 时默认取 2026-10-01，用户也可手工选择日期。
  2. 春节、五一目前提供了配置分类和通用表结构，但未提供初始化数据，需要后续按对应年度维护。
  3. 快报模板固定为国庆版本，其他节假日如需快报需另提供模板。
  4. 正式发布前仍需确认验证码开关等上线配置。

四、明日计划

  1. 根据用户提供的 2026 年十一每日数据，指导或执行导入并核对生成快报。
  2. 如用户提供春节、五一日期和模板，继续扩展对应初始化与快报模板适配。
  3. 根据试用反馈微调页面展示和导出格式。

五、运行状态

  • 后端：8090 已启动，日志出现 Started TrafficAuditApplication。
  • 前端：8080 已启动，访问 http://localhost:8080。
  • 数据库：127.0.0.1:3305/traffic_audit。