docs: 汇总大表软件输出与手工定稿差异复核(930格)

xyc

9 天以前 13c2d363e0d01483393c8576bd85e37f5ce43d58

 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 èŠ‚《货运“规上/规下”口径说明》；落地 SQL è§ docs/生成汇总大表/规下货运量口径_2026-09-04.sql。

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

@@ -32,3 +33,79 @@
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（中文表名说明版）。