docs(汇总大表): 查证既有拍板——同比以母版缓存为准(F8/Q1)、扩列按月按需(F10)，并修正 M0 规格相冲表述

zhizhijie

8 天以前 639b53a3caae5c338a7735f34485dcfc590d5d24

docs(汇总大表): 查证既有拍板——同比以母版缓存为准(F8/Q1)、扩列按月按需(F10)，并修正 M0 规格相冲表述

 HANDOFF.md

@@ -15,6 +15,15 @@
- **遗留的是口径问题，不是缺数据**：中口径排名/明细的 2025 åˆ—仍以母版静态定稿值为准（`readMidDetailLastYearCumulative`，`ReportExportService.java:2745` èµ·ï¼‰ï¼Œæ³¨é‡Šï¼ˆ2686-2689 è¡Œï¼‰è¯´æ˜ŽåŽŸå› æ˜¯"排名页原先查库现算，两者在 2025-03/04 ç½‘约车拆分上不同"。→ éœ€å…ˆåšã€Œåº“内 2025 vs æ¯ç‰ˆ 2025」逐项 diff，交业务确认基准后再决定是否切换读库（切换必须过 diff=0 å›žå½’）。
- **规格更新**：`docs/汇总大表M0版式重建器规格_2026-10-06.md` æ–°å¢žç¬¬åäºŒèŠ‚（三层职责 / ä¸€è¡¨ä¸€ç²’度 / è°ƒæ•´å€¼è¦†ç›–层 / 2025 å®žæµ‹æ ¸éªŒ / ç»“果层可选 / ã€Œæ¯ç‰ˆä¸ç•™æ•°æ®ã€çº¢çº¿ / ä¸Ž M0 çš„依赖顺序）。
- **状态**：本节与规格第十二节均为【待验收】；未改动代码、未导入数据。

### 10-09（2）：查证既有拍板——同比基准以母版缓存为准；扩列按月按需

- **同比基准（用户指出，已查证；先前判断修正）**：2026 ä¸Ž 2025 çš„同比**以母版缓存为准**，库只做校验、不直接替代。出处：`docs/要求与验收基线清单.md` F8（✅ å£å¾„确认）、`docs/确认回执汇总与剩余疑问_汇总大表数据驱动改造_2026-09-07.md` Q1、`docs/汇总大表数据驱动改造方案_2026-09-07.md` ç¬¬ä¹èŠ‚、`docs/待确认_汇总大表数据驱动改造问题清单_2026-09-07.md` A1、`docs/问题汇总/汇总大表问题交接_2026-09-21.md` æ–¹æ¡ˆ A（已实施）。切换唯一前提 = äººå·¥æ ¸å¯¹å¹¶é‡å¯¼ä¸€è‡´ã€‚
  - **修正**：本日上一条"中口径 2025 é—留口径待定"的说法作废；库内 2025 çŽ°ç®—值不得直接替代母版静态定稿值。
- **扩列方式（既有拍板，与 M0 è§„格冲突）**：`docs/要求与验收基线清单.md` F10 = **按月按需扩列，不预做 12 æœˆæ»¡ç‰ˆ**（✅ M0 v4）；改造方案 v1.1（09-08 ç”¨æˆ·æ‹æ¿ï¼‰åŒå£å¾„，正文"12 æœˆæ»¡ç‰ˆåˆ—版式"建议已作废。M0 è§„格第九/十一节的"满版式"建议**待用户裁定**。
- **已有 09-29 æ‰©åˆ—产物（本地未入库）**：`docs/问题汇总/_扩列规格表_2026-09-29.md/.csv`（19 é¡µé€é¡µè§„格）、`_扩列配置初稿_20260929.md/.csv`、`_扩列计划_v3..v10.json`、`_扩列进度_20260929.md`；试做件 `docs/生成汇总大表/2026å¹´9月道路运输量汇总表_试做_20260929.xlsx`（数值未修完，勿用于出表）。
- **规格更新**：`docs/汇总大表M0版式重建器规格_2026-10-06.md` æ–°å¢žç¬¬åä¸‰èŠ‚（既有拍板核验，优先级最高）；并修正 12.4 çš„处置结论。
- **状态**：【待验收】；未改动代码、未导入数据。
## æœ€æ–°ï¼ˆ2026-10-06，zyj çº¿ï¼‰

### 10-06：拉取合并 + éªŒæ”¶é—¨ç¦åˆ†çº§ + æ±‡æ€»å¤§è¡¨ M0 ç«‹é¡¹

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

@@ -183,7 +183,7 @@

- æ—©æœŸ"库里没有 2025 å¹´åŸŽå¸‚客运数据"的注释与提示文案（`ReportExportService.java:499 / 558 / 561`）**已过期**，触发条件不再成立；同比取数走的是库内去年同期（`aggOf(data, year-1, m, "湖北省")`，约 540 è¡Œï¼‰ã€‚
- **真正遗留的是口径问题，不是缺数据**：中口径排名/明细的 2025 åˆ—仍以**母版静态定稿值**为准（`readMidDetailLastYearCumulative`，`ReportExportService.java:2745` èµ·ï¼‰ï¼Œä»£ç æ³¨é‡Šï¼ˆ2686-2689 è¡Œï¼‰è¯´æ˜ŽåŽŸå› â€”—"排名页原先查库现算，两者在 **2025-03/04 ç½‘约车拆分**上不同"。
- å¤„置：先做「库内 2025 vs æ¯ç‰ˆ 2025」逐项 diff（中口径 4 ç»„件 Ã— 17 å¸‚å·ž Ã— 12 æœˆ + ç´¯è®¡ï¼‰ï¼Œäº¤ä¸šåŠ¡ç¡®è®¤ä»¥å“ªè¾¹ä¸ºå‡†ï¼Œå†å†³å®šæ˜¯å¦åˆ‡æ¢è¯»åº“。
- å¤„置（**2026-10-09 ä¿®æ­£**）：该"待确认"判断有误——同比基准已在 2026-09-07 æ‹æ¿ä¸ºã€Œ**母版缓存优先，库仅作校验**」（`docs/要求与验收基线清单.md` F8、确认回执 Q1）；库内 2025 çŽ°ç®—值**不得**直接替代母版静态定稿值，仅当人工核对并重导一致后才切库值。详见第十三节。

### 12.5 ç»“果层（比同事更进一步，可选）

@@ -201,4 +201,39 @@
### 12.7 ä¸Ž M0 çš„关系（依赖顺序）

- 12.4 çš„口径核对不阻塞 M0 é˜¶æ®µ 1（版式重建）。
- M0 é˜¶æ®µ 2「停用 `_备份_` donor è¿˜åŽŸã€çš„数据前提**已基本满足**（2025 å·²åœ¨åº“）；但仍需先关闭 12.4 çš„差异，否则切换取数来源会让数字变动、无法通过 diff=0 å›žå½’。
- M0 é˜¶æ®µ 2「停用 `_备份_` donor è¿˜åŽŸã€çš„数据前提**已基本满足**（2025 å·²åœ¨åº“）；但仍需先关闭 12.4 çš„差异，否则切换取数来源会让数字变动、无法通过 diff=0 å›žå½’。
## åä¸‰ã€æ—¢æœ‰æ‹æ¿æ ¸éªŒï¼ˆ2026-10-09 æŸ¥è¯ï¼‰â€”—本节优先级高于前述各节，冲突以本节为准

### 13.1 åŒæ¯”基准：以母版缓存为准（已确认，不是待定项）

| å‡ºå¤„ | åŽŸæ–‡è¦ç‚¹ | çŠ¶æ€ |
|---|---|---|
| `docs/要求与验收基线清单.md` F8 | 2025 å¹´å‰æ•°æ®ä»¥æ¯ç‰ˆç¼“存为准；**母版缓存优先作同比基准，库只做校验**，人工核对重导一致后才切库值（Q1） | âœ… å£å¾„确认 |
| `docs/确认回执汇总与剩余疑问_汇总大表数据驱动改造_2026-09-07.md` Q1 | ä»¥æ¯ç‰ˆç¼“存为同比基准并仅提示；待人工核对后重导一致再切换为库值（"母版缓存优先，库仅作校验参考"） | å·²ç¡®è®¤ |
| `docs/汇总大表数据驱动改造方案_2026-09-07.md` ç¬¬ä¹èŠ‚ | 2025 å®šç¨¿æ•°æ®"前台导入校验"另立任务；**本期同比一律以母版缓存为基准** | â€” |
| `docs/待确认_汇总大表数据驱动改造问题清单_2026-09-07.md` A1 | 2025 åŠä»¥å‰åŽ†å²åˆ—一律**保留母版缓存、不重算** | â€” |
| `docs/问题汇总/汇总大表问题交接_2026-09-21.md` æ–¹æ¡ˆ A | ä¸­å£å¾„排名取去年同期累计改用母版 2025 é™æ€åˆ—（与中口径明细同源），已实施 | å·²å®žæ–½ |

结论：**库内 2025 çŽ°ç®—值不能直接替代母版 2025 é™æ€å®šç¨¿å€¼**；切换的唯一前提是"人工核对并重导一致"。第十二节 12.4 ä¸­"交业务确认以哪边为准"的表述据此修正（见该节 2026-10-09 ä¿®æ­£è¡Œï¼‰ã€‚

### 13.2 æ‰©åˆ—方式：按月按需（已拍板）——与本文档"满版式"建议冲突

| å‡ºå¤„ | åŽŸæ–‡è¦ç‚¹ | çŠ¶æ€ |
|---|---|---|
| `docs/要求与验收基线清单.md` F10 | **扩列按月按需（加月份才扩列，不预做 12 æœˆæ»¡ç‰ˆï¼‰**；新增列"当月/同比"标题为两行合并单元格，扩列须保留 | âœ… M0 v4 |
| `docs/汇总大表数据驱动改造方案_2026-09-07.md` v1.1 ä¿®è®¢ï¼ˆ2026-09-08 ç”¨æˆ·æ‹æ¿ï¼‰ | æ­£æ–‡"12 æœˆæ»¡ç‰ˆåˆ—版式"建议**作废**；扩列按"每月需增月份时再扩列"执行（=D1 åŽŸå£å¾„） | å·²æ‹æ¿ |

→ æœ¬æ–‡æ¡£ç¬¬ä¹èŠ‚ / ç¬¬åä¸€èŠ‚中"一次建成 12 æœˆæ»¡ç‰ˆå¼"的建议与 F10 å†²çªï¼Œ**待用户裁定**。若沿用既有口径，阶段 1 åº”改为"扩列器按月按需"实现，而非满版式。

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

- `docs/问题汇总/_扩列规格表_2026-09-29.md` / `.csv`：19 é¡µé€é¡µè§„格——类型（A æœˆä»½å¯¹+累计 / B éƒ¨åˆ†æœˆä»½å¯¹ / C æœªè¯†åˆ«æœˆä»½å¯¹ï¼‰ã€å„页月份对列位、累计列、建议插入位置、数据行范围、标题写法。
- `docs/问题汇总/_扩列配置初稿_20260929.md` / `.csv`、`_扩列计划_v3..v10.json`：配置与计划迭代（v10 ä»…剩 `轨道、轮渡` ä¸€é¡µï¼‰ã€‚
- `docs/问题汇总/_扩列进度_20260929.md`：8 æœˆâ†’9 æœˆæ‰©åˆ—进度——8 é¡µå·²æ’列；6 é¡¹å¾…修（表头显示/合并区/累计只到 8 æœˆä¸”多写 +Q/累计同比去年基数只到 8 æœˆ/标题月份未 +1/轨道轮渡需按块分别插列）；若干页插入位置待确认。
- è¯•åšä»¶ `docs/生成汇总大表/2026å¹´9月道路运输量汇总表_试做_20260929.xlsx`（结构可看、数值未修完，勿用于出表）。

→ æœ¬è§„格应与上述产物对齐推进，不再另行设计。

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

- `docs/待确认_汇总大表数据驱动改造问题清单_2026-09-07.md` A4：**"稳定后母版只当版式模板，月度数据一律程序填"**——与本文档目标一致。