# 功能测试报告：中口径排名同比基数方案 A（2026-09-21）

## 1. 需求与方案

用户针对 2026 年 1-8 月汇总大表提出问题：

- 「中口径排名」黄冈累计同比系统生成 `7.744917%`
- 「中口径明细」同一指标为 `7.641733%`
- 要求查明并修正。

按用户拍板采用**方案 A**：

- 「中口径排名」计算去年同期累计时，不再使用库内现算的 2025 网约车拆分结果；
- 改用母版《中口径明细》页已有的 2025 年逐月静态定稿值；
- 2026 年当年累计值、排名公式、全省 SUM 公式和当月同比逻辑均不变；
- 找不到母版静态列时保留原库内现算逻辑，并写 WARN 日志。

## 2. 实现范围

文件：`traffic-audit-server/src/main/java/com/trafficaudit/reportexport/service/ReportExportService.java`

- `exportPassengerMidRank()` 增加可选工作簿上下文重载。
- 汇总大表导出时直接复用当前内存工作簿，读取《中口径明细》2025 年静态列。
- 独立导出《生成_中口径排名.xlsx》时，按报表期打开对应汇总母版读取同一静态列。
- 静态列按表头文字识别，不写死列字母。
- 读取 17 市州「总客运量」「总旅客周转量」1..N 月值并累计；全省基数由 17 市州求和。
- 任一市州、任一指标缺少完整月份时放弃静态基数并回退原逻辑，避免静默使用残缺基数。

## 3. 验证环境

- 后端：Spring Boot `8090`
- 数据库：`127.0.0.1:3305/traffic_audit`
- 报表期：`2026-08`
- 母版：`docs/生成汇总大表/2026年8月道路运输量汇总表.xlsx`
- 测试产物：
  - `_tmp/qa_plan_a_20260921/生成_道路运输量汇总表_202608_方案A.xlsx`
  - `_tmp/qa_plan_a_20260921/生成_中口径排名_202608_方案A.xlsx`

## 4. 测试结果

| 编号 | 用例 | 预期 | 实测 | 结果 |
| --- | --- | --- | --- | --- |
| A01 | 后端编译 | 编译成功 | `mvn -DskipTests compile` 成功 | 通过 |
| A02 | 2026-08 汇总大表生成 | 成功产出可读 xlsx | 生成成功，1325107 bytes | 通过 |
| A03 | 黄冈客运量累计同比 | 排名=明细=`7.641733%` | 排名 `0.07641733462732472`，明细 `0.07641733462732603` | 通过 |
| A04 | 黄冈周转量累计同比 | 排名=明细 | 排名 `0.01593727813242681`，明细 `0.015937278132423405` | 通过 |
| A05 | 17 市州 × 客运量/周转量累计同比 | 34 组逐格一致 | 含累计值在内共 68 个数值对全部一致，最大绝对差 `2.91e-11` | 通过 |
| A06 | 全省累计同比 | 排名=明细 | 客运量：排名 `0.0581055773685379`，明细 `0.058105577368537276`；周转量同样一致 | 通过 |
| A07 | 全省累计值=Σ17 市州 | 完全相等 | 客运量 `31528.060699999998`；周转量 `1227147.4890200002`，均相等 | 通过 |
| A08 | 2026-08 当月同比回归 | 排名=明细 | 34 个市州指标全部一致，最大绝对差 `5.48e-15` | 通过 |
| A09 | 独立《生成_中口径排名.xlsx》 | 使用同一静态基数 | 黄冈客运量 `7.641733%`、周转量 `1.593728%`，与明细一致 | 通过 |
| A10 | 静态基数缺失兜底 | 不中断导出，回退现算并记日志 | 代码级检查：母版/静态列缺失返回 `null`，沿用原 `midCumYoy()` | 通过 |

## 5. 结论

方案 A 已实施并完成回归。

- 原来的 `7.74%` 与 `7.64%` 双轨差异已消除；
- 2026-08 汇总大表中，黄冈累计同比为 `7.641733%`；
- 排名页与中口径明细页的累计同比、累计值、全省汇总均一致；
- 当月同比未发生回归；
- 未修改任何数据库表结构或业务数据。

## 6. 备注

项目根目录 `_tmp/qa_plan_a_20260921/` 下的测试产物按项目约定保留，未经用户同意不删除。