# 功能测试报告：货运量/周转量 2023 年数据补录入库

- 日期：2026-09-16
- 模块：数据导入 / 货运量周转量
- 结论：**通过**（正向 1 条、入库抽查 216 项全对齐、上年同期 1 条、幂等/回归 2 条）

## 一、功能说明

用户反馈「2023 年有 12 月的数据」，而上轮入库使用的 8 月源文件**缺 2023 年 Sheet**（只有 `2026年/2025年/2024年/2022年/2021年`），因此库里没有 `2023-12`。

排查后在 7 月源文件中找到 2023 年数据，将其补录入库：
| 项 | 内容 |
|----|------|
| 数据来源 | `D:\05_数据分类\货运\7月\定稿-湖北省各市州运输量数据（2026年1-7月）.xlsx` 的 `2023` Sheet |
| 补录方式 | 另存临时工作簿 `_2023_import_tmp.xlsx`（仅保留 `2023` + `2022年` 两个 Sheet，满足多年度工作簿「至少 2 个 Sheet」规则），走 `POST /api/import/freightTurnover?period=2023-12` |
| 结果 | `货运量周转量导入成功, 共 36 条记录`（18 地市 × 2 个报表期：2022-12 重写 + 2023-12 新增） |

**为什么带上 2022 年 Sheet**：`2023` 的上年同期取自「上一年度 Sheet」，只放 2023 会导致 2023 的 `last_*` 为空；同时避免整本导入 7 月文件而多出无用的 `2026-07` 报表期。

## 二、测试环境

- 后端：重启后新编译，`Tomcat started on port(s): 8090`，PID 31384
- 数据库：`traffic_audit.freight_turnover_import`
- 源文件：7 月文件 `2023` Sheet（A1:N48：`货运量(万吨)` 块 + `周转量(万吨公里)` 块，1–12 月 + 累计列）

## 三、用例表

| # | 场景 | 输入 | 预期 | 实际 | 结论 |
|---|------|------|------|------|------|
| 1 | 正向-2023 入库 | `_2023_import_tmp.xlsx` → freightTurnover | 生成 `2023-12`，18 行 | `共 36 条记录`；`SELECT report_period,COUNT(*)` 出现 `2023-12 = 18` | 通过 |
| 2 | 入库抽查-逐格比对 | 2023 Sheet 货运量块 + 周转量块（18 地市 × 12 月 × 2 指标 = 432 项） | 与库中 `freight_m01..m12` / `turnover_m01..m12` 完全一致 | **mismatches = 0**（18 个地区全部匹配） | 通过 |
| 3 | 上年同期 | 查 2023-12 的 `last_freight_*` / `last_turnover_*` | 等于 2022 年同月值 | 武汉 `last_freight_m01=3527.89407360113`、`last_freight_m12=4334.42636773157`、`last_turnover_m12=608823.495390257`，与 `2022-12` 行逐值相同 | 通过 |
| 4 | 报表期清单回归 | 查全部报表期 | 无重复、无 2099 残留 | 2021-12 / 2022-12 / **2023-12** / 2024-12 / 2025-12 / 2026-01…2026-08，每期 18 行 | 通过 |
| 5 | 历史期未被污染 | 2022-12 重写后与原值比较 | 完全一致 | 与改动前 2022-12 逐值相同 | 通过 |

## 四、发现的问题与处置

| # | 问题 | 处置 |
|---|------|------|
| 1 | 8 月源文件无 2023 年 Sheet，导致库里长期缺 `2023-12`、且 `2024-12` 无上年同期 | 从 7 月源文件补录 `2023-12`；`2024-12` 的上年同期本次**未重算**（需重导 2024 才会生效），如需可另行补导 |
| 2 | 7 月文件与 8 月文件的 2021/2022/2024 三年数据是否一致无法确定 | 逐格比对：`onlyJuly/onlyAug/differ` 全部为空，**三年 0 处差异**，因此补导 2022 不会引入偏差 |
| 3 | 若整本导入 7 月文件会多出 `2026-07` 报表期 | 改为只保留 `2023 + 2022年` 两个 Sheet 的临时工作簿，避免产生无用期次 |
| 4 | 单 Sheet 文件不会被识别为多年度工作簿 | 已在本报告与《问题与注意事项汇总》中记录该规则，供后续补数参考 |

## 五、结论

- 2023 年货运量/周转量已完整入库（18 地市 × 12 月），**432 项逐格比对零差异**，上年同期正确取自 2022 年。
- 报表期清单连贯：2021-12 → 2026-08 共 13 期，每期 18 行。
- 遗留：`2024-12` 的上年同期（2023 年值）未回填，如需要可重导 2024 年数据。