# 功能测试报告_汇总大表8月数据回填与版式对齐_2026-09-11

## 一、功能说明
针对用户反馈的 4 个问题，对《道路运输量汇总表》导出链路做数据驱动回填与版式对齐：

1. **8 月数据已入库但汇总表没有 8 月数据** → 汇总工作簿填充器识别「当月值列」（8 月为 Q 列）并回填；
2. **同比一律以汇总表 2025 年 8 月数据为准** → 当月同比列（R 列）公式统一为 `=Q../AJ..-1`，AJ 列即 2025 年 8 月；
3. **公交、出租数据是日期形式** → 回填数值时按同行 1 月列样式套用，避免数值被套上日期格式（显示成 1902/1910 年）；
4. **班线包车、轨道轮渡只有分市州没有全省数据** → 为全省行补齐合计公式（母版原本只对 1 月写死公式）；
5. **版式完全按《生成_道路运输量汇总表.xlsx》** → 逐列套用参照件列宽/隐藏标记，**后续扩列（8 月 Q/R 列）也按参照件宽度**。

改动范围：
- `SummaryWorkbookFiller`：`fillFreightSheet` / `fillWycSheet` 重写（只回填目标期当月，派生行保持公式）；新增 `ensureMonthFormulas`、`ensureMonthYoyFormulas`、`monthColumnCapacity`；
- `ReportExportService`：导出时调用 `ensureMonthFormulas` + 新增 `applySummaryReferenceLayout`（按参照件对齐列宽）；
- `WycSplitCalc`：汇总表网约车取数优先读库。

关键口径：当月值列（0 基）= `2 + 2*(m-1)`，同比列 = 值列 + 1；同比分母固定为 AJ 列（2025 年 8 月）。

## 二、测试环境
- 后端 `http://localhost:8090`，导出接口 `GET /api/report/export/summaryWorkbook?period=YYYY-MM`。
- 母版：`docs/生成汇总大表/2026年8月道路运输量汇总表.xlsx`；版式参照：`docs/生成汇总大表/生成_道路运输量汇总表.xlsx`。
- 测试时间：2026-09-11。

## 三、用例表

### 3.1 正向：2026-08 生成与当月取值

| 编号 | 检查项 | 预期 | 实际 | 结论 |
| --- | --- | --- | --- | --- |
| TC-1 | 导出 2026-08 | HTTP 200，正常产出文件 | 4.6 秒返回，948,735 字节 | 通过 |
| TC-2 | 后端回填日志 | 有写入格数统计、无缺数提示 | 写入当月值格数=1659，补写当月同比公式格数=600，补写当月合计公式格数=43，对齐列宽列数=422，缺数提示=[] | 通过 |
| TC-3 | 货运页全省块（行5-10）Q 列 | 规上/规下货运量与周转量有值，合计行为公式 | 规上货运量 3666.1401、规下 13222.6214、规上周转 570004.4355、规下周转 1700006.166；Q5=`=Q7+Q9`、Q6=`=Q8+Q10` | 通过 |
| TC-4 | 货运页 Σ17市州 = 全省 | 相等 | Σ17市州货运量 = 16888.7615；全省 Q5 = 3666.1401 + 13222.6214 = 16888.7615 | 通过 |
| TC-5 | 货运页市州派生行 | 不写死值，保持公式 | 武汉 Q14（规上+规下周转量）=`=Q15+Q16`；规上/规下分项为数值 | 通过 |
| TC-6 | 网约车页 | 17 市州当月有值，全省行为公式 | 武汉 Q9=1879.9049…、Q10=13407.6982…；全省 Q5=`=Q9+Q13+…+Q73`；Σ17市州客运量=4997.74、周转量=29166.7 | 通过 |
| TC-7 | 公交页 | 市州当月有值且**不是日期显示** | Q9=3856.83（武汉客运量），单元格格式 `0.00`；全省 Q5 为求和公式 | 通过 |
| TC-8 | 出租页 | 同上 | Q9=1058.95（武汉客运量），格式 `0.00`；全省 Q5 为求和公式 | 通过 |
| TC-9 | 班线包车页全省行 | 有全省合计（原缺失） | Q4=`=Q8+Q10+Q14+…+Q56`、Q5=`=Q9+Q11+…+Q57`、Q6/Q7 个体合计亦为公式 | 通过 |
| TC-10 | 轨道、轮渡页全省行 | 有全省合计（原缺失） | 轨道 全省 Q4=`=SUM(Q6,Q8)`、Q5=`=Q7+Q9`；轮渡 全省 Q13=`=Q15`、Q14=`=Q16` | 通过 |
| TC-11 | 同比公式指向 2025 年 8 月 | R 列分母为 AJ 列 | 各页表头 AJ 列 = `2025年8月`；R 列公式形如 `=Q9/AJ9-1`；AJ 列确有 2025 年 8 月母版数值（如货运 AJ7=3716.1158） | 通过 |
| TC-12 | 打开即重算 | 文件带全量重算标记 | `xl/workbook.xml` 内 `<calcPr calcId="191029" fullCalcOnLoad="true"/>`，Excel/WPS 打开即算出全省合计 | 通过 |

### 3.2 版式对齐（第 5 项）

| 编号 | 检查项 | 预期 | 实际 | 结论 |
| --- | --- | --- | --- | --- |
| TC-13 | 全表列宽与《生成_道路运输量汇总表》比对（展开 `<col min..max>` 范围逐列比对） | 完全一致 | 19 个页签全部比对，**真实差异 0 列** | 通过 |
| TC-14 | 扩列（8 月 Q/R）列宽 | 与参照件 8 月一致 | 货运 P/Q/R = 12.67/10.55/11.67（参照 12.67/10.56/11.67，仅 0.01 浮点舍入）；网约车/轨道轮渡 Q/R=13.0/13.0；公交 Q/R=11.89/13.0；出租 Q/R=11.89/13.0；班线包车 Q/R=10.22/9.78 —— 均与参照件相同 | 通过 |

### 3.3 负向与回归

| 编号 | 检查项 | 预期 | 实际 | 结论 |
| --- | --- | --- | --- | --- |
| TC-15 | 历史月（2026-07）不得被当月回填污染：与 `docs/生成汇总大表/_备份_2026年7月道路运输量汇总表_清理前_20260904.xlsx` 逐格比对 | 除既定改造外无差异 | 差异共三类：① 426 处浮点末位差（最大相对差 7.26e-15，属 Excel 15 位有效数字截断，无实质差异）；② 57 处"文本 vs 等值数字"；③ 148 处全部集中在「中口径排名」页 —— 该页左侧陈旧块已于 2026-09-08 按需求整块删除，属**预期变化**。**无回归** | 通过 |
| TC-16 | 缺月提示 | 缺数据的月份有提示 | 2026-08 导出 `缺数提示=[]` | 通过 |

## 四、发现的问题与处置

1. **问题（已修复）**：`monthColumnCapacity` 原实现只认"含 2026+累计"的表头，而货运页表头是"累计周转量"，导致其恒返回默认列数、8 月列永不回填。**处置**：改为「累计列」与「最后一个月份/日期格式月列」取较大值。
2. **问题（已修复）**：`shiftFormulaColumns` 连续组引用被拼成 `Q5AJ5O5`。**处置**：`sb.append(quoteReplacement(...))` → `m.appendReplacement(sb, quoteReplacement(...))`。
3. **问题（已修复）**：`ensureMonthYoyFormulas` 中 `setCellFormula` 失败被静默吞掉。**处置**：改为抛出含页签/单元格/原式/目标式的 `IllegalStateException`，便于定位。
4. **问题（已修复）**：回填目标格若被套上日期格式，数值会显示成 1902/1910 年（即用户反馈的"日期形式"）。**处置**：`setNumeric` 对空/日期格式格套用同行 1 月列样式；对已有公式格直接跳过不覆盖。
5. **已知无害告警**：2026-08 导出时日志出现 `汇总工作簿未找到同期备份母版（_备份_2026年8月…），输出将保持母版现状`。原因是 8 月没有"清理前备份母版"，而 8 月母版本身已是完整母版，无需从备份还原，故不影响输出（已逐项验证取值正确）。7 月因存在 `_备份_2026年7月…` 无此告警。
6. **性能注意**：`applySummaryReferenceLayout` 的列数上限保留 `min(参照件已用列数, 目标件已用列数 + 4)` —— 去掉该上限会让 POI 在大列号（货运页 147 列）上出现指数级卡顿。

## 五、结论
8 月汇总大表已能由库中数据自动生成：货运规上/规下、网约车、公交、出租、班线包车、轨道轮渡的当月列均已回填，全省合计与分市州合计一致；同比统一取 2025 年 8 月；公交/出租不再显示为日期；班线包车与轨道轮渡的全省数据已补齐（公式，打开即算）；全表列宽与用户指定的《生成_道路运输量汇总表》逐列一致（含 8 月扩列宽度）。7 月历史月回归无实质差异。

遗留：请将真实的《网约车行业2026年8月运行监测情况分析报告》重传一次，覆盖当前用 7 月报告临时副本导入的 8 月市州订单数。