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

功能测试报告_中口径排名左块删除与7月回归收口及8月扩列_2026-09-08

一、功能说明

  1. 按 2026-09-08 业务拍板（《确认回执汇总…》第六节第 6 条）：删除汇总大表 中口径排名 页 r1-20 左块（A..H，陈旧当月数据：A=2026-01 客运量、E=2026-02 周转量，无期次标题），页内仅保留两张可见表：r1-20「1-7 月累计」与 r22-41「7 月当月」（均在 J..R）。
  2. 程序侧同步：ReportExportService.restoreSummaryMonthlyBlocks 对 中口径排名 页 A..H（0-based 0-7 列）**永不从备份母版回填**，杜绝“母版删了、一生成又复活”。
  3. 7 月回归收口（含排名页左块删除一起验）；通过后再扩 8 月母版（M0 版式重建器 v4）。

二、测试环境

  • 母版：docs/生成汇总大表/2026年7月道路运输量汇总表.xlsx（清理后骨架）与 _备份_2026年7月道路运输量汇总表_清理前_20260904.xlsx（完整 7 月，还原源）。
  • 生成链路：后端 mvn spring-boot:run（8090），接口 GET /api/report/export/summaryWorkbook?period=2026-07|2026-08&mode=month。
  • 校验工具：openpyxl 内容级 diff（data_only=False 双读）、mvn -DskipTests compile。

三、用例表

# 用例 输入/操作 预期 实际 结论
1 母版删除左块 7 月母版 中口径排名 A1:H20 清空 + 移除 A1:H1/A22:H22 合并 仅 J1:R1、J22:R22 保留合并；A..H r1-20 无内容 清 148 格；合并仅剩 J1:R1/J22:R22；整簿 diff 仅此区 通过
2 程序不回填左块 后端生成 2026-07 汇总表（走还原逻辑） 生成物排名页无 A..H 陈旧块 生成物 vs 备份母版 diff=179，其中 148=左块删除（预期）、31=日期列 int/float 写法（显示相同） 通过
3 7 月 M1 数值回归 货运/公交出租轨道/网约/城市汇总/班线包车脚本复跑（库 2026-01~07） 各页与母版缓存 0 差异 freight/pax/wyc/urban/mid 全 diffs=0 通过
4 Java 编译 mvn -q -DskipTests compile 无错误 exit=0 通过
5 8 月扩列（v4） 修正后 7 月整本 → 8 月母版 2026年8月道路运输量汇总表.xlsx 8 个台账/合成页 +2 列（2026年8月/8月同比），累计滚动，2025 参照右移 8 页 maxCol +2；累计 +Q、同比分母 +AJ；7→8 月数值格 2387 个 0 差异 通过
6 扩列版式细节 新 8 月两列表头、隐藏列、排名页 两行纵向合并表头；隐藏列平移保留；排名页无左块 Q/R 表头与 15/16 列同款合并（各页行位正确）；隐藏列按 >=17 +2 保留；排名页仅 J 系合并 通过
7 程序读新 8 月母版 后端生成 2026-08（POI 读母版） 不报 Zip-bomb、输出=母版 styles.xml 比值 0.0099 触发 POI 误报→ZipSecureFile.setMinInflateRatio(0.0001) 后修复；生成物与 8 月母版内容 diff=0 通过

四、发现的问题与处置

  1. POI Zip-bomb 误报：openpyxl 重写后 styles.xml 压缩比 0.009988 < 0.01，POI 拒读新版 8 月母版。处置：exportSummaryWorkbook 读母版前临时调低阈值（0.0001）并在 finally 还原，仅影响本方法读取内部模板。
  2. 历史遗留：8 月版式原型（v3 产出）的新 8 月列无两行合并、隐藏列标记丢失、以“清理前备份”为源会带回排名左块；v4 修正源为“已删左块的 7 月生成物”并补两行合并与隐藏列平移。
  3. 本版 8 月母版 2026 组累计公式已滚动至 1-8 月（+Q/+AJ），但 8 月当月值仍为空，待 8 月数据导入后由 M2/M3 填值。

五、结论

  • 中口径排名左块删除在母版与程序生成链路均生效；7 月回归收口通过（排名页随同验证无左块、其余页与库 0 差异）。
  • 8 月扩列母版已生成并通过程序端到端读取验证，可作为后续 8 月数据填充的母版。
  • 遗留：M2 SummaryFiller / M3 8 月实弹（导数后填 2026-08 当月值）、母版缓存校验走 Q1 口径。