功能测试报告_重要节假日专项统计_2026-10-02

一、功能说明

新增“专项统计-重要节假日”模块，覆盖以下能力：

1. 系统配置菜单新增“节假日管理”和“客运系数管理”，仅 admin 可维护。
2. 节假日管理字段：年份、节假日分类（春节/五一/十一）、日期、第几日。
3. 客运系数管理字段：年份、日期分类（节假日/非节假日）、客运系数。
4. 专项统计-节假日菜单支持按年份、节假日分类查看客流与车流综合数据。
5. 支持导入《2026年十一数据.xlsx》模板，按所选年份读取当年列（2026 年为客流 C 列、普通国省道 D 列），按“第几日”写入当年客流和车流；2024/2025 历史数据仅首次初始化，不要求日常重复导入。
6. 导入时先检查“比本次最新导入日更早”的历史日期是否被改动；如有变化，先不写库并列出差异，由用户选择是否允许覆盖。
7. 支持导出 Excel，模板为《2026年十一数据.xlsx》。
8. 支持下载《湖北省国庆假期综合运输客流快报（10月X日）.docx》，默认日期为系统日期前一天，也允许用户自选日期；环比、同比按“增长/下降/持平”输出。
9. 应用首次启动时，从模板工作簿初始化 2024/2025 年十一客流、车流，以及 2024-2026 年客运系数。

二、测试环境

三、用例表

四、发现的问题与处置

1. 模板下载整段路径使用 encodeURIComponent，把 / 编码为 %2F，Tomcat 返回 400。

• 处置：前端改为按路径段编码，保留斜杠，复测返回 200。

1. 导入原先没有历史数据变更确认，可能静默覆盖已发布历史日。

• 处置：新增两阶段导入；未确认时零写入，确认后才允许覆盖历史日。

1. 快报生成服务原先把当前 DOM 文档放在实例字段，存在并发串扰风险。

• 处置：改为 ThreadLocal 保存当前文档，并在请求结束时清理；重启后复测连续生成通过。

1. 导入接口不传文件时由框架抛出 500。
2. 节假日初始化每次启动都会补齐缺失的第 N 日，导致 admin 删除 2026-10-08 后，重启又被自动插回。

• 处置：文件参数改为可选，统一返回业务 400 提示。
• 处置：seedNationalDayCalendar() 改为仅在 holiday_calendar 整表为空时执行首次初始化；非空配置完全由 admin 维护。复测重启后 2026 年十一保持 7 天。

五、数据清理

• 测试中产生的 2026 客流/车流临时数据已删除。
• 测试产生的 import_batch 节假日导入记录已删除。
• 2024/2025 初始化数据和 2024-2026 客运系数保留，符合需求。

六、结论

重要节假日专项统计模块的正向流程、权限控制、数据初始化、导入导出、快报生成和前端页面烟测均通过；源工作簿 90 个数据单元格入库抽查无差异。发现的问题已修复并完成回归，当前后端 8090、前端 8080 正常运行。

七、补充回归（2026-10-02，Excel 浮点精度与菜单顺序）

背景：Excel 内部按 IEEE 754 双精度浮点存储数值（有效 15 位），库内客运系数原为 2.3999999999999995，页面显示异常。参考 docs/Excel浮点数存储.txt 全面整改。

修改内容：

1. 新增数值工具 HolidayNumberUtils：Excel 单元格数值统一用 NumberToTextConverter.toText(double) 转文本再入 BigDecimal，计算使用 MathContext(15, HALF_UP)，与 Excel 15 位有效数字保持一致。
2. 节假日模块实体、服务、导入导出、快报统一由 Double 改为 BigDecimal。
3. 三张表数值列改为 DECIMAL(30,15)：holiday_passenger_flow.passenger_count、holiday_vehicle_flow.vehicle_count、holiday_passenger_coefficient.coefficient；迁移脚本 docs/sql_holiday_decimal_migration.sql。
4. 库内 6 条客运系数（2024-2026 年、节假日/非节假日）由 2.3999999999999995 校正为 2.4。
5. “专项统计”菜单移动到“报表生成”之后；前端客运系数展示统一去除浮点尾差。

验证结果：

• mvn -q -DskipTests compile 通过；npm run build 通过（仅原有 bundle 体积警告）。
• 菜单顺序实测：报表生成 -> 专项统计 -> 规则管理 -> 用户管理 -> 系统配置。
• 系统配置-客运系数管理列表浏览器实测显示 2.4；接口 coefficient=2.4。
• 三张表数值列均为 decimal(30,15)。
• 历史变更两阶段导入回归：不确认时零写入并列出 6 条差异，确认后第1日由 100/100/100/100/200/300 覆盖为 110/110/110/110/210/310，第2日不变。
• 导入口径复核：仅写入所选年份当年列（本用例 12 条），2024/2025 历史列与客运系数列不读不入库。
• 测试产生的 2026 客流/车流及 import_batch 记录已清理；2024/2025 历史数据与 2024-2026 客运系数保留。
• 页面表头补单位（浏览器实测）：铁路/民航/道路/水路（万人次）、高速车流/国省道车流（万辆次）、非营业性人员流动量/总人员流动量（万人次）；客运系数保留无单位。

八、补充回归（2026-10-02，节假日删除后重启复活）

现象：admin 已在系统配置中删除 2026-10-08，但后端重启后该行再次出现。

根因：HolidayReferenceDataInitializer 在每次应用启动时调用 seedNationalDayCalendar()，原逻辑按固定天数遍历并补齐所有缺失的第 N 日，因此把 admin 已删除的日期重新插入。

修复与验证：

• HolidayWorkbookService.seedNationalDayCalendar() 增加非空保护：节假日表只要已有任一配置，就不再进行自动补种。
• 后端编译通过，重启后数据库 2026 年十一为 2026-10-01 至 2026-10-07 共 7 天。
• 接口验证：节假日配置 7 条，统计一览 7 行，最后一日 dayIndex=7、date=2026-10-07。

九、补充回归（2026-10-02，普通国省道环比基期）

背景：普通国省道 C 列为“环比基期”。当普通国省道流量趋势与高速公路不一致时，以高速为准，手工填写基期，环比按 当日 / 环比基期 - 1；未填写时仍按 当日 / 前一日 - 1。

实现口径：

• holiday_vehicle_flow 新增可空字段 comparison_base DECIMAL(30,15)，迁移脚本 docs/sql_holiday_comparison_base_migration.sql。
• 仅 2026 年启用：2024、2025 历史数据不导入、不导出、不参与基期计算。
• 2026 年普通国省道 C 列导入为 comparison_base，D 列导入为 vehicle_count；导出时 C/D 列分别回填。
• 基期只影响普通国省道车流量自身的环比：有基期时 当日 / 基期 - 1，无基期时 当日 / 前一日 - 1。
• 折算人员流动量、公路人员流动量、非营业性人员流动量、全社会人员流动量和 Word 快报继续按 Excel 原有公式计算，不受基期影响。
• 导出时如某日填写基期，普通国省道 E 列公式写为 =(D-C)/C。
• 基期改变同样纳入历史日期变更检查，用户确认前不写库。
• 快报第1天没有前一日可比基数，正文不输出“环比增长/下降/持平”短语；表格当日环比列为“—”。第2天起仍按实际前一日计算并输出环比。
• 快报中的同比/环比百分比统一保留1位小数（四舍五入）；人次、车流等业务数值仍保留2位小数。