编辑 | blame | 历史 | 原始文档

功能测试报告：生成模板新版式改造（2026-09-02）

功能：按用户手工改好的“新版式”模板（上半块「1-N月累计」+ 下半块「N月当月/单月」）调整货运、公路旅客、城市客运三类《生成_*.xlsx》报表的填充逻辑。
范围：只改报表生成代码与底稿引用，不涉及数据导入；代码未提交、未推送。

一、功能说明（代码改动）

1. 公路旅客

生成_中口径分析.xlsx：下半块标题（A9）动态化为「YYYY年M月中口径客运量及周转量」；数据行 R11-R15 填当月客运量/周转量（当月＝N月累计−N-1月累计）与当月同比；占比公式 D/H 由指向 B$3/F$3 改为指向 B$11/F$11（当月块自身）。
生成_中口径排名.xlsx：右侧当月块 K1 标题动态化「YYYY年M月全省分市州完成道路客运生产情况」；L/P 填当月值、N/R 填当月同比；左侧仍为 1-N 月累计块。

2. 城市客运

生成_城市客运汇总.xlsx：底部新增单月块（标题 A11，数据行 R13-R19：总客运量/总周转量、公交、出租、巡游出租、网约车=0、轨道、轮渡），填当月完成量，同比留空。
生成_城市客运客运量分市州累计.xlsx、生成_城市客运各市州明细表.xlsx：当月块（客运量 R49-R66、周转量 R71-R88）改填当月值（当月累计差）；当月块 RANK/占比/增速排名公式由复制累计块而来，改指当月块自身行；当月标题 A45/A67 动态化。
底稿引用修复：城市客运 6 处已删除的《导入模板_城市公交/巡游出租/轨道轮渡/城市汇总/城市分市州/各市州明细表》全部改回同名《生成_*.xlsx》（ReportExportService/Controller、一键系列包内同步）；前端 DataImport.vue 城市公交/巡游出租“下载模板”链接同步改指《生成_*》。

3. 货运

生成_货运量排名.xlsx、生成_周转量排名.xlsx：R23 标题去掉“累计”字样 →「YYYY年M月全省分市州完成公路货运量/货物运输周转量情况」。
第二页数据改填“当月”值（2026-09-02 16:40 确认并实现）：货运量第二页合计=模板_货运量周转量当月列（freight_mN）、规上=H2032 当月吨/1e4、规下=差值，同比取去年同月；周转量第二页直接用拆分表 MONTH 行（含当月同比字段）。
第二页列头“累计完成 (万吨/万吨公里）”在导出时内存替换为“当月完成”（renameRankMonthHeader，不改模板源文件）。

二、测试环境

后端 8090 本地运行；数据库 mysql localhost:3308 traffic_audit。
数据现状：h2031（公路旅客企业月报）2026-03/07；city_bus/city_taxi 2026-06/07；h2032 2026-01~08 完整。
测试报表期：2026-07，mode=month。产物留档：outputs/report_check/regression_newtpl_2026-07/

三、用例表

#	类型	输入	预期	实际	结论
1	正向	passengerMidAnalysis 2026-07	上半块=1-7月累计，下半块=7月当月	A1=「2026年1-7月中口径…」B3=6151.91 万人、F3=285634.95；A9=「2026年7月中口径…」B11=3078.86 万人、F11=141155.32；D12-H15 占比公式分母=B$11/F$11	通过
2	正向	passengerMidRank 2026-07	左块累计标题、右块当月标题与当月值	A1=1-7月累计标题；K1=「2026年7月全省分市州完成…」；L3=3078.86（当月）与左块 B 列累计数值明显区分	通过
3	正向	cityPassengerSummary 2026-07	底部单月块=库内 2026-07 合计	A11=「2026年7月全省完成城市客运量情况」；B13=30612.85、D13=218186.08；B14=12974.73（公交）、B15=5860.24（出租）、B18=11731.83（轨道）、B19=46.05（轮渡），与库内 city_bus/city_taxi 2026-07 分项合计逐位一致	通过
4	正向	cityPassengerCitySum 2026-07	当月块=7月当月、公式指当月行	当月客运量块武汉 R50：G=4218.74（公交）、L=1093.91（出租）、V=11701.74（轨道）、X=46.05（轮渡）、B=17060.44，与 DB 2026-07 一致；C/H/M/R 排名公式范围=B$50:B$66 等当月行；累计块与当月块数值区分明显	通过
5	正向	freightRank / turnoverRank 2026-07	R23 标题无“累计”；第二页=当月值	R23=「2026年7月…完成…」；上半块 1-7 累计不变；第二页 2026-07 当月值与库内逐项一致（见用例 11）	通过
11	正向	freightRank/turnoverRank 2026-07 当月版（产出 freightRank_当月版_2026-07.xlsx / turnoverRank_当月版_2026-07.xlsx）	第二页当月值与 DB 一致、列头=当月完成	货运量第二页：全省 R26 B/G/L=3754.7823/12530.9282/16285.7105、武汉 R27 B=1227.5499（DB H2032 2026-07 武汉合计 1227.5499 ✓）、L=4940.9715；周转量第二页：全省 R26=597278.64/1584647.07/2181925.71、武汉 R27=204809.5633/462751.8106/667561.3739，与 DB scale_split MONTH 行一致；B25/G25/L25 列头=“当月完成”；无错误公式	通过
6	正向	10 个导出接口（含未动表的公交/出租/轨道轮渡明细）2026-07	全部可出数	全部 HTTP 200；全文件错误公式扫描 #REF!/#DIV/0!/#N/A = 0 残留	通过
7	负向	无数据月份 period=2026-05（citySummary/freightRank）	不报错、当月块留空	HTTP 200，空表正常生成（产物 neg_citySummary_2026-05_nodata.xlsx）	通过
8	负向	年初单月 period=2026-01（freightRank）	当月块=1月数据	HTTP 200（产物 neg_freightRank_2026-01.xlsx）	通过
9	边界	超范围月份 period=2026-13	不崩、软处理	HTTP 200 正常出文件	通过（宽松处理）
10	负向	非法报表期 period=bad-period	友好报错或 400	HTTP 500（无入参校验；前端为固定下拉，正常路径不可达）	发现缺陷（低优先）

四、入库抽查（与源库逐项对齐）

城市客运汇总底部单月块：B14/D14（公交 12974.73 / 87147.68）、B15/D15（出租 5860.24 / 34236.60）、B18/D18（轨道 11731.83 / 96645.23）、B19/D19（轮渡 46.05 / 156.57）= SELECT SUM 2026-07 city_bus/city_taxi 逐项一致。
城市客运当月块分市州：武汉 R50 公交 4218.74、出租 1093.91 = DB 2026-07 武汉市合计；其余 16 市州公交值与 DB 逐市州一致（抽查 G 列 R50-R66）。
公路旅客中口径下半块 3078.86 万人 / 141155.32 万人公里 = 2026-07 当月源值（累计差口径，与既有回归口径一致）。

五、发现的问题与处置

货运两张排名表第二页“当月”填充（已实现并验证，2026-09-02 16:40）：业务确认第二页要当月值后，已实现当月填充（货运量：规上=H2032 当月/合计=模板当月列/规下=差值；周转量：拆分表 MONTH 行），并把第二页列头内存替换为“当月完成”。2026-07 回归与 DB 逐项一致、无错误公式。模板源文件（docs/货运/生成_*.xlsx）本身仍写“累计完成”字样，如需源文件一并改可在 Excel 中另存（程序导出已自动显示为“当月完成”）。
城市客运当月块 Q 块表头歧义（待业务确认）：当月客运量块表头行 48 Q 列写“其中：出租”、当月周转量块表头行 70 Q 列写“其中：网约车”，程序按“网约车=0 留空”填充；需确认业务口径（已记入待确认清单）。
增速/增速排名列：E/J/O/T/W/Y 无去年同期数据时留空，其排名公式（F/K/P/U 等）保留；无去年数据时排名无业务意义，待模板口径确认后决定是否整列清空。
非法 period 返回 500：报表参数未做格式校验，前端固定下拉不可达，低优先级，建议后续统一补。

六、结论

公路旅客、城市客运新版式改造已落地：上半“累计”+下半“当月”双块结构正确、公式范围正确、数值与库内 2026-07 数据逐项对齐，无错误公式残留 → 可用。
货运两张排名表第二页“当月”填充已实现并通过 2026-07 回归（与库内 H2032 / freight_turnover_import / scale_split MONTH 行逐项一致）。