docs: 增补库表关系/单位换算/货运规上规下口径 + 落地口径 SQL（2026-09-04）

zhizhijie

2026-09-04 b5146d24927b42f458fb6f8a07723673cad269f2

 docs/Éú³É»ã×Ü´ó±í/ÊäÈëÊä³öÓëÂß¼­¹Øϵ×ܱí_2026-09-03.md

@@ -1,7 +1,8 @@
# æŠ¥è¡¨ç”Ÿæˆè¾“入输出与逻辑关系总表（2026-09-03 ç‰ˆï¼‰
# æŠ¥è¡¨ç”Ÿæˆè¾“入输出与逻辑关系总表（2026-09-03 ç‰ˆï¼Œ2026-09-04 å¢žè¡¥ï¼‰

> å£å¾„汇总入口：把“报表生成（城市客运/汇总工作簿）”相关功能的输入表、页签关系、逻辑运算汇总如下。
> è¯¦ç»†å±•å¼€è§ä¸¤ç¯‡ä¸“题：`docs/生成汇总大表/页签逻辑关系说明.md`（19 é¡µä¸‰å±‚结构与勾稽）、`docs/生成汇总大表/自动生成汇总工作簿落地方案.md`（P0-P7 è½åœ°æ–¹æ¡ˆï¼‰ã€‚
> 2026-09-04 å¢žè¡¥ï¼šç¬¬ 5 èŠ‚《程序相关库表总览与相互关系》、第 6 èŠ‚《单位与数值换算规范》、第 7 èŠ‚《货运规上/规下口径与 scale_split_transport è¯´æ˜Žã€‹ï¼›è½åœ° SQL è§ docs/生成汇总大表/规下货运量口径_2026-09-04.sql。

## 1 å…³ç³»æ€»è¡¨

@@ -32,3 +33,77 @@
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 å¢žè¡¥ï¼‰

链路总览：**导入台账层**（业务月报/季报/年报入库）→ **审核层**（规则校验）→ **报表生成层**（单表导出 / æ±‡æ€»å·¥ä½œç°¿ / ç½‘约车拆分）→ è¾“出文件。全部业务导入统一挂 `import_batch_id` å¯å›žæº¯åˆ°æ‰¹æ¬¡ä¸ŽåŽŸå§‹æ–‡ä»¶ã€‚

| åº“表 | çŽ¯èŠ‚ | å‘¨æœŸ | æ•°æ®æ¥æºï¼ˆå¯¼å…¥ç±»åž‹/模板） | å…³é”®å­—段（含单位） | ç”¨é€”与相互关系 |
|---|---|---|---|---|---|
| import_batch | å¯¼å…¥ | - | æ‰€æœ‰å¯¼å…¥å…±ç”¨ | id/batch_no | æ‰¹æ¬¡æ€»è¡¨ï¼›å„业务表.import_batch_id â†’ import_batch.id |
| h2032_enterprise_monthly | å¯¼å…¥å°è´¦ | æœˆ | H203-2 é“路货物运输月度生产情况（模板_交企统H203-2表…xlsx） | region_code(6位区划)、freight_total(**吨**)、turnover_total(**吨公里**) | è§„上企业明细；÷10000 æ±‡æ€»ä¸ºè§„上货运量/周转量（分市州），供货运报表与汇总表“ è´§è¿â€é¡µ |
| transport_auth_vehicle | å¯¼å…¥å°è´¦ | æœˆ | è¿æ”¿è½¦è¾†ï¼ˆæ¨¡æ¿_运政车辆.xlsx；H203-2 ç¬¬äºŒ sheet） | ä¼ä¸š/车辆/吨位 | è§„上企业车辆数核对 |
| h2031_enterprise_monthly | å¯¼å…¥å°è´¦ | æœˆ | H203-1 å…¬è·¯æ—…客运输月度生产情况 | region_code、passenger_total/turnover_total ç­‰ | ç­çº¿åŒ…车台账（企业部分）；分市州公路旅客报表 |
| passenger_individual_monthly | å¯¼å…¥å°è´¦ | æœˆ | ä¸ªä½“客运月报（独立模板） | å¸‚州、客运量/周转量 | ç­çº¿åŒ…车“其中个体”行；公路旅客个体并入总行口径 |
| passenger_auth_vehicle | å¯¼å…¥å°è´¦ | æœˆ | æ—…客运政车辆数（模板；H203-1 ç¬¬äºŒ sheet） | ä¼ä¸š/车辆数/载客位数 | æ—…客车辆核对 |
| h204_vehicle_quarterly | å¯¼å…¥å°è´¦ | å­£ | H204 é“路货运车辆能源消耗情况（官方能耗格式，固定列位解析） | è½¦ç‰Œ/车型/燃料/能耗 | èƒ½è€—季报；h204 æ˜Žç»†ä¸Žè¿æ”¿ä¿¡æ¯åŒæŠ¥è¡¨æœŸäº’斥防重导 |
| h204_auth_vehicle | å¯¼å…¥å°è´¦ | å­£ | èƒ½è€—车辆运政信息（模板_能耗车辆运政信息.xlsx） | è½¦ç‰Œ/车辆类型/燃料类型/标记吨位/准牵引质量 | èƒ½è€—车辆档案 |
| vehicle_track_mileage | å¯¼å…¥å°è´¦ | æœˆ | è½¨è¿¹é‡Œç¨‹ï¼ˆæ¨¡æ¿_轨迹里程.xlsx） | è½¦è¾†/里程 | è¿æ”¿å£å¾„里程轨迹数据 |
| city_bus_monthly | å¯¼å…¥å°è´¦ | æœˆ | åŸŽå¸‚公交月报（城市公共交通月度运营情况，企业级） | region_code、city、passenger_volume/passenger_city/…、rail_*、ferry_* | å…¬äº¤å°è´¦é¡µï¼ˆæ€»é‡/城市内/城乡差）；轨道轮渡扩展列存轨道/轮渡月度数（武汉/黄石） |
| city_taxi_monthly | å¯¼å…¥å°è´¦ | æœˆ | å·¡æ¸¸å‡ºç§Ÿæ±½è½¦è¿è¥æœåŠ¡æƒ…况月报（U402，市州级） | city、passenger_volume/passenger_city、avg_distance ç­‰ | å‡ºç§Ÿå°è´¦é¡µï¼ˆæ€»é‡è¡Œ+其中城市内行）；网约车拆分的巡游占比/平均运距输入 |
| city_taxi_auth | å¯¼å…¥å°è´¦ | æœˆ | å‡ºç§Ÿè½¦è¿æ”¿è½¦è¾†ï¼ˆè½¦è¾†çº§æ˜Žç»†ï¼‰ | è½¦ç‰Œ/档案/道路运输证字号 | è¿è¥è½¦æ•°å¯¹æ¯”；市州归属按证号提取 6 ä½åŒºåˆ’ |
| freight_turnover_import | å¯¼å…¥å°è´¦ | æœˆ | è´§è¿é‡å‘¨è½¬é‡è¡¨ï¼ˆæ¨¡æ¿_货运量周转量.xlsx） | region_name、freight_m01..12（**万吨**）、turnover_m01..12（**万吨公里**）、last_freight/last_turnover_m01..12 | **全口径（规上+规下）总量**+2025 åŽ»å¹´åŒæœˆï¼ˆåˆè®¡å£å¾„）；含“湖北省”行用于校验；17 å¸‚州行求和=全省行 |
| scale_split_transport | å¯¼å…¥å°è´¦/派生 | æœˆ | è§„上规下拆分表（模板_规上规下拆分运输量.xlsx，当月/累计两个 sheet） | region_name、above/below/total_turnover（**万吨公里**，含排名/同比）、above/below/total_freight | å‘¨è½¬é‡çš„规上/规下/合计拆分入库；模板没有货运量列，故三个 freight åˆ—为空（详见第 7 èŠ‚） |
| investment_monthly / investment_project / investment_system | å¯¼å…¥å°è´¦ | æœˆ | æŠ•èµ„月报（客运站场/物流园区等类型）/项目库/投资系统导出 | å¸‚州、项目、金额、进度 | æŠ•èµ„模块审核比对（按月与投资系统导出对账 I004 ç­‰è§„则） |
| audit_rule / audit_run / audit_result / audit_explanation | å®¡æ ¸ | - | å®¡æ ¸å¼•æ“Ž | è§„则编码、批号、命中/通过、解释 | audit_run ä¸€æ¬¡æ‰§è¡Œï¼›audit_result å‘½ä¸­æ˜Žç»†æŒ‚业务表与行号；audit_explanation æ±‡æ€»è¯´æ˜Ž |
| llm_desensitize_map | è¾…助 | - | AI åˆ†æž | åŽŸæ–‡â†’脱敏映射 | å¯¼å‡º AI åˆ†æžæ—¶è„±æ• |
| sys_user / sys_role / sys_dept | ç³»ç»Ÿ | - | - | - | ç™»å½•ä¸Žæ•°æ®æƒé™ï¼ˆçœ/市/县） |

报表生成层不直接产生库表，按“报表项→模板→库表聚合→输出 xlsx”，见第 1 èŠ‚关系总表与 `docs/生成汇总大表/自动生成汇总工作簿落地方案.md`。

## 6 å•ä½ä¸Žæ•°å€¼æ¢ç®—规范（2026-09-04 å¢žè¡¥ï¼Œå‡ç”¨ 2026-07 åº“值与母版逐格验证）

| åº“表字段 | åº“内单位 | æŠ¥è¡¨å•ä½ | æ¢ç®— | 2026-07 éªŒè¯æ ·ä¾‹ |
|---|---|---|---|---|
| h2032.freight_total | å¨ | ä¸‡å¨ | Ã·10000 | æ­¦æ±‰åˆè®¡ 12275499 å¨ â†’ 1227.55 ä¸‡å¨ = æ¯ç‰ˆâ€œè§„上货运量”7月 |
| h2032.turnover_total | å¨å…¬é‡Œ | ä¸‡å¨å…¬é‡Œ | Ã·10000 | æ­¦æ±‰åˆè®¡ 2048095633 å¨å…¬é‡Œ â†’ 204809.56 ä¸‡å¨å…¬é‡Œ = æ¯ç‰ˆâ€œè§„上货物周转量”7月 |
| freight_turnover_import.freight_mXX | ä¸‡å¨ | ä¸‡å¨ | ç›´æŽ¥ä½¿ç”¨ | å…¨çœ O5 = 16285.71 ä¸Žâ€œæ¹–北省”行、17 å¸‚州求和一致 |
| freight_turnover_import.turnover_mXX | ä¸‡å¨å…¬é‡Œ | ä¸‡å¨å…¬é‡Œ | ç›´æŽ¥ä½¿ç”¨ | æ­¦æ±‰ O14 = 667561.37 |
| scale_split_transport.*_turnover | ä¸‡å¨å…¬é‡Œ | ä¸‡å¨å…¬é‡Œ | ç›´æŽ¥ä½¿ç”¨ï¼ˆæ‹†åˆ†æ¨¡æ¿æ•°å€¼ï¼‰ | æ­¦æ±‰ above ç´¯è®¡ 1440570.29=母版 Q15 |
| æ±‡æ€»è¡¨æ¯ç‰ˆå€¼åˆ— C/E/G/I/K/M/O ä¸Ž 2025 åˆ— T..AP | ä¸ŽæŒ‡æ ‡åŒï¼ˆä¸‡å¨/万吨公里…） | åŒå·¦ | ç›´æŽ¥ä½¿ç”¨ï¼›2025 åˆ—为人工缓存值 | å…¨çœè§„下 O9=12530.93、AF9=12187.25（25å¹´7月） |

注意：**freight_turnover_import（万吨/万吨公里）与 h2032（吨/吨公里）单位不同**，跨表相减前必须先对 h2032 Ã·10000，否则会差 4 ä¸ªæ•°é‡çº§ã€‚

## 7 è´§è¿è§„上/规下口径与 scale_split_transport è¯´æ˜Žï¼ˆ2026-09-04 æ–°å¢žï¼Œä¸šåŠ¡å£å¾„已确认）

**口径公式（分市州，逐月同式）**
- è§„上货运量（万吨）= SUM(h2032.freight_total) Ã· 10000
- å…¨å£å¾„货运量（万吨）= freight_turnover_import.freight_m{MM}
- **规下货运量（万吨）= å…¨å£å¾„ âˆ’ è§„上**
- è§„上/规下货物周转量同式：规上=SUM(h2032.turnover_total)÷10000；全口径=freight_turnover_import.turnover_m{MM}；规下=全口径−规上
- å…¨çœæ ¡éªŒï¼š17 å¸‚州求和 = â€œæ¹–北省”行 = æ¯ç‰ˆ O5（货运量）/O6（周转量）；规下全省 = O9/O10

**2026-07 éªŒè¯ç»“果（对母版 docs/生成汇总大表/2026å¹´7月道路运输量汇总表.xlsx“ è´§è¿â€é¡µï¼‰**
- è§„上合计 3754.78（母版 O7）、全口径 16285.71（O5）、规下合计 12530.93（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。

**scale_split_transport å¤§ç™½è¯è¯´æ˜Ž**
- å®ƒå¯¹åº”“规上规下拆分表”的导入结果：一张表存“规上企业运输量、规下运输量、运输量合计”三块（各带排名、同比），供报表生成直接用拆分结果、不用现算。
- ç›®å‰å¯¼å…¥çš„拆分模板（`模板_规上规下拆分运输量.xlsx`）**只有周转量**，所以表里 above/below/total_turnover æœ‰æ•°ï¼ˆ2026-07 å·²å…¥åº“ 126 è¡Œï¼Œperiod_type=CUMULATIVE），而 above/below/total_freight ä¸‰ä¸ªè´§è¿é‡åˆ—模板里没有、一直是 NULL——**不是程序 bug，是输入模板不含货运量**。
- è‹¥ä»¥åŽå¸Œæœ›è¯¥è¡¨ä¹Ÿè£…货运量拆分：程序/脚本可按本节公式回填（SQL å·²ç»™ç¤ºä¾‹ï¼‰ï¼ŒæŠ¥è¡¨å–数既可“实时算”也可“落表取数”，二选一即可，避免两处都算不一致。

**落地 SQL**：`docs/生成汇总大表/规下货运量口径_2026-09-04.sql`（Q1 åˆ†å¸‚州口径、Q2 å…¨çœæ ¡éªŒã€Q3 å¯é€‰çš„ scale_split_transport.freight å›žå¡«ç¤ºä¾‹ï¼Œå›žå¡«é»˜è®¤æ³¨é‡Šä¸æ‰§è¡Œï¼‰ã€‚

**2025 åŸºå‡†è¯´æ˜Žï¼ˆä¸Ž Q2 æ‹æ¿ä¸€è‡´ï¼‰**
- å…¨å£å¾„ 2025 åŸºå‡†ï¼šfreight_turnover_import.last_freight/last_turnover_mXX æœ‰å€¼ã€‚
- è§„上 2025 æ‹†åˆ†ä¸Žè§„下 2025 æ‹†åˆ†ï¼šåº“内 h2032 æœªå¯¼å…¥ 2025，只能取汇总表母版 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。