docs: 汇总大表数据驱动改造——业务拍板回执汇总与改造方案 v1（映射清单/12月满版列版式/里程碑M0-M4）

zhizhijie

2026-09-07 8690b9d77634c1789e410479f94e7111f67126c3

docs: 汇总大表数据驱动改造——业务拍板回执汇总与改造方案 v1（映射清单/12月满版列版式/里程碑M0-M4）

 docs/¹¤×÷ÈÕ½á/¹¤×÷ÈÕ½á_2026-09-07.md

@@ -31,3 +31,16 @@
- æ•°æ®é©±åŠ¨å¡«å……（P2+）跟进：成品页当月块目前走人工修母版，后续接入自动计算；
- è¾“出目录留有本会话临时验证副本 `生成_道路运输量汇总表_2026-07_验证.xlsx`（未入库，待确认后可删）；
- ä»“库工作区仍有历史删除（2 ä¸ª 7月清空测试版 xlsx）与大量 _*.sql/_*.ps1 ä¸´æ—¶æ–‡ä»¶ï¼Œæœªéšæœ¬æ¬¡æäº¤ã€‚

## ä»Šæ—¥å·¥ä½œï¼ˆæ™šé—´ï¼šæ•°æ®é©±åŠ¨æ”¹é€ å¼€å·¥â€”—方案 v1）
1. è¯»å–桌面《确认.docx》并归档拍板结果至 `docs/确认回执汇总与剩余疑问_汇总大表数据驱动改造_2026-09-07.md`（Q1-Q3 å·²ç¡®è®¤ï¼šæ¯ç‰ˆç¼“存优先作同比基准/内部中间表不对外/班线按 docs/公路旅客 æ˜ å°„）。
2. å¤æ ¸ A2（2025 å‚照全年母版均有值，此前为空系全省行公式未缓存所致）与 B4（轨道轮渡在 U203 å…¬äº¤æœˆæŠ¥åŒä¸€è¡¨ï¼ŒimportCityBus å·²è½åº“）。
3. å®žæµ‹æ•°æ®åº“表结构与期间覆盖（city_bus/taxi/freight/scale_split/h2031/个体/wyc å‡ 2026-01~07，h2031 å¦æœ‰ 2026-08）。
4. äº§å‡ºã€Šæ±‡æ€»å¤§è¡¨æ•°æ®é©±åŠ¨è‡ªåŠ¨å¡«è¡¨æ”¹é€ æ–¹æ¡ˆ v1》：docs/汇总大表数据驱动改造方案_2026-09-07.md（架构=取数层 Calc + SummaryFiller；映射清单；12 æœˆæ»¡ç‰ˆåˆ—版式策略；里程碑 M0-M4；风险）。

## æµ‹è¯•ç»“果摘要
- æ— ä»£ç æ”¹åŠ¨ï¼ˆæœ¬æ—¥æ–¹æ¡ˆ/回执文档阶段）；DB å®žæµ‹ç»“果与 7 æœˆæ¯ç‰ˆæ•°å€¼ä¸€è‡´ï¼ˆ2025 å‚照齐全）。

## é—留问题与待办（晚间增补）
- å¾…用户确认方案 v1 åŽè¿›å…¥ M0/M1（12 æœˆæ»¡ç‰ˆæ¯ç‰ˆ + å–数计算服务抽取）。
- ä»Šæ—¥ä¸´æ—¶è„šæœ¬ï¼š_probe*.py/_recheckA2*.py/_q_probe*.sql ç­‰ä¸å…¥åº“。

 docs/´ýÈ·ÈÏ_»ã×Ü´ó±íÊý¾ÝÇý¶¯¸ÄÔìÎÊÌâÇåµ¥_2026-09-07.md

New file
@@ -0,0 +1,56 @@
# æ±‡æ€»å¤§è¡¨â€œæ•°æ®é©±åŠ¨è‡ªåŠ¨å¡«è¡¨â€æ”¹é€ å‰å¾…核对清单（2026-09-07）

背景：计划把《道路运输量汇总表》从“复制母版+备份还原”改造成“读导入数据→按口径自动填当月/累计/同比/排名/占比”。动手前需业务逐条拍板下列疑点，避免映射规则做错返工。请在“结论”列写确认结果或修正口径。

## A ç»„：改造范围与边界

| # | å¾…确认问题 | ä¸ºä½•å½±å“æ”¹é€  | æˆ‘的建议默认口径 | ç»“论 |
|---|---|---|---|---|
| A1 | è‡ªåŠ¨å¡«è¡¨è¦†ç›–哪些内容？ | å†³å®šç¨‹åºæ”¹å“ªäº›æ ¼ã€å“ªäº›æ ¼å­æ°¸è¿œä¸åŠ¨ | åªè¦†ç›– 2026 å¹´åŠ¨æ€å—（当月值列+同比列+累计+累计同比）及 6 ä¸ªæˆå“é¡µå½“月/累计块；2025 åŠä»¥å‰åŽ†å²åˆ—一律保留母版缓存不重算 | |
| A2 | 2025 å¹´å‚照列（同比分母）以什么为准？ | 8 æœˆèµ·æ¯æœˆåŒæ¯”都要 2025-08~12 åŸºå‡†ï¼Œç›®å‰æŠ½æŸ¥å…¬äº¤/出租/网约/中口径等页 2025 ä¸‹åŠå¹´å¤šä¸ºç©ºæˆ–公式 | ä»¥â€œ2025 å®šç¨¿æ•°æ®å¯¼å…¥åº“”为准，未导入月份先留空并在生成时提示缺基准 | |
| A3 | â€œå¤‡ä»½æ¯ç‰ˆè¿˜åŽŸâ€æœºåˆ¶æ”¹é€ åŽæ˜¯å¦ä¿ç•™ï¼Ÿ | ä¸ä¿ç•™åˆ™ä»£ç åˆ é™¤ä¸€æ®µé€»è¾‘；保留则要防旧备份覆盖新值 | æ”¹é€ ä¸Šçº¿æœŸä¿ç•™ä½œå›žå½’对照，验证通过后冻结/删除 | |
| A4 | æ”¹é€ åŽæ¯ç‰ˆè¿˜äººå·¥ç»´æŠ¤å—？ | å†³å®šä»¥åŽæ¯æœˆæ˜¯â€œç‚¹ç”Ÿæˆâ€è¿˜æ˜¯ä»è¦äººæ”¹è¡¨ | ç¨³å®šåŽæ¯ç‰ˆåªå½“版式模板，月度数据一律程序填 | |

## B ç»„：数据源与页签口径

| # | å¾…确认问题 | ä¸ºä½•å½±å“æ”¹é€  | æˆ‘的建议默认口径 | ç»“论 |
|---|---|---|---|---|
| B1 | ` è´§è¿` é¡µï¼ˆè§„上/规下/周转、累计、同比）唯一数据源是哪张导入表？“货运量周转量月报”与“规上规下拆分月报”什么关系、冲突时以谁为准？ | å†³å®šå–数表与优先级 | ä»¥è§„上规下拆分月报为当月数据源，货运量周转量月报用于核对 | |
| B2 | ç­çº¿åŒ…车/公路总客运 é¡µçš„源是 H203-1 å…¬è·¯æ—…客企业月报吗？个体客运（个体户月度生产情况）数据填到哪页哪行？ | å†³å®šå–数表与行列映射 | ä¼ä¸šæœˆæŠ¥â†’班线包车页；个体数据→公路总客运或指定行（待业务给页面样例） | |
| B3 | ä¸­å£å¾„明细/中口径客运量页是“独立导入表”，还是由 ç­çº¿åŒ…车+公交+出租+网约+轨道轮渡 ç»„合公式生成？ | å†³å®šè¯¥é¡µæ˜¯å–数还是计算页 | çŽ°æœ‰å…¬å¼ä¸ºè·¨é¡µç»„合，倾向按公式重算 | |
| B4 | è½¨é“、轮渡：1-5 æœˆæ›¾æ‹æ¿â€œå…ˆé‡‡ç”¨é“路运输量汇总表旧数据、后续导入修正”。修正动作的数据源/模板是什么？6 æœˆåŠä»¥åŽè°æä¾›ã€æ¯æœˆä½•æ—¶å¯¼å…¥ï¼Ÿ | å†³å®šå–数来源与周期 | è‹¥æœ‰æ­£å¼æœˆæŠ¥æ¨¡æ¿åˆ™åŠ å¯¼å…¥ï¼›å¦åˆ™æ˜Žç¡®â€œä»¥é“路运输量汇总表母版人工维护到何时” | |
| B5 | åŸŽå¸‚客运拆分（网约车）：巡游出租月报、网约车订单拆分分别落到“出租”页与“网约车”页的哪几列；拆分表字段（订单数→客运量换算）的口径是否已定？ | å†³å®šæ‹†åˆ†å–数与换算规则 | æŒ‰ç½‘约车拆分模板现有映射，换算系数需业务书面确认 | |
| B6 | åŸŽå¸‚é—´ vs åŸŽå¸‚内：城市汇总/分市州页用的是“城市内”口径；城市间（班线/城际城乡）数据体现在哪些页？两者相加是否应等于“公路客运总量”？ | å†³å®šæˆå“é¡µæ•°æ®å½’集关系 | å…ˆæŒ‰çŽ°æœ‰æ¯ç‰ˆå…¬å¼æ‹†åˆ†æ˜Žç»†ï¼Œå‡º 1 å¼ å£å¾„关系图请业务确认 | |

## C ç»„：成品页统计口径

| # | å¾…确认问题 | ä¸ºä½•å½±å“æ”¹é€  | æˆ‘的建议默认口径 | ç»“论 |
|---|---|---|---|---|
| C1 | æŽ’名：规上/规下/合计三组各自排名；“全省”行是否参与排名？ | å†³å®š RANK é€»è¾‘ | å…¨çœè¡Œä¸æŽ’名；17 å¸‚州参与 | |
| C2 | 0 å€¼/缺报市州是否参与排名与占比？ | å†³å®šæ˜¯å¦å…ˆè¿‡æ»¤ | æœ‰æ•°æ®çš„市州参与；无数据不参与且不占分母（待确认） | |
| C3 | å¢žé€ŸæŽ’名（同比增速）并列、为 0、负数、缺失怎么处理？“增速为 0 éœ€æ ¸å®žâ€è§„则要不要进成品页？ | å†³å®šå¢žé€ŸæŽ’名与提示逻辑 | å¹¶åˆ—同名次；0/负正常参与；缺数不排名 | |
| C4 | â€œå å…¨çœæ¯”重”分母口径：规上列分母=全省规上合计、规下列=全省规下合计、合计列=全省合计？ | å†³å®šå æ¯”公式 | æ˜¯ï¼ˆæŒ‰åˆ—各自分母） | |
| C5 | ä¸­å£å¾„排名/分析 ä¸Žâ€œä¸­å£å¾„客运量”页的关系；分析页四类（公路班线/城际城乡公交/城际城乡出租/网约）合计与分市州口径再确认一遍 | å†³å®šä¸­å£å¾„页取数/计算 | ä»¥ 2026-07 æ¯ç‰ˆå·²ä¿®æ•°å€¼ä¸ºåŸºå‡†åæŽ¨å…¬å¼ | |
| C6 | é“路运输周转量页：B=G+L/2+Q/10 çš„折算系数（2、10）是否长期固定？L ç”¨â€œåŸŽå¸‚内客运总量”还是含城市间？ | å†³å®šè¯¥é¡µå…¬å¼æ˜¯å¦å†™æ­» | ç³»æ•°å›ºå®šå†™æ­»ï¼›L=城市内总量（与 7 æœˆä¸€è‡´ï¼‰ | |
| C7 | åŸŽå¸‚汇总页“总客运量”恒等于 å…¬äº¤+出租车(巡游+网约)+轨道+轮渡？哪几行计入总计（巡游/网约为出租分解行不计入）？ | å†³å®šæ€»è®¡è¡Œå…¬å¼ | æ˜¯ï¼Œæ€»è®¡=公交+出租车+轨道+轮渡（不含分解行） | |

## D ç»„：逐月/跨期与版式

| # | å¾…确认问题 | ä¸ºä½•å½±å“æ”¹é€  | æˆ‘的建议默认口径 | ç»“论 |
|---|---|---|---|---|
| D1 | é€æœˆæ–°å¢žçš„列扩展规则：生成 8 æœˆæ—¶æ˜¯â€œæ¯ç‰ˆå›ºå®šç‰ˆå¼ã€8 æœˆå½“月值放 S/T åˆ—并滚动累计到 1-8”，还是每月给你一份新母版？ | å†³å®šæ‰©åˆ—代码写不写 | ç¨‹åºè‡ªåŠ¨æ‰©åˆ—（当月值列+同比列插入、累计列滚动），以 7→8 æœˆä¸ºè¯•ç‚¹ | |
| D2 | 8 æœˆç”Ÿæˆäº§ç‰©çš„版式请业务给一份期望样表（或确认按“7 æœˆç‰ˆå¼+多两列”扩展） | æ— æ ·è¡¨æ— æ³•å†™æ­»åˆ—位 | å…ˆç”¨ 7 æœˆç‰ˆå¼è‡ªåŠ¨æŽ¨æ–­ï¼Œäº§ç‰©ç»™ä¸šåŠ¡æ ¸å¯¹ | |
| D3 | è·¨å¹´ï¼š2027 å¹´æ˜¯å¦æ¯å¹´æ–°å¼€ä¸€æœ¬ï¼ˆå« 2026 å‚照组）？2026 æ±‡æ€»è¡¨æ˜¯å¦åªåˆ° 2026-12？ | å†³å®šå¹´ä»½åˆ†ç»„与列上限 | æ¯å¹´ä¸€æœ¬ï¼Œå½“前只做 2026 | |
| D4 | ç”Ÿæˆå“ªå‡ ä¸ªæœˆç”±ä»€ä¹ˆå†³å®šï¼šæ•°æ®åº“最大期间？还是用户指定 period？中间缺月怎么办？ | å†³å®šç”Ÿæˆå…¥å£ä¸Žç¼ºæ•°æç¤º | æŒ‡å®š period；1-（period）缺数月份列出提示不静默跳过 | |
| D5 | ç‹¬ç«‹å°è¡¨ï¼ˆè´§è¿åˆ†å¸‚州明细/排名、城市公交明细等）是否继续生成？两套口径需一致 | é¿å…â€œåŒäº‹è¡¨ä¸Žç³»ç»Ÿè¡¨å¯¹ä¸ä¸Šâ€å†å‘生 | å¤§è¡¨ä¸Žç‹¬ç«‹å°è¡¨å…±ç”¨åŒä¸€å¥—取数/计算服务 | |

## E ç»„：验收与异常

| # | å¾…确认问题 | ä¸ºä½•å½±å“æ”¹é€  | æˆ‘的建议默认口径 | ç»“论 |
|---|---|---|---|---|
| E1 | æ”¹é€ éªŒæ”¶åŸºå‡†ï¼šæ˜¯å¦è®¤å¯â€œç¨‹åºç”Ÿæˆ 2026-07 == å½“前已修正母版（逐格 diff=0）”为回归门槛？ | å†³å®šéªŒæ”¶æ ‡å‡† | æ˜¯ï¼Œå…ˆå›žå½’ 7 æœˆï¼Œå†è¿‡ 8 æœˆ | |
| E2 | 8 æœˆçœŸå®žéªŒè¯ï¼šè°ã€æ‹¿ä»€ä¹ˆæ ¸å¯¹ï¼Ÿé€å¸‚州加总=全省？与源月报逐项对齐？ | å†³å®š 8 æœˆéªŒæ”¶æµç¨‹ | ç”ŸæˆåŽæŒ‰â€œæºè¡¨é€é¡¹æŠ½æŸ¥+市州加总核对+同比区间检查”出测试报告 | |
| E3 | ç¼ºæ•°/异常处理：某市州月报缺失时，汇总表留空+提示清单，还是用“规下=合计−规上”倒算补？历史出现过的脏数据（如轨迹测算 1.04E7）如何拦截不进汇总表？ | å†³å®šå¼‚常处理与校验 | ç¼ºæ•°ç•™ç©ºå¹¶åˆ—清单；导入审核不过的数据不允许进入汇总取数 | |

## ä¸‹ä¸€æ­¥
全部确认后，我据此产出《汇总表数据驱动改造方案》（含页签/行列映射清单、取数 SQL、生成流程、分步验证计划），业务确认方案后再动代码。

 docs/»ã×Ü´ó±íÊý¾ÝÇý¶¯¸ÄÔì·½°¸_2026-09-07.md

New file
@@ -0,0 +1,93 @@
# æ±‡æ€»å¤§è¡¨â€œæ•°æ®é©±åŠ¨è‡ªåŠ¨å¡«è¡¨â€æ”¹é€ æ–¹æ¡ˆ v1（2026-09-07）

前置拍板：见 `docs/确认回执汇总与剩余疑问_汇总大表数据驱动改造_2026-09-07.md`（A1–E3、Q1–Q3 å·²å…¨éƒ¨ç¡®è®¤ï¼‰ã€‚本方案据此编写。

## ä¸€ã€ç›®æ ‡
- è®©ã€Šé“路运输量汇总表》从“复制母版+备份还原”变为：**用户点“生成” â†’ ç¨‹åºè¯»å¯¼å…¥åº“数据 â†’ æŒ‰ç¡®è®¤å£å¾„计算 â†’ å¡«å…¥æ¯ç‰ˆç‰ˆå¼ â†’ è¾“出当月/累计/同比/排名/占比全部正确的整本**。
- éªŒæ”¶é—¨æ§›ï¼ˆE1/E2）：
  1. å›žå½’：`生成 2026-07 == å·²ä¿®æ­£æ¯ç‰ˆ`（被填区域逐格 diff=0）；
  2. å®žå¼¹ï¼š`生成 2026-08`，逐市州加总=全省、与源月报逐项对齐、同比区间合理。

## äºŒã€çŽ°çŠ¶ä¸Žå·®è·
- çŽ°çŠ¶ï¼š`exportSummaryWorkbook` = å¤åˆ¶æ¯ç‰ˆ â†’ `restoreSummaryMonthlyBlocks` ç”¨å¤‡ä»½è¿˜åŽŸ â†’ å¹´ä»½åŠ¨æ€åŒ– â†’ è¾“出。月度块全部来自母版静态内容，**不读库、不计算**（A4 å†³å®šæ”¹æŽ‰ï¼‰ã€‚
- å·®è·ï¼šéœ€è¦æ–°å¢žâ€œè¯»åº“计算层”并把结果写到母版对应格；备份还原机制保留到回归通过后删除（A3）。
- æœ‰åˆ©æ¡ä»¶ï¼šè¡¨ç»“æž„/期间已核实（见第五节）；现有 export å°è¡¨ç”Ÿæˆå™¨å·²å®žçŽ°å¤§éƒ¨åˆ†å–数与版式（exportCityBusDetail / exportCityTaxiDetail / exportCityRailFerryDetail / exportCityPassengerSummary / exportPassengerMidDetail / exportFreightRank / exportTurnoverRank / exportWycSplit / exportPassengerCityDetail ç­‰ï¼‰ï¼Œå¯æŠ½å–复用（D5 å£å¾„一致）。

## ä¸‰ã€æ€»ä½“架构
```
数据源（导入表，report_period=YYYY-MM）
  â”œâ”€ city_bus_monthly（U203：公交+轨道+轮渡，含城市内/城际城乡）
  â”œâ”€ city_taxi_monthly（巡游出租 17 å¸‚州）
  â”œâ”€ wyc_order_monthly / wyc_total_monthly（网约车订单+全省pin）
  â”œâ”€ freight_turnover_import（货运量周转量月报：含去年同月列）
  â”œâ”€ scale_split_transport（规上规下拆分月报）
  â”œâ”€ h2031_enterprise_monthly（公路旅客企业 H203-1）
  â””─ passenger_individual_monthly（个体客运）
        â†“ èšåˆ/计算服务（抽取自现有 export é€»è¾‘，供大表与小表共用）
  [PaxCalc] å…¬äº¤/出租/网约/轨道/轮渡 å„口径(总/城市内/城际城乡) Ã— å¸‚å·ž Ã— æœˆ
  [FreightCalc] è§„上/规下/合计 è´§è¿é‡ä¸Žå‘¨è½¬é‡ Ã— å¸‚å·ž Ã— æœˆ
  [MidCalc] ä¸­å£å¾„链路：明细→客运量页→排名/分析（B3/B6/C5）
        â†“ SummaryFiller（按页签/行列映射写回母版版式）
  é“路运输量汇总表_YYYY-MM.xlsx
```
- æŠ½å–çš„ `XxxCalc` è®¡ç®—服务返回“指标×市州×期间×当月/累计”矩阵；独立小表与汇总大表**共用同一套矩阵**（消除两套口径不一致，回应“同事表与系统表对不上”）。

## å››ã€é¡µç­¾æ˜ å°„清单（实现基准；7 æœˆæ•°å€¼å›žç®—对账后再定稿细节）
通用列位（台账类页）：2026 å½“月值 m â†’ åˆ— `2m+1`、当月同比 â†’ `2m+2`、2026 ç´¯è®¡ Q/R；2025 å‚照组从 2025-01 èµ·ï¼ˆæ•´å¹´ 12 æœˆå€¼ä¸ŽåŒæ¯” + ç´¯è®¡ï¼‰ã€‚**城市客运页参照组为压缩结构（同比+1-X月累计），单独定义。**

| é¡µç­¾ | æ•°æ®å—/行 | æ¥æºï¼ˆDB èšåˆ/计算） | å…³é”®å£å¾„（拍板编号） |
|---|---|---|---|
| ` è´§è¿` | R7 è§„上 / R9 è§„下 / R5 åˆè®¡ï¼›R8/R10/R6 å‘¨è½¬ï¼›åŸŽå¸‚块 R11-16；2026 å½“月列 + ç´¯è®¡ | scale_split_transport（above_scale_freight/turnover、below_scale_*、total_*）；freight_turnover_import（合计=freight_mXX/turnover_mXX，去年=last_*_mXX） | B1：合计=两表一致；规下=合计−规上；2025 åŠä»¥å‰ä¿ç•™æ¯ç‰ˆ |
| `公交` | æ¯å¸‚å·ž 4 è¡Œï¼šå®¢è¿é‡/周转量/城市内客运/城市内周转 | city_bus_monthly æŒ‰ region_code æ±‡æ€»å…¬å…±æ±½ç”µè½¦å­—段 | åŸŽå¸‚内=passenger_city/turnover_city |
| `轨道、轮渡` | è½¨é“：武汉/黄石 å®¢è¿+周转；轮渡：武汉 | city_bus_monthly æŒ‰ region æ±‡æ€» rail_*/ferry_* | B4：轨道轮渡在 U203 åŒä¸€è¡¨ |
| `出租` | å·¡æ¸¸å‡ºç§Ÿ 17 å¸‚å·ž å®¢è¿/周转/城市内 | city_taxi_monthly æŒ‰ region æ±‡æ€» | B5：出租=巡游出租月报 |
| `网约车` | å…¨çœ + 17 å¸‚å·ž å®¢è¿/周转 | exportWycSplit ç»“果（wyc_order_monthly + wyc_total_monthly + å·¡æ¸¸æ‹†åˆ†ï¼‰ | B5：订单+pin+巡游拆分 |
| `班线包车` | å…¨çœ/城市客运行 | h2031_enterprise_monthly + passenger_individual_monthly | B2：以 `docs/公路旅客/` æ¨¡æ¿ä¸Žç®€åŒ–说明映射（Q3） |
| `公路总客运` | æ±‡æ€»è¡Œ | ç­çº¿/个体聚合 | B2/B6 |
| `中口径明细/中口径客运量` | 4 ç±»ç»„件×市州 | PaxCalc åŸŽé™…城乡 + ç­çº¿ï¼šç­çº¿åŒ…车、城际城乡公交、城际城乡出租、城际城乡网约 | B3 å…¬å¼é‡ç®—ï¼›B6 åŸŽå¸‚间定义 |
| `中口径排名/中口径分析` | å½“月/累计块 | **只取“中口径客运量”页**生成（C5） | C1 å…¨çœä¸æŽ’名；C4 æŒ‰åˆ—分母 |
| `城市汇总` | æ€»/公交/出租车(巡游+网约)/巡游/网约/轨道/轮渡 | PaxCalc åŸŽå¸‚内合计 | C7：总计=公交+出租车+轨道+轮渡，轨道轮渡全算城市内 |
| `城市分市州` | å®¢è¿å½“月/累计块、周转当月/累计块（B/G/L/Q/V/X + æŽ’名/占比/增速） | PaxCalc åŸŽå¸‚内分市州 + RANK/占比 | C1-C4 |
| `道路运输周转量` | å½“月/累计块 G/L/Q + B | FreightCalc å‘¨è½¬ã€åŸŽå¸‚内客运、中口径客运周转 | C6：B=G+L/2+Q/10 ç³»æ•°æš‚固定 |
| éšè—é¡µï¼ˆ2025 åŸŽå¸‚客运量/中口径计算过程/公路总客运） | ä¿ç•™æ¯ç‰ˆç‰ˆå¼ | ä»…作中间参考，视需要由 Calc å›žå¡« | ä¸ä¸ŽåŠ¨æ€å¡«è¡¨å†²çª |

## äº”、数据现状（已实测库）
- å·²å…¥åº“期间：city_bus/city_taxi/freight_turnover/scale_split/h2031 ä¸ªä½“/wyc å‡ **2026-01 ~ 2026-07**；h2031_enterprise_monthly å¦æœ‰ **2026-08（767 è¡Œï¼‰**。
- ç²’度：city_bus ä¼ä¸šçº§(142 è¡Œ/期)；city_taxi 17 å¸‚å·ž/期；freight_turnover_import 18 è¡Œ/期（全省+17）；scale_split 36 è¡Œ/期（18×月页）；h2031 ä¼ä¸šçº§(~780)；个体 7 è¡Œ/期；wyc å…¨çœ 1 è¡Œ/期（order å«åˆ†å¸‚州订单列）。
- 2025 å‚照：母版各页城市行 2025-01~12 æ•°å€¼é½å…¨ï¼ˆå…¨çœè¡Œä¸ºæ±‚和公式，程序勿依赖无缓存公式值，需自行按城市行求和或读母版缓存列）。

## å…­ã€é€æœˆæ‰©åˆ—策略（D1/D2/D3 è½åœ°å»ºè®®ï¼‰
现状 7 æœˆæ¯ç‰ˆåˆ—结构：2026 ç»„当月值 m→列 2m+1/2m+2，累计在 17/18，**2025 å‚照组从第 20 åˆ—èµ·**；每扩一个月需把 2025+ å‚照组整体右移 2 åˆ—（POI åˆ—插入=复杂操作）。
**建议（M0 ä¸€æ¬¡æ€§è§£å†³ï¼‰**：把当前母版的 2026 ç»„直接扩到 **12 æœˆæ»¡ç‰ˆå¼**（2025 å‚照组右移至全年 12 æœˆç‰ˆç»ˆä½ï¼‰ï¼ŒåŽç»­æ¯æœˆç”Ÿæˆ**不再插入列**，只做三件事：
1. éšè—/置灰 M+1..12 çš„当月值+同比列（或留空，未到月份不填）；
2. ç´¯è®¡åˆ—按 1..M é‡ç®—（公式/值）；
3. å¡« M å½“月值并算同比（分母取 2025-M å‚照，Q1：母版缓存优先、库校验提示）。
- ä¸Ž D3 å¥‘合：2027 å¹´æ–°å¼€ä¸€æœ¬æ—¶ï¼Œ2026 ç»„整体转为“上一年参照组”（固定 12 æœˆç‰ˆå¼ï¼‰ï¼Œ2027 ç»„新增到 12 æœˆæ»¡ç‰ˆã€‚
- 12 æœˆæ»¡ç‰ˆæ¯ç‰ˆç”±ä¸€æ¬¡è„šæœ¬ç”Ÿæˆå¹¶è¯·ä¸šåŠ¡æ ¸å¯¹ç‰ˆå¼åŽä½œä¸ºæ–°æ¯ç‰ˆï¼ˆæ›¿ä»£çŽ° 7 æœˆæ¯ç‰ˆï¼‰ã€‚7 æœˆå›žå½’仍以“已修正 7 æœˆæ¯ç‰ˆâ€æ•°å€¼ä¸ºåŸºå‡†ï¼Œä¸å› ç‰ˆå¼å˜åŒ–改变数值。

## ä¸ƒã€é‡Œç¨‹ç¢‘与验证（每步按 AGENTS å‡ºæµ‹è¯•æŠ¥å‘Šï¼‰
| é‡Œç¨‹ç¢‘ | å†…容 | éªŒè¯/出口 |
|---|---|---|
| M0 | 12 æœˆæ»¡ç‰ˆæ¯ç‰ˆ + åˆ—版式生成器（POI å®žçŽ°â€œå‚照组定版式”重建或一次性列扩展脚本） | 7 æœˆæ¯ç‰ˆæ•°å€¼åœ¨æ–°ç‰ˆå¼ä¸Šä¸å˜ï¼ˆæ•°å€¼ diff=0，仅列位变化），业务确认版式 |
| M1 | æŠ½å– PaxCalc/FreightCalc/MidCalc + å•æµ‹ | 7 æœˆå„页程序计算值 vs å·²ä¿®æ­£æ¯ç‰ˆå¯¹åº”æ ¼ diff=0；逐项对账（如 å…¬äº¤æ­¦æ±‰ åŸŽå¸‚内 2026-07=4198.33、轨道全省=11731.83、规上=3754.7823…） |
| M2 | SummaryFiller v1：按映射写回 å°è´¦+成品页 2026 å½“月/累计/同比/排名/占比 | `生成 2026-07` ä¸Žå·²ä¿®æ­£æ¯ç‰ˆé€æ ¼ diff=0（E1） |
| M3 | 8 æœˆå®žå¼¹ï¼šå¯¼é½ 8 æœˆæ•°æ® â†’ `生成 2026-08` | E2：逐市州加总=全省、源月报逐项对齐、缺数清单生效 |
| M4 | å‰ç«¯â€œç‚¹ç”Ÿæˆâ€å…¥å£/提示、删除备份还原机制（A3）、独立小表下线（D5 å†…部中间表保留） | å›žå½’ 7/8 æœˆä¸å›žå½’；小表入口隐藏，中间表仅内部 |

## å…«ã€æ”¹åŠ¨æ–‡ä»¶é¢„ä¼°
- åŽç«¯æ–°å¢žï¼š`calc/`（PaxCalc、FreightCalc、MidCalc、WyCSplitCalc）、`summary/SummaryFiller`、`SummaryLayout`（页签/行列/列版式定义）、母版列扩展脚本（或版式生成器）。
- åŽç«¯æ”¹é€ ï¼š`ReportExportService.exportSummaryWorkbook` ç”±â€œå¤åˆ¶+还原”改为“复制 â†’ Calc å–æ•° â†’ Filler å†™å€¼ â†’ è¾“出”；删除/冻结 `restoreSummaryMonthlyBlocks`（M4）。
- å‰ç«¯ï¼šæŠ¥è¡¨ç”Ÿæˆç•Œé¢â€œæ±‡æ€»å¤§è¡¨â€æŒ‰é’®èµ°æ–°é€»è¾‘ï¼›M4 å¤„理小表入口。
- æ–‡æ¡£ï¼šæ¯ç‰ˆï¼ˆ12 æœˆæ»¡ç‰ˆï¼‰ã€æ˜ å°„定稿表、测试报告、工作日结。

## ä¹ã€ä¸åš/待外部清单
- 2025 å®šç¨¿æ•°æ®â€œå‰å°å¯¼å…¥æ ¡éªŒâ€æœ¬èº«å¦ç«‹ä»»åŠ¡ï¼ˆQ1 åªå…ˆåšæç¤ºä½ï¼‰ï¼›æœ¬æœŸåŒæ¯”一律以母版缓存为基准。
- è½¨è¿¹æµ‹ç®—/审核类分析数据不进大表（E3）。
- æŠ•èµ„、能耗、年报等页签不在本期自动填表范围（保留母版现状）。
- ç‹¬ç«‹å°è¡¨å¯¹å¤–交付下线（M4），内部中间表保留不展示。

## åã€é£Žé™©
1. å°è´¦åˆ—移动/12 æœˆæ»¡ç‰ˆå¼æ”¹åŠ¨é¢å¤§ï¼ˆåˆå¹¶å•å…ƒæ ¼ã€å…¬å¼å¼•ç”¨ã€æ‰“印区）→ M0 å…ˆå‡ºâ€œç‰ˆå¼å¯¹æ¯”产物”请业务确认再往下。
2. U203 çš„城际城乡(chengxiang)字段与中口径明细组件公式的对应需逐格对账（7 æœˆå›žç®—），可能有口径差。
3. ç½‘约拆分历史口径（B5）需以 7 æœˆå·²æ‹†åˆ†ç»“果锁定输入输出，避免升级后数值漂移。
4. åŸŽå¸‚客运页参照组为压缩结构，与其它台账页不同，单独实现，7 æœˆå¯¹è´¦è¦†ç›–。

 docs/È·ÈÏ»ØÖ´»ã×ÜÓëÊ£ÓàÒÉÎÊ_»ã×Ü´ó±íÊý¾ÝÇý¶¯¸ÄÔì_2026-09-07.md

New file
@@ -0,0 +1,60 @@
# æ±‡æ€»å¤§è¡¨æ•°æ®é©±åŠ¨æ”¹é€ ï¼šç¡®è®¤å›žæ‰§æ±‡æ€»ä¸Žå‰©ä½™ç–‘问（2026-09-07）

业务已在桌面《确认.docx》逐条作答（A1–E3），原始清单见 `docs/待确认_汇总大表数据驱动改造问题清单_2026-09-07.md`。本文件汇总拍板结果、我方复核结论与开工前仍需确认的少量疑问。

## ä¸€ã€å·²æ‹æ¿å£å¾„（汇总）

| ç¼–号 | ç»“论 |
|---|---|
| A1 | è‡ªåŠ¨å¡«è¡¨åªè¦†ç›– 2026 å¹´åŠ¨æ€å—及成品页；2025 å¹´æ•°æ®åŽç»­å‰å°å¯¼å…¥æ ¡éªŒï¼Œä¸Žæ¯ç‰ˆç¼“存一致即可，有差距提示 |
| A2 | æ¯ç‰ˆä¸­ 2025 å¹´åŠä»¥å‰æ•°æ®å‡å­˜åœ¨ï¼ˆå·²å¤æ ¸ï¼Œè§ä¸‹æ–¹è¯´æ˜Žï¼‰ |
| A3 | å¤‡ä»½è¿˜åŽŸæœºåˆ¶ï¼šæ”¹é€ ä¸Šçº¿æœŸä¿ç•™ä½œå›žå½’对照，验证通过后删除 |
| A4 | ä»¥åŽâ€œç‚¹ç”Ÿæˆâ€ï¼Œæ¯ç‰ˆä¸å†äººå·¥ç»´æŠ¤ |
| B1 | è´§è¿å£å¾„：规上+规下货运量=货运量周转量月报“货运量”；规上+规下周转量=该月报“货运周转量”；规下货运量=(规上+规下)−规上；规下周转=(规上+规下周转)−规上周转，且=规上规下拆分月报的规下周转；两表不冲突 |
| B2 | ç­çº¿åŒ…车数据源=公路旅客企业月报(H203-1)+个体月报（此前已多次确认） |
| B3 | ä¸­å£å¾„明细=跨页组合公式重算 |
| B4 | è½¨é“、轮渡数据在公交月报（U203 åŸŽå¸‚公共交通月度运营情况）同一张表内（已核实，见下方说明） |
| B5 | å‡ºç§Ÿ=巡游出租月报汇总；网约车=网约车总数与订单+巡游出租数据拆分（拆分演算此前已做） |
| B6 | åŸŽå¸‚间数据=班线包车+城际城乡公交+城际城乡出租+城际城乡网约，涉及页签：中口径明细/中口径排名/中口径分析/道路运输周转量 |
| C1 | å…¨çœè¡Œä¸æŽ’名 |
| C2 | å„市州基本都有数据（不处理“无数据市州”极端情况，仍保留缺数提示） |
| C3 | å¢žé€Ÿä¸ä¼šä¸º 0/不缺/不并列；若为 0 æˆ–缺视为数据出错（提示人工核实） |
| C4 | å å…¨çœæ¯”重按列各自分母（规上/规下/合计各用各的全省合计） |
| C5 | ä¸­å£å¾„排名/分析只由“中口径客运量”页数据生成 |
| C6 | é“路运输周转量 B=G+L/2+Q/10 ç³»æ•°æš‚时固定（2、10），后续有变动再改 |
| C7 | åŸŽå¸‚汇总“总客运量”=公交+出租车(巡游+网约)的城市内客运量+轨道及轮渡客运量（轨道轮渡全部算作城市内） |
| D1 | ç¨‹åºè‡ªåŠ¨æ‰©åˆ—（当月值列+同比列插入、累计列滚动） |
| D2 | 8 æœˆç‰ˆå¼æŒ‰â€œ7 æœˆç‰ˆå¼+多两列”扩展 |
| D3 | æ¯å¹´æ–°å¼€ä¸€æœ¬ï¼ˆå«ä¸Šä¸€å¹´å‚照组）；2026 æ±‡æ€»è¡¨åªåˆ° 2026-12 |
| D4 | ç”¨æˆ·æŒ‡å®š period；缺数月份列提示清单 |
| D5 | ç‹¬ç«‹å°è¡¨ä¸ç»§ç»­ç”Ÿæˆï¼ˆè§å‰©ä½™ç–‘é—® Q2） |
| E1 | éªŒæ”¶ï¼šå…ˆå›žå½’“生成 2026-07 == å·²ä¿®æ­£æ¯ç‰ˆ diff=0”，再过 8 æœˆ |
| E2 | 8 æœˆéªŒè¯ï¼šç³»ç»Ÿè‡ªåŠ¨ç”Ÿæˆ vs äººå·¥æ¯”对；逐市州加总=全省；与源月报逐项对齐 |
| E3 | ç¼ºæ•°â†’汇总表留空+提示清单；轨迹测算等审核脏数据不进入大表 |

## äºŒã€æˆ‘方复核结论（回答用户 A2/B4 æ—¶çš„存疑）

1. **A2 å¤æ ¸**：此前我用 openpyxl ç›´è¯»ï¼ˆä¸é‡ç®—公式）抽查“全省行”2025 åˆ—，显示为空是误报——母版/备份中：
   - å…¬äº¤/出租/网约车页 2025-08~12（AH/AJ/AL/AN/AP）**城市行均有数值**（例：公交武汉 2025-08=3935.38、2025-09=4943.69…）；
   - â€œå…¨çœè¡Œâ€2025 åˆ—是**跨城市求和公式**（=AH9+AH13+…），Excel/WPS æ‰“开自动重算即有值，openpyxl ç›´è¯»ä¸åˆ°ç¼“存值；
   - ç»“论：**2025 å‚照（含 8-12 æœˆï¼‰åœ¨æ¯ç‰ˆä¸­é½å…¨**，同比分母可用。实现注意：程序如需“2025 å…¨çœåˆè®¡â€åº”自行对城市行求和或读库（勿依赖无缓存公式值）。
2. **B4 å¤æ ¸ï¼ˆè¯»å…¬äº¤æœˆæŠ¥ï¼‰**：公交月报即 U203《城市公共交通月度运营情况》，企业级明细同一行内含三块：公共汽电车（客运量/周转量/平均运距…）、轨道交通（客运量/周转量）、城市客运轮渡（客运量/周转量），还含“城市内”与“城际城乡”字段。程序导入 `DataImportService.importCityBus` å·²æŒ‰è¯¥æ¨¡æ¿è½åº“（CityBusMonthly：passengerCity/turnoverCity、passengerChengxiang/turnoverChengxiang、railPassengerVolume/railTurnover、ferryPassengerVolume/ferryTurnover）。轨道/轮渡台账页只武汉/黄石（轮渡仅武汉）有数据，符合现实。

## ä¸‰ã€å¼€å·¥å‰ä»éœ€ç¡®è®¤ï¼ˆ3 æ¡ï¼Œå·²å°½é‡æ”¶æ•›ï¼‰

| # | ç–‘é—® | å»ºè®®é»˜è®¤å£å¾„（请确认或修正） |
|---|---|---|
| Q1 | A1“2025 å¯¼å…¥æ ¡éªŒä¸Žæ¯ç‰ˆç¼“存一致即可、有差距提示”：不一致时以谁为准？ | ä»¥æ¯ç‰ˆç¼“存为同比基准并仅提示；待人工核对后重导一致再切换为库值。即“母版缓存优先，库仅作校验参考” |
| Q2 | D5“独立小表不继续生成”的范围：`docs/城市客运/生成_城市客运汇总、分市州明细、轨道轮渡分市州明细` è¿™ç±»**中间合成表**是否也不生成？（它们可能是大表取数的中间产物） | å¯¹å¤–交付类小表（货运量分市州明细/排名等）不再生成；若“城市客运汇总/分市州”等中间表是大表自动填表的数据源，则保留为内部计算步骤、不对外展示。请确认哪些属于“数据源中间表” |
| Q3 | B2 ç­çº¿åŒ…车页的行义落位：企业月报(H203-1)与个体月报在“公路总客运/班线包车”页分别对应哪些行（如 H203-1 æ±‡æ€»â†’班线包车、个体→个体运输行）？ | è‹¥ä¸æƒ³é€è¡Œè§£é‡Šï¼Œå¯ç¡®è®¤â€œæŒ‰ `docs/公路旅客/` ä¸‹æ¨¡æ¿ä¸Žç®€åŒ–说明文档（公路旅客简化工作.xlsx、公路客运简化.docx）为准做映射”，实现阶段如遇歧义再单独对 |

## å››ã€ä¸‹ä¸€æ­¥ï¼ˆç¡®è®¤ Q1-Q3 åŽï¼‰
1. æˆ‘出《汇总表数据驱动改造方案》：页签/行列映射清单、取数链路（U203→城市客运→中口径明细→中口径客运量→排名/分析/道路运输周转量；货运两表→货运页→排名页）、扩列与同比规则、分步验证（先 7 æœˆå›žå½’、后 8 æœˆçœŸå®žéªŒè¯ï¼‰ï¼›
2. æ–¹æ¡ˆç¡®è®¤åŽåŠ¨ä»£ç ï¼ˆå…ˆè¡¥ä¸­é—´å±‚取数与计算服务，再接 exportSummaryWorkbook）。

## äº”、Q1–Q3 ç”¨æˆ·è¡¥å……确认（2026-09-07，已全部拍板）
- **Q1**：母版缓存优先作同比基准，库只做校验；人工核对重导一致后才切换为库值。
- **Q2**：内部中间合成表“内部计算不对外”（保留为取数中间步骤，不对外交付）；对外交付类独立小表不再生成。
- **Q3**：班线包车映射以 `docs/公路旅客/` æ¨¡æ¿ä¸Žç®€åŒ–说明文档为准，实现遇歧义再单独核对。

→ å¾…确认项已清零。开工顺序：① å‡ºã€Šæ”¹é€ æ–¹æ¡ˆï¼ˆæ˜ å°„清单/取数链路/分步验证）》→ â‘¡ æ–¹æ¡ˆç¡®è®¤ â†’ â‘¢ åŠ¨ä»£ç ã€‚