# 功能测试报告：审核结果界面交互优化与导出问题话术落地

日期：2026-09-09　模块：审核结果 / 数据查看 / 报表生成（前端）+ 审核结果导出与查询（后端）　测试人：Codex（业务点验后补充）

## 一、功能说明
1. 审核结果页按业务反馈收敛交互语义：问题范围两个选项改为「仅需核实 / 含提醒型」并附说明「提醒型仅提示变化、不需处理，导出默认不含」；视图默认「按企业合并」，同时保留「按条明细」；筛选区改为浅灰卡片栏，并展示「当前筛选 N 条 / M 家企业」实时命中数；顶部红/黄/待处理/已处理统计卡改为跟随当前筛选结果联动。
2. 导出「企业合并」Sheet 的问题列话术按用户给定 4 条例文格式生成，其余规则统一为「核实异常/差异说明（含关键数值）＋请核实」风格；queryResults 改为按报表类型先取规则、再取该期结果，避免全表规则比对。
3. 数据查看页工具栏整理为与导入页一致的「分组模块＋类型下拉」，报表期/关键字/查询/全屏并排于一行，底部提示改为「共 N 条记录，已加载 N 条」。
4. 报表生成页「道路运输量汇总表（整本）」预览改为分组表格（道路货运/城市客运/中口径 × 当月/累计/同比），同比缺上年基期时逐项给「—」与提示。

## 二、测试环境
- 后端 8090（2026-09-09 15:45 以最新代码重启就绪），前端 8080（dev 编译成功、HMR 生效）。
- 数据库：本机 traffic_audit（2026-08 货运/旅客/公交/出租数据均在库）。

## 三、用例与结果
| 编号 | 用例 | 输入 | 预期 | 实际 | 结论 |
|---|---|---|---|---|---|
| 1 | 2026-08 货运查询不转圈 | 页面选 2026-08＋货运月报→查询结果 | 数秒内返回并停止 loading | 约 2~3s 返回 487 条 / 403 家，无卡转圈 | 通过 |
| 2 | 问题范围按钮即时响应 | 点击「含提醒型」再点「仅需核实」 | 选中态与命中数即时变化，无需重新查询 | 选中态秒切；仅需核实下自动剔除 RULE_004 提醒型（487→474 条） | 通过 |
| 3 | 视图默认与切换 | 进入页面→视图单选 | 默认「按企业合并」，可切「按条明细」 | 默认按企业合并（AX 选中态 Value=1），按条明细可正常切换为 10 列逐条表 | 通过 |
| 4 | 月报数据弹窗（数据）接口 | /api/data/list?type=h2032/cityBus/h2031&period=2026-08 | 快速返回该企业该期填报 | 23~561ms 返回（h2032 关键字命中 1 条、cityBus 10 条、h2031 50 条/总数119） | 通过 |
| 5 | H2031 导出问题列与用户 4 条模板一致 | /api/audit/export 2026-08 H2031 | 1)~4) 话术与用户提供格式完全一致 | 实测 G7：①客运量环比=0核实异常（上月客运量=3784，本月包车客运量=3784）请核实 ②旅客周转量环比=0核实异常（…）请核实 ③包车平均运距等于上月（上月运距=25.9，本月运距=25.9）请核实企业是否是固定线路旅游或者通勤业务；G10 班线为「…环比超±20%…（三类班线平均运距=0，上月=17.6，环比100%）…请核实」 | 通过 |
| 6 | H2032 导出问题列含明细 | 同上 H2032 | 每类核实意见带关键数值 | 实测「企业上报车辆/吨位与运政数据对比存在差异（整车吨位：上报=…，运政=…，差…（限50 吨）；总吨位：…）请核实」「上报周转量与轨迹测算周转量差异明显（上报周转量=…，轨迹测算=…）请参考轨迹核实企业周转量」等 | 通过 |
| 7 | 审核结果导出结构与合并区 | openpyxl 打开两份导出 | 双 Sheet、B/G 跨行合并、问题列编号 1、2、3… | H2031 84 行、H2032 475 行；企业合并 B（企业）/G（问题）合并同构 | 通过 |
| 8 | 整本预览 2026-08 分组表键名 | /api/report/preview?period=2026-08&types=summaryWorkbook | summary 键名与新分组表格取值一致 | 返回键含「全省货物周转量·累计 / ·累计同比」「城市客运量/周转量·当月·累计」「中口径客运量/周转量·当月·累计」等，前端 wbRows 分组可取数，缺当月源数据与上年基期的行显示「—」并给提示 | 通过 |
| 9 | 编译与运行 | mvn compile＋前端 dev | 无编译错误、页面可交互 | 后端 15:45 重启成功（Started … port 8090）；前端 15:42 编译成功；页面实测点击/切换/查询均正常 | 通过 |

## 四、发现问题与处置
- 原「核实型/全部」文案语义不清导致用户困惑 → 改为「仅需核实/含提醒型」，并加灰色说明文字；原「按条明细」默认视图 → 改为默认「按企业合并」（与日常按企业下发核对的工作流一致）。
- 用户反馈“选 8 月货运/城市公交一直转圈”：复测 2026-08 各类型结果查询均 <1s、/data/list 弹窗数据 <600ms，未复现转圈；判定为旧版按钮仅更新选择状态不刷新列表所致，现已改为前端响应式过滤（切范围/状态即时生效），无需整页重新请求。
- 导出问题列 H2032 旧话术只写“异常（实际/基准/偏差）”较晦涩 → 按规则补齐关键数值与业务口径（运政分项、轨迹、集装箱、整车吨位等），货运/客运两类话术均已按新格式实测核对。

## 五、待业务点验 / 遗留
- 请业务在浏览器点验：问题范围/视图/状态三个控件切换、行内「数据」弹窗、导出 Excel 打开后与 docs/审核界面月报模板/模板_审核结果.xlsx 及四条例文逐条比对。
- 与既有遗留一致：汇总大表 8 月自动填值（M2/M3 SummaryFiller）未启动；8 月缺 freight_turnover_import 等源数据行；导入弹窗 UI 与 RULE_001 阈值（5 台/50 吨）待业务确认。

## 六、结论
本轮界面交互收敛、导出问题话术落地与预览表格化均通过接口级与页面级验证；未发现阻塞性问题，可随代码一并交付，等待业务终验。