# 功能测试报告_持续在规企业545家分市州累计运距同比_2026-09-19

## 一、功能说明

- **需求**：按用户确认的「持续在规企业 = 2025 年 1-8 月与 2026 年 1-8 月均连续 8 个月上报」口径（545 家），
  算出分市州 1-8 月累计平均运距同比，输出到 `D:\桌面\货运企业分市州情况\`。
- **口径**：
  - 持续在规企业（545 家）＝两年均连续 8 个月上报 H203-2 月报的企业；两年间新进、退出的企业不参与同比；
  - 累计平均运距（公里）＝ 1-8 月累计货物周转量 ÷ 1-8 月累计货运量（加权平均）；
  - 同比 ＝ 2026 年 1-8 月累计平均运距 ÷ 2025 年 1-8 月累计平均运距 − 1；
  - 全省行 ＝ 17 个市州的累计周转量、累计货运量分别求和后相除（非市州同比的算术平均）。
- **产出**：`D:\桌面\货运企业分市州情况\持续在规企业545家_分市州1-8月累计运距及同比_2026-09-19.xlsx`
  （页签：`市州汇总`〔全省 + 17 市州〕、`企业明细(545家)`）。
- **生成脚本**：`docs\工具\持续在规企业545家累计运距生成.py`。

## 二、测试环境

| 项 | 内容 |
| --- | --- |
| 数据库 | MySQL 127.0.0.1:3308 / traffic_audit，表 `h2032_enterprise_monthly` |
| 运行环境 | Python 3.14.2 + openpyxl 3.1.5 |
| 对照物 | 用户侧 `D:\桌面\货运企业分市州情况\货运企业分市州情况xlsx.xlsx`（M/N 两列） |
| 输出位置 | 工作区 `outputs\` 与 `D:\桌面\货运企业分市州情况\`，两份 SHA256 一致 |

## 三、用例表

| 编号 | 类型 | 输入 | 预期 | 实际 | 结论 |
| --- | --- | --- | --- | --- | --- |
| TC01 | 正向 | 全省 545 家 2026 年 1-8 月累计周转量 ÷ 累计货运量 | 158.1787 公里 | 4389882.0468 ÷ 27752.6820 = 158.1787 | 通过 |
| TC02 | 正向 | 全省 545 家 2025 年 1-8 月累计平均运距 | 与用户文件 M4 一致 | 153.7266，一致 | 通过 |
| TC03 | 正向 | 全省累计运距同比 | 158.1787 ÷ 153.7266 − 1 | +2.8961% | 通过 |
| TC04 | 正向 | 17 个市州 2025 年累计平均运距（去年同期基数） | 与用户文件 M 列逐行一致 | 17/17 一致 | 通过 |
| TC05 | 正向 | 17 个市州累计运距同比 | 与用户文件 N 列逐行一致 | 17/17 一致（全省行除外，见 TC10） | 通过 |
| TC06 | 正向 | 明细页 545 行求和 = 汇总页全省行 | 差异 0 | 货运量 27752.6820、周转量 4389882.0468，差异 0 | 通过 |
| TC07 | 正向 | 全省行 = Σ17 市州 | 逐项相等 | 相等（先求累计周转量、累计货运量再相除） | 通过 |
| TC08 | 边界 | 仙桃市 2026 年 2 家持续在规企业无 2025 年连续上报记录 | 同比留空并注明不适用，不除零报错 | 企业数 0、运距与同比留空，备注「同比不适用」 | 通过 |
| TC09 | 边界 | 累计货运量为 0 的企业 | 累计运距留空，不除零报错 | 已验证（表内无此类企业） | 通过 |
| TC10 | 负向 | 用户文件全省行同比 +7.8217% | 应与市州行同为 1-8 月累计口径 | 该值实为 545 家 **8 月当月**同比（157.0007 ÷ 145.6114 − 1 = +7.8217%）；累计口径应为 +2.8961%，两者相差 4.93 个百分点 | 通过（问题已在交付件中修正，并在表内注明口径） |
| TC11 | 边界 | 武汉石化交通运输有限公司、湖北捷龙交通运业有限公司 2026 年 1 月地区码为 420100、其后为 420107/420103 | 同属武汉市，归集不影响 | 均计入武汉 | 通过 |

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

1. **用户文件全省行同比口径混用（已给出正确值）**：`货运企业分市州情况xlsx.xlsx` 的 N4 单元格填的是 545 家 **8 月当月**运距同比
   （+7.8217%），而其下 17 个市州行都是 **1-8 月累计**同比。本表按累计口径给出全省 **+2.8961%**。
2. **M 列未标年份**：该列表格值实为 2025 年（去年同期）累计平均运距，表头「1-8月平均运距」易误读为今年；
   本表将 2025、2026 两年分列，消除歧义。
3. **仙桃市无可比基数**：2026 年持续在规的 2 家企业 2025 年无连续上报记录，同比不适用（不是缺数），已在表内注明。

## 五、结论

11 条用例（7 正向 / 3 边界 / 1 负向）全部通过；17 个市州与用户现有表格逐行一致，全省行更正为累计口径 +2.90%，
明细 545 行与汇总逐项对账 0 差异。交付件已生成到 `D:\桌面\货运企业分市州情况\`。