# 功能测试报告_运政车辆与轨迹里程导入回归_2026-09-02

## 功能说明
回归「运政车辆」「轨迹里程」导入功能（解析方式已于 09-02 改为"表头名称映射"，列顺序变化也能正确导入）。用 docs 里的 7 月数据文件测试 2026-08 报表期，验证正向导入、入库对齐、列乱序、错类型负向等场景。

## 测试环境
- 后端：traffic-audit-server（Spring Boot，8090），13:21 重启就绪。
- 数据库：MySQL 3308 traffic_audit。
- 接口：`POST /api/import/transportAuth`（运政车辆）、`POST /api/import/trackMileage`（轨迹里程）。
- 测试文件（docs 内真实数据快照）：
  - `docs/货运/模板_运政车辆.xlsx`（表头：企业名称/总牵引车数/总挂车数/其它车辆数/挂车总吨位(吨)/其它车辆总吨位(吨)，635 行数据）
  - `docs/货运/模板_轨迹里程.xlsx`（表头：序号/企业名称/月度总里程(公里)/有里程的车辆数，628 行数据）

## 用例表

| # | 用例 | 输入 | 预期 | 实际 | 结论 |
|---|------|------|------|------|------|
| 1 | 正向：运政车辆导入 | 模板_运政车辆.xlsx → transportAuth, period=2026-08 | 成功 635 条 | 635 条成功，0 失败 | ✅ 通过 |
| 2 | 正向：轨迹里程导入 | 模板_轨迹里程.xlsx → trackMileage, period=2026-08 | 成功 628 条 | 628 条成功，0 失败 | ✅ 通过 |
| 3 | 入库对齐（运政） | 抽查库中 2026-08 记录 | 与源文件逐项一致 | 安吉汽车物流 0/96/96/1057.708/871.56 等前 3 家一致 | ✅ 通过 |
| 4 | 入库对齐（轨迹） | 抽查库中 2026-08 记录 | 与源文件逐项一致 | 湖北中升运输 150427.03/29 等前 3 家一致 | ✅ 通过 |
| 5 | 列乱序仍可导入（运政） | 打乱 6 列顺序的副本 → transportAuth | 635 条成功，数值不错位 | 635 条成功，抽查值与源文件一致（幂等先删后插） | ✅ 通过 |
| 6 | 列乱序仍可导入（轨迹） | 打乱并去掉序号列的副本 → trackMileage | 628 条成功，数值不错位 | 628 条成功，抽查值与源文件一致 | ✅ 通过 |
| 7 | 负向：错类型文件 | 运政文件调 trackMileage | 明确报错、列出缺列 | 报"表头缺少必需列【月度总里程(公里)】【有里程的车辆数】，请确认是否选错了数据类型"，未误删数据 | ✅ 通过 |
| 8 | 负向：错类型文件 | 轨迹文件调 transportAuth | 明确报错、列出缺列 | 报"表头缺少必需列【总牵引车数】…"，未误删数据 | ✅ 通过 |

## 发现的问题与处置
- 无新增问题。说明：测试用 7 月数据导入了 2026-08 报表期（transport_auth_vehicle / vehicle_track_mileage 的 2026-08 = 635/628 条），属功能测试数据，已告知用户，如需清理可删除对应报表期记录。
- 官方能耗格式（15 列/组，如 `道路货运车辆能源消耗情况（2026）2季度.xls`）按用户确认的"系统模板格式"口径：不实现官方格式直读，导入时由表头列位校验拒绝并提示"请使用系统模板《模板_道路货运车辆能源消耗情况（2026）.xlsx》整理后再导入"（实测报：第 22 列应为「车牌号」，实际为「②出厂年份（年）」）。
- 顺带补导：`docs/投资/输入/物流（物流园区）/6月/林区物流投资月报2026.06.xlsx`、`7月/林区物流投资月报2026.07.24.xlsx` 导入 2026-06/2026-07 各 1 条成功，神农架物流园 6/7/8 月数据补全，且验证多 sheet 修复对 6/7 月文件同样生效（7 月文件含 `2026.6` 与 `2026.7` 两个 sheet，正确选中 `2026.7`）。

## 结论
全部用例通过。运政车辆/轨迹里程按表头名称映射解析正常，列顺序变化不错位，错类型文件明确报错不误删数据；官方能耗按"系统模板格式"口径拒绝并提示整理。