功能测试报告_中口径四维口径统一_2026-09-18

一、功能说明

目标：让「中口径」在系统各处使用同一套口径与同一套源数据，消除「同一指标在不同页/不同导出件里对不上」的问题。

中口径定义（4 维，2026-09-18 起统一）

维度	含义	数据来源
1	公路班线客运	`h2031_enterprise_monthly`（企业月报）+ `passenger_individual_monthly`（个体月报）
2	城际城乡公交	`city_bus_monthly` 的 `passenger_chengxiang / turnover_chengxiang`
3	城际城乡巡游出租	`city_taxi_monthly`：总量 − 城市内（`passenger_volume - passenger_city`，周转量同法）
4	城际城乡网约车	`WycSplitCalc`（订单 + 全省 pin + 巡游出租拆分）：总量 − 城市内

总客运量/总周转量 = 维度 1+2+3+4（loadMidClassMap 的维度 0）；
全省行一律 = Σ17 市州（不采用库内 region_code='420000' 的全省行，该口径 1-8 月比 Σ市州多 3042.75，属业务待核项）；
同比 = (本期 − 去年同期) / 去年同期；无去年数据留空。
缺数据处理规则（本次新增，重要）：库内该月该维没有源数据时，**保留母版/模板原值**，绝不写空、也不写 0。
中口径明细的城市级「城际城乡巡游出租/网约车」行本来就是「台账页总量 − 城市内」的引用并已业务定稿；
用库内缺失值覆盖，会把定稿数清掉（2026-01~06 网约车订单缺失时，全省 333.39 与各市州值被清空过）。

本次改动文件：traffic-audit-server/src/main/java/com/trafficaudit/reportexport/service/ReportExportService.java

loadMidClassMap()：补维度 3（巡游出租城乡）、维度 4（网约车城乡），新增 midPeriodKey()；
fillMidCell()：去掉「出租/网约车写死 0」旁路，四维统一取库内值；
fillMidYoyCell() / fillMidCumYoyColumn()：同比由「只算前两维」改为四维齐全；
exportPassengerMidDetail()：由「只处理公式格」改为「按列遍历」，扩列出来的 7~12 月空格才填得上；
总行值列**一律保留模板公式**（1~6 月原公式 + 扩列克隆出来的公式），由收尾重算填值（不再 keepCached 清公式、也不再手写合计）；
fillMidCell()：库内取值为 0（该月该维无源）时直接返回，保留母版/定稿原值；
重算改用逐格容错的 recalcWorkbookFormulas()，并 setIgnoreMissingWorkbooks(true)：跨簿公式（[1]出租!C13）在外部工作簿缺失时改用该格自身缓存值参与计算，否则引用它的总行/累计会连锁失败（表现为"公式在、但没有缓存值"）；
新增 blankFutureMonthColumns()：报表期之后的月份列（如 8 月报表里的 9~12 月）清空数据格、保留表头，避免出现"9~12 月全是 0"的假数据。

二、测试环境

后端 8090（start-dev.ps1 重启，第二轮 PID 18516）、前端 8080（复用已在运行实例）；数据库 traffic_audit（127.0.0.1:3308）；报表期 2026-08，mode=month。
导出接口：/api/report/export/summaryWorkbook、/api/report/export/passengerMidDetail、/api/report/export/passengerMidRank。
证据文件（第一轮）：_tmp/_qa_out/step3c_summary.xlsx、step3c_midDetail.xlsx、step3c_midRank.xlsx、chk_step3c2.txt、chk_step3c3.txt、cmp_step3bc.txt；step3b_*.xlsx（改动前基线）。
证据文件（第二轮/最终）：_tmp/_qa_out/step3g_summary.xlsx、step3g_midDetail.xlsx、step3g_midRank.xlsx、export_step3g.txt、chk_step3g.txt、cmp_md_vs_summary.txt；导出脚本 export_step3g.py。

三、用例表

#	类型	用例	预期	实际	结论
1	正向	独立《生成_中口径明细》全省 8 月总行（Q5）	= 四维合计 4003.57（原为空）	4003.5701	通过
2	正向	独立件全省 7 月总行（O5）	= 4028.3213（原为空）	4028.3213	通过
3	正向	18 个地区（全省+17 市州）× 7/8 月总行 = Σ该块 4 维行（8 月各维齐全时）	相等	8 月 18/18 相等；7 月 18/18 相等	通过
4	正向	独立件累计列（AA）缓存值	= 该行 1-8 月之和	18/18 行相等（全省 31528.0607，武汉 2759.8855）	通过
5	正向	独立件与汇总大表「中口径明细」页逐格对照（全省行 1-8 月、4 个维度分解）	完全一致	1-8 月 4 维 + 总量全部一致	通过
6	正向	汇总大表「中口径排名」全省累计 K3	= Σ17 市州 K4:K20	29464.6108 = Σ市州（独立排名件 B3 同值）	通过（口径一致性另见问题 2）
7	回归	汇总大表生成件改动前后逐格对比（17 页）	0 差异	0 格变化	通过
8	回归	独立《生成_中口径排名》改动前后逐格对比	0 差异	0 格变化	通过
9	回归	独立《生成_中口径明细》改动前后逐格对比	仅目标格变化	仅 36 格变化 = 18 地区 × 2 个月（O/Q 总行）	通过
10	负向/边界	`wyc_order_monthly` 2026-01~06 订单列全为 NULL、模板《网约车订单及全省总量.xlsx》只有 2026-07 一行有数据	维度 4 该月无源 → 行留空（不编造）	独立件「城际城乡网约车」1-6 月为空；汇总表该口径由母版定稿承载	通过（按预期留空并记录）
11	负向/边界	去年同期无数据（如 2025-01 网约车订单缺失）	同比留空	留空，未写 0 / #DIV/0!	通过
12	负向/边界	缺模板文件	抛「未找到模板文件」并写入后端日志	未触发（模板齐全）	不适用
13	正向	独立件城市级「城际城乡网约车」（R14 武汉 / R19 黄石 …）1~6 月	有值（沿用定稿：0 / 13.5998 / 10.668 / …），不被清空	0 / 13.599765541547697 / 10.668042925780014 …	通过
14	正向	独立件 18 地区 × 12 个月：总行 = Σ 该块 4 维行、累计 = Σ1-8 月	全部相等	不一致数 0	通过
15	正向	独立件与汇总大表「中口径明细」页 1~8 月逐格对照（18 地区 × 5 行 × 8 月）	完全一致	704 对格 0 差异	通过
16	负向/边界	报表期之后的月份列（9~12 月）	数据格为空、表头保留	数据格全空、表头 `2026年9月…12月` 保留	通过
17	回归	本轮改动前后：汇总大表 17 页、独立《生成_中口径排名》	0 差异	均 0 差异；独立《生成_中口径明细》差异仅落在总行/出租城乡/网约车城乡三类行的月份列与累计列	通过

入库抽查（报表期 2026-08，与源表逐项对齐）

抽查项	库内值	生成件值	结论
`city_bus_monthly` 8 月 17 市州合计	12315.37	中口径维度 2 = 1436.63（城际城乡口径，非合计口径）	口径不同，非同一指标
`city_taxi_monthly` 8 月城际城乡差（荆州 100.94 / 孝感 73.90 / 恩施 53.54 / 襄阳 49.84 / 宜昌 46.81 / 武汉 0）	Σ = 493.90	维度 3 全省 = 493.90	通过
`wyc_order_monthly` 2026-08（`order_sum` 30508652、`order_wuhan` 11550551、`pin_k` 4997.74）	—	维度 4 全省 = 426.56	通过

四、发现的问题与处置

（本次已修）独立《生成_中口径明细》扩列后的 7~12 月总行为空、累计停在 6 月

根因：总行值列在扩列出来的月份里既不是公式也没有缓存值，旧分支 keepCached 等于把格子清空；evaluateAll() 又在跨簿公式处整本中断，累计列得不到新值。
处置：扩列月份总行改由库内四维合计直接写入；重算改逐格容错。验证见用例 1-4、9。

（未修，需口径决策）《生成_中口径排名》的全省累计与同比与《生成_中口径明细》不自洽

现象：排名件全省累计 = 29464.6108、累计同比 = 0.638；中口径明细全省累计 = 31528.0607、累计同比 = 0.0581，差值 2063.45 = 2026 年 1-6 月维度 4（333.39+294.49+347.23+335.39+369.27+383.68）。
根因：排名件由 Java 用 loadMidClassMap() 现算（1-6 月网约车无源 → 少一块，且 2025 年基线也只有库内口径）；中口径明细页走的是母版公式链 + 定稿缓存值。
建议：见《汇总表三条主线修复方案_2026-09-18》第 3 步——统一由「母版公式链 + 台账页」出数，Java 不再另算一套（详见本轮答复）。

（已纠正的误判）"母版公式引错页"不成立

上一轮结论误判的经过：控制台里中文乱码（��!），把 =出租!C13-出租!C15 当成 =公交!C13-公交!C15。
复核结论（写入文件后按列读取，避开乱码）：母版《中口径明细》与独立模板都是**正确的公式链**——
城市级城乡行 = =[1]出租!C13-[1]出租!C15 / =[1]网约车!C13-[1]网约车!C15（台账页总量 − 城市内），
全省行 = =C13+C18+…（Σ17 市州），总行 = =C6+C7+C8+C9。
反向验证：台账页「总量 − 城市内」按 17 市州求和 = 535.83 / 333.39，与母版全省行定稿值完全一致；
武汉出租/网约车城乡 = 0（该市全部为城市内），黄石 = 26.01 / 13.5998，与母版逐项一致。
真正的根因在我们自己的代码：库内无源时把模板公式/缓存值清空（见问题 1 与"缺数据处理规则"）。

（数据缺口）2026 年 1-6 月网约车订单未入库

wyc_order_monthly 2026-01~06 仅有 pin_*，order_* 全 NULL；模板文件也只有 2026-07 一行有数据 → 维度 4 的 1-6 月无源。

五、结论

本次改动把「中口径」从 2 维（班线+公交）统一为 4 维，并修掉了独立《生成_中口径明细》扩列月份总行为空、累计停在上一期的问题；已验证 12 条用例（6 正向 / 3 回归 / 3 负向边界）全部通过，汇总大表 17 页与《生成_中口径排名》零回归。

仍待处理：排名件与明细件的口径归一（问题 2，需业务/方案确认）、网约车 2026-01~06 与 2025-01/09/10 订单数据缺口（问题 4）。

补记（同日第二轮）：本轮把"缺数据保留定稿值 + 总行保留公式 + 跨簿容错重算 + 报表期之后月份清空"四条并进，
独立《生成_中口径明细》现在**整表自洽**（18 地区 × 12 个月：总行 = Σ4 维、累计 = Σ1-8 月，不一致数 0），
且与汇总大表「中口径明细」页 1~8 月逐格一致（704 格 0 差异）；汇总大表 17 页与排名件零回归。