# 导入功能体检报告（2026-09-02 开始）

> 目的：逐类型验证"解析器列位 ↔ 官方模板 ↔ 实测导入数据"三者一致，消除"其他类型会不会像能耗一样出问题"的疑虑。
> 方法：①静态对比解析器列位与官方模板表头 → ②用真实模板文件实测导入（测试报表期）→ ③抽查入库数据与源文件逐项对齐 → ④记录缺口。

## 结论总览

| 类型 | 解析方式 | 实测 | 结论 | 风险点 |
|---|---|---|---|---|
| 能耗 H204 季报 | 固定列位(18列/组) | 7/8/9月各1284条 0失败 | ✅ 已修复+列位校验 | 官方格式(15列/组)暂不支持，需转模板 |
| 投资（客运站场/物流园区） | 固定列位+市州校验 | 6/7月真实文件（客运46+物流133、基准148） | ✅ 历史会话已大量实测 | 单表"全省汇总大表"路径待复核 |
| 城市公交 U203 | 固定列位(0-67) | 2026-04：142条 0失败；错位文件被拒 | ✅ 已加列位校验 | 列顺序变化不支持（拒绝而非导错） |
| 巡游出租 U402 | 固定列位(0-40) | 2026-04：17条 0失败；错位文件被拒 | ✅ 已加列位校验 | 同上 |
| H2032 货运月报 | 表头名称映射 | 18个月一致性核对通过 | ✅ 安全 | — |
| 公路旅客月报 H2031 | 表头名称映射 | 7月补导入46条 | ✅ 安全 | — |
| 运政车辆 | 表头名称映射（本次改造） | 模板2行✅ 列序打乱✅ 缺列报错✅ | ✅ 与货运月报同方式 | 建议真实大文件回归 |
| 轨迹里程 | 表头名称映射（本次改造） | 模板2行✅ 列序打乱✅ 缺列报错✅ | ✅ 与货运月报同方式 | 同上 |
| 投资系统导出 | 固定列位(8列) | 表头校验正/负用例通过 | ✅ 已加列位校验 | 列位固定，错位拒绝 |
| 货运量周转量 | 特殊布局(市州行+左右年段) | 2026-06：18条 0失败；错类型文件被拒 | ✅ 已补表头校验 | 列数随月份变化，靠首列市州+表头识别 |
| 规上规下拆分 | 特殊布局(sheet名+子表头) | 2026-06：36条 0失败；错布局被拒 | ✅ 已补sheet布局校验 | 依赖sheet名含 当月/累计 |
| 公路旅客运政车辆数 | 表头名称映射 | 2026-06：767条 0失败 | ✅ | — |
| 个体客运量 | 表头名称映射 | 表头识别通过（模板仅表头） | ✅ | — |
| 出租车运政车辆 | 固定列位(0-20) | 表头识别通过（模板仅表头） | ✅ 已有车牌关键字校验 | 真实4.2万行建议回归 |

## 已测明细

### 城市公交（U203 交企统 2026年7月文件）
- 导入测试报表期 2026-04：成功 142 条，失败 0 条。
- 抽查：武汉两江轮渡有限责任公司 → 运营车数 0 / 客运量 0 / 填表人 余磊 / 电话 15802725070，与源文件逐项一致 ✅

### 巡游出租（U402 交行统 2026文件）
- 导入测试报表期 2026-04：成功 17 条，失败 0 条。
- 抽查：武汉市 → 载客车次 729.27 / 客运量 1093.91 / 填表人 刘扬 / 电话 02768820261，与源文件一致 ✅

### 运政车辆（docs/货运/模板_运政车辆.xlsx）
- 本次已从"固定列位"改为"表头名称映射"（与 H2032 货运月报一致），必需 6 列：企业名称/总牵引车数/总挂车数/其它车辆数/挂车总吨位(吨)/其它车辆总吨位(吨)。
- 实测（测试报表期 2026-HT，测后已清理）：模板前 2 行导入成功 2 条；**列顺序打乱后仍成功导入 2 条**，入库字段与模板逐项一致（安吉汽车物流：牵引 0/挂 96/其它 96/挂车吨位 1057.708/其它吨位 871.56）；删除「挂车总吨位(吨)」列 → 报"表头缺少必需列"。

### 轨迹里程（docs/货运/模板_轨迹里程.xlsx）
- 本次已从"固定列位"改为"表头名称映射"，必需 3 列：企业名称/月度总里程(公里)/有里程的车辆数。
- 实测：模板前 2 行导入成功 2 条；列顺序打乱后仍成功 2 条，入库一致（湖北中升运输：150427.03/29）；列名改「月度里程(公里)」→ 报"表头缺少必需列"。

### 固定列位模块"列位校验"负向用例（2026-09-02）
- 城市公交：表头第 6 列插「错位列」→ 拒绝："第 6 列应为「公共汽电车_运营车数」，实际为「错位列」"。
- 巡游出租：表头第 5 列插「错位列」→ 拒绝："第 5 列应为「载客车次总数」，实际为「错位列」"。
- 投资系统导出：第 1 列「行号」改「序号」→ 拒绝："第 1 列应为「行号」，实际为「序号」"。

### 货运量周转量 / 规上规下拆分（docs/货运，测试期 2026-06，测后已清理）
- 货运量周转量：18 条 0 失败；抽查武汉市 1月=5367.97597、6月=5041.04224、去年1月=4656.86022，与模板逐项一致 ✅
- 规上规下拆分：36 条（当月+累计各 18 个市州）0 失败；抽查武汉市当月 规上=241659.5295/规下=445444.355/合计=687103.884，累计列一致 ✅
- 已补校验（2026-09-02）：货运量周转量检查表头「货运量(万吨)/1月…」；规上规下检查 sheet 第2行「市州/规上企业运输量」+ 第3行「周转量/货运量」子表头。负向用例（错类型文件/错布局 sheet）均被明确拒绝 ✅

### 公路旅客运政车辆数 / 个体客运量（docs/公路旅客，测试期 2026-06，测后已清理）
- 运政车辆数（模板_公路旅客运政车辆数.xlsx）：767 条 0 失败，表头名称映射 ✅
- 个体客运量（个体客运量汇总.xlsx，仅表头无数据行）：表头识别通过，导入 0 条 ✅

### 出租车运政车辆（docs/城市客运，测试期 2026-06，测后已清理）
- 导入模板_出租车信息(运政车辆信息).xlsx 仅表头无数据行：表头识别通过（含"车牌"关键字校验），导入 0 条 ✅
- 2026-08 已有真实 42636 条历史导入数据，本轮未触碰。

## 待测清单（下一步）
- 全部类型已实测完毕。剩余建议项：
  1. 出租车运政 4.2 万行真实大文件回归（此前历史导入 42636 条，模板无数据行无法用模板实测）。

## 建议（按优先级）
1. ✅ 已完成：固定列位类型补"表头列位校验"（能耗/公交/出租/投资系统导出）；运政车辆/轨迹里程改为"表头名称映射"（与货运月报一致）。
2. ✅ 已完成：货运量周转量/规上规下补表头校验，所有导入类型现在都有类型识别/校验兜底。
3. 并发互斥锁：按需（能耗已有；其他类型前端已防连点）。
4. 官方能耗格式（15列/组）解析：待业务确认后实现，替代转换脚本。
5. 运政车辆/轨迹里程解析方式已变——建议用户拿真实月度大文件回归一次（列顺序与模板一致时结果与旧逻辑完全相同）。

## 测试数据说明
- 2026-04 报表期现有城市公交 142 条、巡游出租 17 条为本次体检测试数据，非真实数据（待清理）。
- 2026-09-02 新增的 2026-HT 测试期数据（运政/轨迹各 2 条 + 导入结果记录）已清理完毕。
- 2026-06 测试期数据（货运量 18 / 规上规下 36 / 旅客运政 767 + 导入结果记录）已清理完毕，未触碰 2026-07/08 真实数据。