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

> 口径汇总入口：把“报表生成（城市客运/汇总工作簿）”相关功能的输入表、页签关系、逻辑运算汇总如下。
> 详细展开见两篇专题：`docs/生成汇总大表/页签逻辑关系说明.md`（19 页三层结构与勾稽）、`docs/生成汇总大表/自动生成汇总工作簿落地方案.md`（P0-P7 落地方案）。

## 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）均已覆盖新类型。