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

zhizhijie

2026-09-04 b5146d24927b42f458fb6f8a07723673cad269f2

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

 docs/Éú³É»ã×Ü´ó±í/¹æÏ»õÔËÁ¿¿Ú¾¶_2026-09-04.sql

New file
@@ -0,0 +1,70 @@
-- ============================================================
-- è§„下货运量/周转量口径（2026-09-04 ä¸šåŠ¡ç¡®è®¤ï¼‰
-- å…¬å¼ï¼ˆåˆ†å¸‚州、逐月同式）：
--   è§„上货运量(万吨)   = SUM(h2032_enterprise_monthly.freight_total) / 10000   -- h2032 å•ä½ä¸ºå¨
--   å…¨å£å¾„货运量(万吨) = freight_turnover_import.freight_m{MM}                  -- è¯¥è¡¨å·²æ˜¯ä¸‡å¨
--   è§„下货运量(万吨)   = å…¨å£å¾„ - è§„上
--   å‘¨è½¬é‡åŒå¼ï¼šh2032.turnover_total(吨公里)/10000 = è§„上(万吨公里)；
--               freight_turnover_import.turnover_m{MM} = å…¨å£å¾„(万吨公里)；
--               è§„下 = å…¨å£å¾„ - è§„上
-- å…¨çœæ ¡éªŒï¼š17 å¸‚州求和 = åº“内"湖北省"行 = æ¯ç‰ˆæ±‡æ€»è¡¨" è´§è¿"页(2026-07: O5=16285.71, O7=3754.78, O9=12530.93)
-- æ³¨æ„å•ä½ï¼šè·¨è¡¨ç›¸å‡å‰ h2032 å¿…须先 /10000，否则差 4 ä¸ªæ•°é‡çº§ã€‚
-- ============================================================

-- Q1 åˆ†å¸‚州：规上 / å…¨å£å¾„ / è§„下（货运量+周转量），2026-07 ç¤ºä¾‹
SELECT m.city, ft.freight_m07 AS total_freight_wan,
       ROUND(gs.gs_freight_wan, 4) AS gs_freight_wan,
       ROUND(ft.freight_m07 - gs.gs_freight_wan, 4) AS below_freight_wan,
       ft.turnover_m07 AS total_turnover_wan,
       ROUND(gs.gs_turnover_wan, 4) AS gs_turnover_wan,
       ROUND(ft.turnover_m07 - gs.gs_turnover_wan, 4) AS below_turnover_wan
FROM (
  SELECT '武汉' city, '武汉市' full_name UNION ALL SELECT '黄石','黄石市'
  UNION ALL SELECT '十堰','十堰市' UNION ALL SELECT '宜昌','宜昌市'
  UNION ALL SELECT '襄阳','襄阳市' UNION ALL SELECT '鄂州','鄂州市'
  UNION ALL SELECT '荆门','荆门市' UNION ALL SELECT '孝感','孝感市'
  UNION ALL SELECT '荆州','荆州市' UNION ALL SELECT '黄冈','黄冈市'
  UNION ALL SELECT '咸宁','咸宁市' UNION ALL SELECT '随州','随州市'
  UNION ALL SELECT '恩施','恩施州' UNION ALL SELECT '仙桃','仙桃市'
  UNION ALL SELECT '潜江','潜江市' UNION ALL SELECT '天门','天门市'
  UNION ALL SELECT '林区','林区'
) m
LEFT JOIN freight_turnover_import ft
  ON ft.report_period = '2026-07' AND ft.region_name = m.full_name
LEFT JOIN (
  SELECT CASE
           WHEN region_code LIKE '4201%' THEN '武汉' WHEN region_code LIKE '4202%' THEN '黄石'
           WHEN region_code LIKE '4203%' THEN '十堰' WHEN region_code LIKE '4205%' THEN '宜昌'
           WHEN region_code LIKE '4206%' THEN '襄阳' WHEN region_code LIKE '4207%' THEN '鄂州'
           WHEN region_code LIKE '4208%' THEN '荆门' WHEN region_code LIKE '4209%' THEN '孝感'
           WHEN region_code LIKE '4210%' THEN '荆州' WHEN region_code LIKE '4211%' THEN '黄冈'
           WHEN region_code LIKE '4212%' THEN '咸宁' WHEN region_code LIKE '4213%' THEN '随州'
           WHEN region_code LIKE '4228%' THEN '恩施' WHEN region_code LIKE '429004%' THEN '仙桃'
           WHEN region_code LIKE '429005%' THEN '潜江' WHEN region_code LIKE '429006%' THEN '天门'
           WHEN region_code LIKE '429021%' THEN '林区' END AS city,
         SUM(freight_total) / 10000 AS gs_freight_wan,
         SUM(turnover_total) / 10000 AS gs_turnover_wan
  FROM h2032_enterprise_monthly
  WHERE report_period = '2026-07'
  GROUP BY city
) gs ON gs.city = m.city;

-- Q2 å…¨çœæ ¡éªŒï¼šä¸Žåº“内"湖北省"行及母版 O5/O7/O9 å¯¹è´¦
SELECT
  (SELECT ROUND(SUM(freight_total)/10000, 4) FROM h2032_enterprise_monthly
    WHERE report_period='2026-07' AND (region_code LIKE '42%' OR region_code LIKE '4290%')) AS gs_freight_hb_wan,
  (SELECT ROUND(SUM(turnover_total)/10000, 4) FROM h2032_enterprise_monthly
    WHERE report_period='2026-07' AND (region_code LIKE '42%' OR region_code LIKE '4290%')) AS gs_turnover_hb_wan,
  (SELECT freight_m07 FROM freight_turnover_import
    WHERE report_period='2026-07' AND region_name='湖北省') AS total_freight_hb_wan,
  (SELECT turnover_m07 FROM freight_turnover_import
    WHERE report_period='2026-07' AND region_name='湖北省') AS total_turnover_hb_wan;

-- Q3 å¯é€‰ï¼šæŠŠè´§è¿é‡æ‹†åˆ†å›žå¡«åˆ° scale_split_transport（仅当月口径 MONTHLY è¡Œé€‚用；
--    çŽ°æœ‰ 2026-07 æ•°æ®æ˜¯ CUMULATIVE ç´¯è®¡è¡Œï¼Œéœ€è¦ 1-7 æœˆé€æœˆæ±‚和后再回填，暂不执行）
-- UPDATE scale_split_transport s
-- JOIN (Q1 åˆ†å¸‚州派生结果) d ON d.city = å¸‚州短名
-- SET s.above_scale_freight = d.gs_freight_wan,
--     s.below_scale_freight = d.below_freight_wan,
--     s.total_freight       = d.total_freight_wan
-- WHERE s.report_period='2026-07' AND s.period_type='MONTHLY';

 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。