# 功能测试报告：汇总大表货运规上规下补数 + 成品页当月块修正（2026-09-07）

## 一、功能说明
针对《道路运输量汇总表（整本）》母版的两类问题人工修母版（与备份母版同步修改，避免生成时备份差异格反向覆盖）：

1. **` 货运` 页“规上+规下货运量 / 规下货运量”缺数**：补齐 2021-2026 年全部月度值。
   - 数据源：`D:\05_数据分类\货运\7月\定稿-湖北省各市州运输量数据（2026年1-7月）.xlsx`；
   - 口径：`规下货运量 = 规上+规下货运量 − 规上货运量`；
   - 城市行（R11/规上+规下、R12/规上、R13/规下）逐城市逐月回填；附加累计/同比/环比列按原模板公式同步写入。
2. **6 个成品页“当月块=累计块”错误**：货运量排名、货运周转量排名、中口径排名、中口径分析、城市汇总、城市分市州 的当月数据/排名/占比/同比，原为 1-7 月累计值的错拷贝，现全部按 **2026-07 当月** 数据重算。
3. 修复过程发现并修正三处衍生错误（首轮脚本 bug）：
   - 台账“城市内**周转量**”误读成与客运量同一行（应为 12+4i 行）→ 周转相关值/同比全部错；
   - `城市汇总` 当月块漏“巡游出租”行导致 网约/轨道/轮渡 整体下移错位；
   - “合计”类列读公式单元格得到公式串（非数值）→ 货运量排名全省合计 L25、周转量排名城市合计 L28:44 等被写成空。

## 二、测试环境
- 后端 Spring Boot 8090（运行中），HTTP 实际调用 `/api/report/export/summaryWorkbook?period=2026-07&mode=month` 生成产物；
- 母版：`docs/生成汇总大表/2026年7月道路运输量汇总表.xlsx`；
- 备份母版（生成还原基准）：`docs/生成汇总大表/_备份_2026年7月道路运输量汇总表_清理前_20260904.xlsx`；
- 校验：openpyxl 逐格比对母版/备份被改区域 + 台账原始数值抽取核对 + HTTP 产物抽查。

## 三、用例与结果

| # | 用例 | 输入/对照 | 预期 | 实际 | 结论 |
|---|---|---|---|---|---|
| 1 | 货运规上+规下/规下补数 | 2026-07 武汉 R11/R12/R13（O 列） | 总=4940.9715、规上=1227.5499、规下=3713.4216（源表口径） | 一致；17 市州合计=全省（16285.711 / 3754.7823 / 12530.9282） | 通过 |
| 2 | 母版与备份一致性 | 全部被改区域逐格 | 母版=备份（差异 0） | diff=0 | 通过 |
| 3 | 货运量排名当月全省合计 | L25、O25、N26:42 | L25=16285.7105、O25≈0.0154、武汉 N=0.3034 | 一致 | 通过 |
| 4 | 货运量排名月≠累计 | 城市行 B/G/L 月 vs 累计 | 当月与累计不同 | 0 处残留同值 | 通过 |
| 5 | 货运周转量排名 | 城市 L28=规上+规下=667561.374；E27/J27/O27 按周转口径 | E27≈0.0576、J27≈-0.0111、O27≈0.0068 | 一致 | 通过 |
| 6 | 城市汇总当月块 | R14-20 B/C/D/E | 总客运 33068.03、总周转 206194.82；公交/出租/巡游/网约/轨道/轮渡 分列正确 | R15 公交 D=59265.28…R20 轮渡 D=156.57，全部按行义对上 | 通过 |
| 7 | 城市分市州客运当月 | 全省行 V50/X50、城市行 B/G/L/Q/V/X | V50=11731.83、X50=46.05、武汉 R51=18865.2275 | 一致 | 通过 |
| 8 | 城市分市州周转当月 | 全省行 G/L/Q/V/X 与城市行 | 武汉 G=21912.54/L=8532.5/Q=13036.39/V=96240.86/X=156.57/B=139878.86 | 一致；月≠累计残留仅轨道/轮渡非武汉/黄石空列（合法） | 通过 |
| 9 | 程序 HTTP 产物 | 导出 2026-07 整本 | 产物含上述修正值，母版还原覆盖不反向污染 | 抽查全部一致（`输出/道路运输量汇总表_2026-07.xlsx`） | 通过 |

## 四、实现中发现并处置的问题
1. 首轮 `_fix_monthly.py` 用 `data_only=False` 读公式格得到公式串，合计类列写成空；改用「规上+规下」现算值回填。
2. 台账周转行错位（11+4i vs 12+4i）：`城市汇总` D/E、`城市分市州` 周转当月块整体重算。
3. `城市汇总` 当月块行义为 总/公交/出租车/巡游/网约/轨道/轮渡（14-20），首轮按 5 行写入导致错位，重排补齐。
4. 派生文件（`_fix_*.py`、`_verify*.py`、输出目录验证副本）为临时产物，不入库。

## 五、结论
货运规上规下 2021-2026 补数与 6 个成品页当月块修正已完成，母版/备份一致、程序 HTTP 生成产物核对通过；P0 人工修母版方案可关闭，待数据驱动填充（P2+）跟进。