docs: 汇总大表验收改按四层口径（母版只作版式来源、不再作等价基线）

zhizhijie

4 天以前 978526b474da9a495554ddc924bd736c52bb549b

 docs/»ã×Ü´ó±íM0°æʽÖؽ¨Æ÷¹æ¸ñ_2026-10-06.md

@@ -99,7 +99,7 @@
## åã€é£Žé™©ä¸Žå¾…确认

1. **待确认：以哪本作扩列蓝本。** å»ºè®®ä»¥ç”¨æˆ·æ‰‹å·¥çš„ 9 æœˆæ¯ç‰ˆä¸ºå‡†ï¼ˆç‰ˆå¼å·²ç”±ç”¨æˆ·å›ºåŒ–）。
2. **待确认：是否一次建成 12 æœˆæ»¡ç‰ˆå¼ã€‚** æ–¹æ¡ˆ v1 å»ºè®®æ»¡ç‰ˆå¼ã€åŽç»­æœˆä»½åªåšã€Œéšè—/置灰未到月份 + ç´¯è®¡é‡ç®— + å¡«å½“月」，可显著降低后续风险；若坚持逐月插入，复杂度与回归成本更高。
2. ~~待确认：是否一次建成 12 æœˆæ»¡ç‰ˆå¼ã€‚~~ **已裁定（2026-10-09）：采用 F10「按月按需扩列」、不预留空列；本项作废，见第十三/十四节。**
3. **母版历史坑要一并覆盖**：母版由 openpyxl å†™å‡ºï¼Œå­˜åœ¨é«˜åŽ‹ç¼©ï¼ˆå·²ç”¨ `ZipSecureFile.setMinInflateRatio` ç»•è¿‡ï¼‰ä¸Žæ®‹ç•™ `<is>` éžæ³•æ ¼ï¼ˆ`normalizeStaleInlineStrings` æ¸…理）两类问题，逐列克隆时需保持这两处处理。
4. **城市客运页参照组是压缩结构**（同比 + 1-X æœˆç´¯è®¡ï¼‰ï¼Œä¸Žå…¶å®ƒé•¿è¡¨é¡µä¸åŒï¼Œéœ€å•ç‹¬è§„则。
5. **跨年开新本（2027）不在 M0 èŒƒå›´**，需另定"新年块"规则。
@@ -110,7 +110,7 @@

| åŒäº‹ä¸“项统计的做法 | ä»–为什么能成立 | æ±‡æ€»å¤§è¡¨çš„对应做法 |
|---|---|---|
| ä¸€ä»½æ¯ç‰ˆï¼ˆ`2026年十一数据.xlsx`），**天为行、年为列** | å¢žé•¿ç»´åº¦æ˜¯ã€Œå¹´ã€ï¼Œä¸€å¹´åŠ ä¸€ç»„列；天数固定 8 | å†»ç»“《道路运输量汇总表_标准母版.xlsx》：**12 ä¸ªæœˆæ»¡ç‰ˆå¼ä¸€æ¬¡åˆ°ä½**，只读 |
| ä¸€ä»½æ¯ç‰ˆï¼ˆ`2026年十一数据.xlsx`），**天为行、年为列** | å¢žé•¿ç»´åº¦æ˜¯ã€Œå¹´ã€ï¼Œä¸€å¹´åŠ ä¸€ç»„列；天数固定 8 | æŒ‰ **F10**「按月按需扩列」：读 N æœˆæ¯ç‰ˆè‡ªåŠ¨äº§å‡º N+1 æœˆç‰ˆå¼ï¼ˆä¸é¢„留空列），母版只当版式来源 |
| æ¯ç‰ˆåŒæ—¶æ˜¯æ•°æ®å®¹å™¨ï¼ˆåŽ†å²å¹´ä»½çš„值就在并排年列里） | åŽ†å²å€¼éšæ¨¡æ¿ä¸€èµ·èµ° | **反过来做**：历史参照值入库，母版只留版式，参照组由 DB å›žå¡« |
| è¡¨å¤´/行标签语义定位（`findYearColumn` / `parseDayIndex`） | åˆ—序变了也能导 | æ–°å¢žé¡µè§„则表 `SummarySheetRule`：按表头认月份组、按行标签认市州/指标，不用硬编码列锚点 |
| æ˜“漂移口径外置成表（`holiday_calendar` / `passenger_coefficient` / `vehicle_adjustment`） | è§„则不散在代码与单元格里 | å‚照年保留组数、排名口径（全省不排名）、周转量系数 B=G+L/2+Q/10、缺数置空规则 å¤–ç½® |
@@ -120,7 +120,7 @@

### 11.2 è½åœ°è·¯çº¿ï¼ˆå››é˜¶æ®µï¼‰

- **阶段 1（= M0，3.5–5 å¤©ï¼‰**：标准母版冻结 + æ»¡ç‰ˆå¼ + è·¨å¹´é‡å»º + é¡µè§„则表。
- **阶段 1（= M0，3.5–5 å¤©ï¼‰**：实现**按月按需扩列器**（读 N æœˆæ¯ç‰ˆ â†’ äº§å‡º N+1 æœˆç‰ˆå¼ï¼Œä¸é¢„留空列）＋ é¡µè§„则表（对齐 F10 / D1）。
  æ–°å¢ž `SummaryLayoutRebuilder` / `SummarySheetRule` / å•æµ‹ã€‚
  å‡ºå£ï¼š7 æœˆå›žå½’ diff=0；9 æœˆå¯¹ç…§æ‰‹å·¥ç‰ˆ diff=0；10 æœˆèµ·å¯ç›´æŽ¥å‡ºè¡¨ã€‚
- **阶段 2（+1–2 å¤©ï¼‰**：把现有三份文件依赖合并为一份。
@@ -223,7 +223,7 @@
| `docs/要求与验收基线清单.md` F10 | **扩列按月按需（加月份才扩列，不预做 12 æœˆæ»¡ç‰ˆï¼‰**；新增列"当月/同比"标题为两行合并单元格，扩列须保留 | âœ… M0 v4 |
| `docs/汇总大表数据驱动改造方案_2026-09-07.md` v1.1 ä¿®è®¢ï¼ˆ2026-09-08 ç”¨æˆ·æ‹æ¿ï¼‰ | æ­£æ–‡"12 æœˆæ»¡ç‰ˆåˆ—版式"建议**作废**；扩列按"每月需增月份时再扩列"执行（=D1 åŽŸå£å¾„） | å·²æ‹æ¿ |

→ æœ¬æ–‡æ¡£ç¬¬ä¹èŠ‚ / ç¬¬åä¸€èŠ‚中"一次建成 12 æœˆæ»¡ç‰ˆå¼"的建议与 F10 å†²çªï¼Œ**待用户裁定**。若沿用既有口径，阶段 1 åº”改为"扩列器按月按需"实现，而非满版式。
→ **已裁定（2026-10-09 ç”¨æˆ·ç¡®è®¤ï¼‰**：沿用既有口径 F10「按月按需」，本文档第九/十一节的"满版式"建议**作废**（上文已就地标注）。

### 13.3 å·²æœ‰çš„ 09-29 æ‰©åˆ—工作产物（本地未入库；`docs/问题汇总/_*.md` å·²è¢« gitignore å‘½ä¸­ï¼‰

@@ -236,4 +236,47 @@

### 13.4 æ¯ç‰ˆç»´æŠ¤ç›®æ ‡ï¼ˆæ—¢æœ‰å£å¾„）

- `docs/待确认_汇总大表数据驱动改造问题清单_2026-09-07.md` A4：**"稳定后母版只当版式模板，月度数据一律程序填"**——与本文档目标一致。
- `docs/待确认_汇总大表数据驱动改造问题清单_2026-09-07.md` A4：**"稳定后母版只当版式模板，月度数据一律程序填"**——与本文档目标一致。
## åå››ã€æœ€ç»ˆæ‰§è¡Œå£å¾„（2026-10-09 ç”¨æˆ·ç¡®è®¤ï¼Œå–代前述冲突表述）

**做法**：本次只做一件事——**把"扩列"变成程序的常规能力**，其余已确认口径一律不动。

| # | åŠ¨ä½œ | ä¾æ® |
|---|---|---|
| 1 | å®žçŽ°**按月按需扩列器**：读 N æœˆæ¯ç‰ˆ â†’ å…‹éš† N+1 æœˆ"值列+同比列"一对 â†’ ç´¯è®¡åˆ—后移 â†’ æ˜¾å¼é‡å†™ç´¯è®¡/累计同比 â†’ åŒæ­¥è¡¨å¤´ï¼ˆä¸¤è¡Œçºµå‘合并标题）与页面标题 â†’ è¾“出（**只到当月、不预留空列**）；同时把结果落盘为下期母版 | F10 / D1 / D2 / ç¡®è®¤å›žæ‰§å…­.4 |
| 2 | ä¸‰æ¡å¿…改点做全：① æ–°æœˆä»½åŒæ¯”公式；② ç´¯è®¡åˆ—枚举补当月；③ **插列右侧 2025/2024/2023 åŽ†å²åŒºå‡ åƒæ¡å…¬å¼å¼•ç”¨ +2** | 09-21 äº¤æŽ¥ Â§5.2 |
| 3 | **先修两处写死的列位置**：`SM_CUR_COL0=2`（2026å¹´1月=C）、`SM_LAST_COL0=21`（2025å¹´1月=V）改为**按表头动态定位**；否则 2025 å—一右移，四张跨页合成页会读错去年基数 | `docs/汇总大表母版扩列配置初稿_2026-09-29.md` ç¬¬äº”节 |
| 4 | ç´¯è®¡åŒæ¯”分母**按表头定位"去年 M æœˆ"列**重写公式（只累加奇数列），不写死列清单；版式对齐改为按表头文字匹配列 | C3 / C4（09-18 é•¿æ•ˆæ–¹æ¡ˆï¼‰ |
| 5 | **同比基准不动**：2025 åˆ—原样保留；库只做校验（B4 åŸºæ•°ä½“检可作校验位），**不切库值**；`_备份_` donor è¿˜åŽŸå…ˆä¿ç•™ä½œå›žå½’对照 | F8 / Q1 / A3 / 09-21 æ–¹æ¡ˆ A |
| 6 | æ¯é¡µè§„则用配置钉死、不靠自动识别；识别不了的页跳过并报告 | é…ç½®åˆç¨¿ Â§å…­.3 |

**验收（沿用既有 E1 / Â§5.4）**

1. 7 æœˆæ¯ç‰ˆæ‰©å‡º 8 æœˆ â†’ ä¸ŽçœŸå®žã€Š2026å¹´8月道路运输量汇总表.xlsx》逐格 diff=0；
2. 8 æœˆæ¯ç‰ˆæ‰©å‡º 9 æœˆ â†’ ä¸Žç”¨æˆ·æ‰‹å·¥ã€Š2026å¹´9月道路运输量汇总表.xlsx》diff=0（`_试做_20260929.xlsx` åªä½œç»“构参考，不作数值真值）；
3. è‡ªæ£€ï¼š`#REF!`=0、8 æœˆåŠä»¥å‰åˆ—逐格未变、累计=1~M æœˆã€ç´¯è®¡åŒæ¯”含 2025 å¹´ç¬¬ M æœˆã€ä¸¤è¡Œåˆå¹¶æ ‡é¢˜ä¿ç•™ã€é”™è¯¯å€¼ä¸å¢žã€‚

**规格来源（2026-10-09 ç”±æœ¬åœ°è¿‡ç¨‹äº§ç‰©è½¬æ­£å…¥åº“）**

- `docs/汇总大表母版扩列规格_2026-09-29.md` / `.csv` â€”— 19 é¡µé€é¡µè§„格（A/B/C ç±»åž‹ã€æœˆä»½å¯¹åˆ—位、累计列、插入位置、数据行范围、标题）
- `docs/汇总大表母版扩列配置初稿_2026-09-29.md` â€”— é€é¡µåˆ—位配置 + ç¡¬å‰æï¼ˆå†™æ­»åˆ—位置）+ å»ºè®®æ–¹æ¡ˆ

**已定（2026-10-09 ç”¨æˆ·ç¡®è®¤ï¼‰**

- **扩列方式：程序扩列**（09-28/09-29 å·²é€‰ï¼Œ2026-10-09 ç”¨æˆ·å†æ¬¡ç¡®è®¤ï¼‰ã€‚⚠️ å­—母陷阱：09-21 äº¤æŽ¥ Â§5.3 çš„"方案 B＝Excel å°å·¥å…·"与 09-28/09-29 å·¥ä½œæ—¥ç»“çš„"方案 B＝扩列器"**字母相反**，后续统一写"**扩列器（程序）**"，不再使用 A/B å­—母。
- **扩列范围 = 8 ä¸ªå¯è§å°è´¦é¡µ**：` è´§è¿`、`班线包车`、`城市客运`、`公交`、`出租`、`网约车`、`轨道、轮渡`、`中口径明细`。
- **4 ä¸ªéšè—é¡µä¿ç•™å¹¶ç»§ç»­éšè—ã€ä¸çº³å…¥æ•°æ®åŠ å·¥**：`公路总客运`、`2025年城市客运量`、`中口径客运量`、`中口径计算过程`（用户 2026-10-09 æ‹æ¿ï¼›ä¾æ® 09-03《自动生成汇总工作簿落地方案》§1）。**不插列、不改公式**（独立 sheet，别的页插列不会带错它们）。本拍板同时消解 09-29 è§„格表把 `中口径客运量` æ ‡ä¸º A ç±»ã€é…ç½®åˆç¨¿æ ‡ä¸º"无 2026 æœˆä»½å¯¹"的矛盾。
- C ç±»**可见**页不扩列：`城市汇总`/`城市分市州`/`中口径分析`/`道路运输周转量` ç”±ç¨‹åºåˆ·æ–°ï¼ˆ`refreshSummaryCumulativeSheets`）；`货运量排名`/`货运周转量排名`/`中口径排名` æŒ‰æ¨¡æ¿å¡«æ•°ã€‚
- æ¯ç‰ˆå®žé™…构成实测（2026-10-09）：**15 ä¸ªå¯è§é¡µç­¾ + 4 ä¸ªéšè—é¡µç­¾**（XML `state="hidden"`，非 veryHidden，右键标签可取消隐藏）。

**落盘与文件管理（2026-10-09 ç”¨æˆ·ç¡®è®¤ï¼›éžå¾…确认项）**

- è½ç›˜ï¼šæ‰©åˆ—产物**先落 `docs/生成汇总大表/输出/`**（命名 `_扩列_YYYYå¹´M月_待确认.xlsx`），**人工确认后**才重命名落盘为当期母版 `{å¹´}å¹´{月}月道路运输量汇总表.xlsx`。
- ç›®å½•åªä¿ç•™**当期一本母版**；历史期移入 `docs/生成汇总大表/归档/`；`2026å¹´8月…_版式原型.xlsx` ä¸€å¹¶å½’档。
- ç‰ˆå¼å‚照件 `生成_道路运输量汇总表.xlsx`：**扩列器跑通后归档**；归档前完成 C4 ä¸¤æ­¥â€”—① æŠŠå‚照件的列宽/隐藏一次性固化进当期母版；② `applySummaryReferenceLayout`（`:3785`）改按**表头文字匹配列**（现为按列序号，一插列即错位）。
- `_备份_*` / `_bak_*`：按 A3 ä¿ç•™åˆ°å›žå½’验证通过后再清理。

**实施要点（实测得出，非决策项）**

- æ¯ç‰ˆ vs å‚照件实测差异：**列宽 320 å¤„、隐藏标记 31 å¤„**不同（` è´§è¿` 77+8、班线包车 109、中口径明细 32+14、中口径排名 17+9 ç­‰ï¼‰â†’ å›ºåŒ–不是空操作。
- `copyColumnWidth`（`ReportExportService.java:1186`）**只复制宽度、不复制 hidden** â†’ æ‰©åˆ—器克隆月份列时须补 hidden，否则新列永远要靠参照件补版式。