编辑 | blame | 历史 | 原始文档

报表生成输入输出与逻辑关系总表(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(中文表名说明版)。