# 报表生成输入输出与逻辑关系总表（2026-09-03 版，2026-09-04 增补）

> 口径汇总入口：把“报表生成（城市客运/汇总工作簿）”相关功能的输入表、页签关系、逻辑运算汇总如下。
> 详细展开见两篇专题：`docs/生成汇总大表/页签逻辑关系说明.md`（19 页三层结构与勾稽）、`docs/生成汇总大表/自动生成汇总工作簿落地方案.md`（P0-P7 落地方案）。
> 2026-09-04 增补：第 5 节《程序相关库表总览与相互关系》、第 6 节《单位与数值换算规范》、第 7 节《货运“规上/规下”口径说明》；落地 SQL 见 docs/生成汇总大表/规下货运量口径_2026-09-04.sql。

## 1 关系总表

| 功能/报表项 | 输入（文件/库表） | 参与页签 | 关键运算 | 输出 | 口径备注 |
|---|---|---|---|---|---|
| 网约车客运量拆分表（wycSplit，月度） | 《网约车订单及全省总量.xlsx》当月行：B-E=网约车全省客运量/城市内客运量/周转量/城市内周转量（源自《网约车总数.xlsx》），F=订单合计，G-W=17 市州订单（源自《湖北网络预约出租汽车…分析报告》附件1）；city_taxi_monthly 巡游出租月报（客运量/城市内/平均运距/城市内平均运距） | 无（独立页 `yyyy-MM拆分`，客运量块+周转量块） | 客运量=订单占比×全省 pin；城市内 H：武汉=自身、其余按巡游城市内占比剩余分摊至 pinCK；城际城乡=总量−城市内；周转量 G=客运量×巡游平均运距占比分摊 pinZ，城市内同法（用城市内平均运距） | 生成_网约车客运量拆分表_{期}.xlsx | 供《道路运输量汇总表》网约车台账页引用；2026-07 与人工口径四指标最大偏差 0 |
| 道路运输量汇总表（summaryWorkbook，整本） | 母版 docs/生成汇总大表/{年}年{月}月道路运输量汇总表.xlsx（P0-P1 整本复制；P2 起逐步改为 台账/口径合成/成品 三层回填） | 19 页：班线包车、公交、出租、网约车、轨道轮渡（台账）；城市客运、中口径明细（口径合成）；城市汇总、城市分市州、货运、两张排名、中口径排名/分析、道路运输周转量（成品）等 | 目标年=2026 零改动；跨年只替换文本 `2026年`→目标年；数据填充/月份扩展 P2 待定 | 生成_道路运输量汇总表_{期}.xlsx | 母版必须逐月存在（缺月明确报错，不跨月回退）；2025/2024 列保留母版缓存值；#REF! 待处理 |
| 城市客运既有 9 张（公交/出租/轨道轮渡/汇总/累计等） | 城市公交/巡游出租等月报库表 + docs/城市客运 新版式模板 | 各自单页/双页 | 按各表口径聚合、同比、累计 | 生成_xxx.xlsx | 与本次新增项同列表，统一走两位小数显示规则 |

## 2 网约车拆分算法（与《网约车拆分.xlsx》月页一致）

设 17 市州 i（0=武汉），全省 pin：客运量 K=4852.3、城市内 CK=4430.84、周转量 Z=28348.02、城市内 CZ=22705.61（2026-07）。
- C_i = 订单_i ÷ Σ订单 × K（网约车客运量）。
- 巡游占比 F_i = 出租城市内客运量_i ÷ 出租客运量_i。
- 城市内客运量 H_i：武汉 H_0 = C_0×F_0；其余 H_i = (C_i×F_i) ÷ (ΣC_jF_j − C_0F_0) × (CK − C_0F_0)。城际城乡 I_i = C_i − H_i。
- 周转量 G_i = (C_i×平均运距_i) ÷ Σ(C_j×平均运距_j) × Z；城市内周转量 Hl_i：武汉 = G_0；其余 = (H_i×城市内平均运距_i) ÷ (ΣH_j×城市内平均运距_j − H_0×城市内平均运距_0) × (CZ − G_0)；城际城乡周转量 Il_i = G_i − Hl_i。
- 平均运距缺省兜底 = 周转量 ÷ 客运量（城市内同理）；武汉无城际城乡（H=K、I=0）。

## 3 汇总工作簿三层口径（摘要，详见页签逻辑关系说明.md）

- 第 1 层台账页（分方式明细）：班线包车（含个体）、公交、出租、网约车、轨道轮渡；全省+17 市州逐月，行结构 4 行/市州（客运量/周转量/其中客运量/其中周转量）。
- 第 2 层口径合成：城市客运（=公交城市内+出租城市内+网约车城市内+轨道轮渡）；中口径明细（=班线全量+公交城乡差+出租城乡差+网约车城乡差）。城乡差=台账页“总量行−其中城市内行”（2026-07：出租全省 509.00、网约车 421.46；武汉城乡差=0）。
- 第 3 层成品：城市汇总、城市分市州、货运/排名、中口径排名/分析、道路运输周转量（B=G+L/2+Q/10：货运周转量+城市客运量/2+中口径总旅客周转量/10）。
- 轨道轮渡：轨道=武汉+黄石；轮渡仅武汉；黄石无轮渡。

## 4 共性规则

1. 数值“显示两位小数、保留全精度”：所有生成工作簿出口统一执行 applyTwoDecimalFormat（`0.00` 显示；整数/%/日期/科学计数/已含 0.00 样式不动）。
2. 缺数据不静默：wycSplit 缺输入行、summaryWorkbook 缺当月母版、ready 前置校验缺库表数据时，列表置“缺数据”并给出原因，导出明确报错。
3. 状态查询：/api/report/ready（数据就绪）、/api/report/preview、/api/report/export/{key}（单个）、/api/report/export/selected（多选 zip）均已覆盖新类型。


## 5 程序相关“业务表”总览与相互关系（2026-09-04 增补）

> 阅读约定：以下“《……》”是**业务上叫的名字**（用户能看懂）；括弧里的英文（如 scale_split_transport）是**程序数据库里的实际表名**，只给程序/开发用，业务人员不用记。
> 链路总览：**导入台账层**（各类月报/季报/年报导入）→ **审核层**（规则校验）→ **报表生成层**（单表导出 / 汇总工作簿 / 网约车拆分）→ 输出文件。每次导入都记一个“导入批次”，可回溯到原始文件。

| 业务表名（用户叫法） | 程序库表名 | 环节/周期 | 数据来源（导入的文件） | 干什么用 / 和别的表什么关系 |
|---|---|---|---|---|
| 《导入批次表》 | import_batch | 导入 | 所有导入共用 | 记录“哪一批文件、什么时候导入的”；各业务表都带批号可反查 |
| 《道路货物运输月度生产情况表》（交企统H203-2，企业月报） | h2032_enterprise_monthly | 导入台账/月 | 模板_交企统H203-2表_道路货物运输月度生产情况.xlsx | 每个“规上”企业一行的明细；把各市州企业的货运量(吨)、周转量(吨公里)加起来÷10000，就是该市州“规上”合计，供货运报表和汇总表“ 货运”页使用 |
| 《货运运政车辆表》 | transport_auth_vehicle | 导入台账/月 | 模板_运政车辆.xlsx（也可随 H203-2 第二个 sheet 导入） | 规上企业车辆数/吨位，用于车辆数据核对 |
| 《公路旅客运输月度生产情况表》（交企统H203-1，企业月报） | h2031_enterprise_monthly | 导入台账/月 | 模板_交企统H203-1表…xlsx | 班线包车台账的“企业部分”；公路旅客分市州报表 |
| 《个体客运月报表》 | passenger_individual_monthly | 导入台账/月 | 个体客运独立模板 | 班线包车台账里的“其中个体”行；公路旅客总行=企业+个体 |
| 《公路旅客运政车辆表》 | passenger_auth_vehicle | 导入台账/月 | 旅客运政车辆数模板（也可随 H203-1 第二 sheet 导入） | 旅客车辆数核对 |
| 《道路货运车辆能源消耗情况表》（交企统H204，季报） | h204_vehicle_quarterly | 导入台账/季 | 能耗季报模板（官方能耗格式，固定列位解析） | 能耗明细（车牌/车型/燃料/能耗）；与能耗运政信息同报表期互斥防重导 |
| 《能耗车辆运政信息表》 | h204_auth_vehicle | 导入台账/季 | 模板_能耗车辆运政信息.xlsx | 能耗车辆的档案信息 |
| 《轨迹里程表》 | vehicle_track_mileage | 导入台账/月 | 模板_轨迹里程.xlsx | 运政口径里程/轨迹数据 |
| 《城市公共交通月度运营情况表》（城市公交月报，企业级） | city_bus_monthly | 导入台账/月 | 城市公交月报模板 | 公交台账页（总量/其中城市内/城乡差）；表内还带轨道、轮渡月度数据列（rail_*/ferry_*），用于轨道轮渡台账 |
| 《巡游出租汽车运营服务情况月报》（U402，市州级） | city_taxi_monthly | 导入台账/月 | 巡游出租月报模板 | 出租台账页（总量行+其中城市内行）；也是网约车拆分时“巡游占比/平均运距”的输入 |
| 《出租车运政车辆表》 | city_taxi_auth | 导入台账/月 | 出租车运政车辆（车辆级明细） | 运营车数对比；按道路运输证字号等提取市州归属 |
| 《货运量周转量表》（全省/市州全口径总量月报） | freight_turnover_import | 导入台账/月 | 模板_货运量周转量.xlsx | **全口径（规上+规下）**的货运量(万吨)/周转量(万吨公里)，每月一列(m01~m12)并带去年同月(last_*)；有“湖北省”行用于全省校验 |
| 《规上规下拆分表》（拆分结果表） | scale_split_transport | 导入台账/月 | 模板_规上规下拆分运输量.xlsx（当月/累计两个 sheet） | 存“规上/规下/合计”三块（含排名、同比）。目前导入模板只有周转量，所以周转量三列有数、货运量三列空（详见第 7 节） |
| 《投资月报表》《投资项目表》《投资系统导出表》 | investment_monthly / investment_project / investment_system | 导入台账/月 | 投资月报（客运站场/物流园区等）/ 项目库 / 投资系统导出文件 | 投资模块导入与审核：按月与投资系统导出数据对账（I004 等规则） |
| 《审核规则表》《审核执行表》《审核结果表》《审核说明表》 | audit_rule / audit_run / audit_result / audit_explanation | 审核 | 审核引擎 | 规则配置 → 每次执行一个批号 → 命中/通过明细（挂业务表与行号）→ 汇总说明 |
| 《AI 分析脱敏映射表》 | llm_desensitize_map | 辅助 | AI 分析 | 导出 AI 分析时做脱敏 |
| 《用户/角色/部门表》 | sys_user / sys_role / sys_dept | 系统 | - | 登录与省/市/县数据权限 |

报表生成层不新增表，按“报表项→模板→从上面的业务表取数→输出 xlsx”，详见第 1 节与 `docs/生成汇总大表/自动生成汇总工作簿落地方案.md`。

## 6 单位与数值换算规范（2026-09-04 增补，均用 2026-07 库值与母版逐格验证）

| 数据在哪个表 | 字段/含义 | 库内单位 | 报表单位 | 换算 | 2026-07 验证样例 |
|---|---|---|---|---|---|
| 《道路货物运输月度生产情况表》(H203-2) | 货运量 | 吨 | 万吨 | ÷10000 | 武汉合计 12275499 吨 → 1227.55 万吨 = 汇总表“ 货运”页规上7月 |
| 《道路货物运输月度生产情况表》(H203-2) | 货物周转量 | 吨公里 | 万吨公里 | ÷10000 | 武汉合计 2048095633 吨公里 → 204809.56 = 母版规上周转量7月 |
| 《货运量周转量表》 | 当月货运量(mXX) | 万吨 | 万吨 | 直接用 | 全省 16285.71 与“湖北省”行、17 市州求和一致 |
| 《货运量周转量表》 | 当月周转量(mXX) | 万吨公里 | 万吨公里 | 直接用 | 武汉 667561.37 |
| 《规上规下拆分表》 | 规上/规下/合计周转量 | 万吨公里 | 万吨公里 | 直接用（拆分模板数值） | 武汉规上累计 1440570.29 = 母版累计列 |
| 汇总表母版“ 货运”页 | 2026 各月值列与 2025 列(T..AP) | 与指标同（万吨/万吨公里） | 同左 | 直接用；2025 列为人工缓存值 | 全省规下 12530.93、25年7月 12187.25 |

**最容易踩的坑**：《道路货物运输月度生产情况表》(H203-2) 是“吨/吨公里”，《货运量周转量表》是“万吨/万吨公里”，两张表相减前必须先把 H203-2 的数值 ÷10000，否则会差 4 个数量级。

## 7 货运“规上/规下”口径与《规上规下拆分表》说明（2026-09-04 新增，业务口径已确认）

**计算公式（分市州、每个月同式）**
- 规上货运量（万吨）= 《道路货物运输月度生产情况表》(H203-2) 各企业货运量合计 ÷ 10000
- 全口径货运量（万吨）= 《货运量周转量表》当月货运量列
- **规下货运量（万吨）= 全口径 − 规上**
- 货物周转量同理：规上 = H203-2 周转量合计 ÷ 10000；全口径 = 《货运量周转量表》当月周转量列；规下 = 全口径 − 规上
- 全省校验：17 市州相加 = 《货运量周转量表》“湖北省”行 = 汇总表“ 货运”页全省数（2026-07：O5=16285.71、O7=3754.78、O9=12530.93）

**2026-07 验证结果（对照母版《2026年7月道路运输量汇总表.xlsx》“ 货运”页）**
- 规上合计 3754.78、全口径 16285.71、规下合计 12530.93，三数与母版 O7/O5/O9 全等。
- 17 市州规上与母版“规上货运量”列逐一对上（武汉 1227.55、黄石 133.08、荆州 145.22、林区 7.90…）。
- 规下分市州示例：武汉 3713.42、襄阳 2578.93、荆州 869.60、鄂州 108.68、林区 25.67；相加=12530.93。
- 周转量同式也成立：武汉规下周转量 462751.81（=667561.37−204809.56）= 母版 O16。

**《规上规下拆分表》白话解释**
- 它是“规上规下拆分表”Excel 导入后存下来的结果表，一张表里放“规上企业运输量、规下运输量、运输量合计”三块（各带排名、同比），让报表直接取拆分结果、不用每次现算。
- 目前导入的拆分 Excel **只有周转量**，所以表里周转量三列（规上/规下/合计）有数（2026-07 已入库 126 行，period_type=CUMULATIVE 即累计口径），而货运量三列 Excel 里没有、一直是空——**不是程序坏了，是输入文件不含货运量拆分**。
- 如果以后希望它连货运量拆分也存：程序按上面的公式回填即可（SQL 查询 3 已给示例，默认注释不执行）。报表取数方式“实时现算”和“落表取数”选一种即可，避免两处算的不一样。

**落地 SQL**：`docs/生成汇总大表/规下货运量口径_2026-09-04.sql`（查询 1 = 分市州规上/规下货运量与周转量；查询 2 = 全省校验；查询 3 = 可选的回填示例）。

**2025 基准说明（对应 2026-09-03 已拍板项：2025 同期列保留母版缓存值）**
- 全口径 2025 基准：从《货运量周转量表》的去年同月列(last_freight/last_turnover_mXX)取。
- 规上/规下拆分的 2025 基准：库内没有 2025 年的 H203-2 企业月报，只能取汇总表母版 2025 缓存列（T..AP，含规上/规下），已核实 12 个月均有值，方案可行。

## 8 相关文档索引（持续同步）

- `docs/生成汇总大表/页签逻辑关系说明.md`：汇总工作簿 19 页三层结构与勾稽（台账/口径合成/成品）。
- `docs/生成汇总大表/自动生成汇总工作簿落地方案.md`：P0-P7 实施步骤与验收。
- `docs/生成汇总大表/汇总表母版数据体检与待决策清单_2026-09-04.md`：5 个成品页“当月块错用累计值”问题与 A/B 方案。
- `docs/报表生成_关系逻辑与每日进度总表.xlsx`：Sheet1 报表关系、Sheet2 页签口径、Sheet3 待确认、Sheet4 每日进度（唯一进度总表）。
- `docs/生成汇总大表/规下货运量口径_2026-09-04.sql`：货运规下口径落地 SQL（中文表名说明版）。