xyc
3 天以前 488cf7a7127fc137864d4fdeee85942986c05108
docs/»ã×Ü´ó±íM0°æÊ½Öؽ¨Æ÷¹æ¸ñ_2026-10-06.md
@@ -99,8 +99,184 @@
## åã€é£Žé™©ä¸Žå¾…确认
1. **待确认:以哪本作扩列蓝本。** å»ºè®®ä»¥ç”¨æˆ·æ‰‹å·¥çš„ 9 æœˆæ¯ç‰ˆä¸ºå‡†ï¼ˆç‰ˆå¼å·²ç”±ç”¨æˆ·å›ºåŒ–)。
2. **待确认:是否一次建成 12 æœˆæ»¡ç‰ˆå¼ã€‚** æ–¹æ¡ˆ v1 å»ºè®®æ»¡ç‰ˆå¼ã€åŽç»­æœˆä»½åªåšã€Œéšè—/置灰未到月份 + ç´¯è®¡é‡ç®— + å¡«å½“月」,可显著降低后续风险;若坚持逐月插入,复杂度与回归成本更高。
2. ~~待确认:是否一次建成 12 æœˆæ»¡ç‰ˆå¼ã€‚~~ **已裁定(2026-10-09):采用 F10「按月按需扩列」、不预留空列;本项作废,见第十三/十四节。**
3. **母版历史坑要一并覆盖**:母版由 openpyxl å†™å‡ºï¼Œå­˜åœ¨é«˜åŽ‹ç¼©ï¼ˆå·²ç”¨ `ZipSecureFile.setMinInflateRatio` ç»•过)与残留 `<is>` éžæ³•格(`normalizeStaleInlineStrings` æ¸…理)两类问题,逐列克隆时需保持这两处处理。
4. **城市客运页参照组是压缩结构**(同比 + 1-X æœˆç´¯è®¡ï¼‰ï¼Œä¸Žå…¶å®ƒé•¿è¡¨é¡µä¸åŒï¼Œéœ€å•独规则。
5. **跨年开新本(2027)不在 M0 èŒƒå›´**,需另定"新年块"规则。
6. **未覆盖页**:中口径分析等 3 ä¸ªé™æ€é¡µä»æ²¿ç”¨æ¯ç‰ˆé™æ€å†…容,本阶段不改。
6. **未覆盖页**:中口径分析等 3 ä¸ªé™æ€é¡µä»æ²¿ç”¨æ¯ç‰ˆé™æ€å†…容,本阶段不改。
## åä¸€ã€å‚照同事「专项统计」的设计映射与落地路线(2026-10-08)
### 11.1 å¯¹é½è¡¨ï¼šä»–为什么能一个母版,我们对应怎么做
| åŒäº‹ä¸“项统计的做法 | ä»–为什么能成立 | æ±‡æ€»å¤§è¡¨çš„对应做法 |
|---|---|---|
| ä¸€ä»½æ¯ç‰ˆï¼ˆ`2026年十一数据.xlsx`),**天为行、年为列** | å¢žé•¿ç»´åº¦æ˜¯ã€Œå¹´ã€ï¼Œä¸€å¹´åŠ ä¸€ç»„åˆ—ï¼›å¤©æ•°å›ºå®š 8 | æŒ‰ **F10**「按月按需扩列」:读 N æœˆæ¯ç‰ˆè‡ªåŠ¨äº§å‡º N+1 æœˆç‰ˆå¼ï¼ˆä¸é¢„留空列),母版只当版式来源 |
| æ¯ç‰ˆåŒæ—¶æ˜¯æ•°æ®å®¹å™¨ï¼ˆåŽ†å²å¹´ä»½çš„å€¼å°±åœ¨å¹¶æŽ’å¹´åˆ—é‡Œï¼‰ | åŽ†å²å€¼éšæ¨¡æ¿ä¸€èµ·èµ° | **反过来做**:历史参照值入库,母版只留版式,参照组由 DB å›žå¡« |
| è¡¨å¤´/行标签语义定位(`findYearColumn` / `parseDayIndex`) | åˆ—序变了也能导 | æ–°å¢žé¡µè§„则表 `SummarySheetRule`:按表头认月份组、按行标签认市州/指标,不用硬编码列锚点 |
| æ˜“漂移口径外置成表(`holiday_calendar` / `passenger_coefficient` / `vehicle_adjustment`) | è§„则不散在代码与单元格里 | å‚照年保留组数、排名口径(全省不排名)、周转量系数 B=G+L/2+Q/10、缺数置空规则 å¤–ç½® |
| `DECIMAL(30,15)` + `BigDecimal` + æŒ‰ Excel æ˜¾ç¤ºç²¾åº¦å–值 | ç²¾åº¦å£å¾„统一,无浮点尾差 | æ‰¿æŽ¥é•¿æœŸå¾…办「16 å¼ è¡¨ 228 ä¸ª double åˆ—改 DECIMAL + BigDecimal」 |
| å¯¼å…¥ä¸¤é˜¶æ®µç¡®è®¤ + å…¨ç¨‹åªè¯»æ ¸å¯¹ | åŽ†å²æ•°æ®ä¸è¢«è¯¯è¦†ç›– | ç”Ÿæˆå‰å…ˆå‡ºç¼ºæ•°/差异清单,人工确认后再出表(现有 B4 åŸºæ•°ä½“检补齐) |
| è¾“出走模板文件(docx / PNG) | ç‰ˆå¼æ¥æºå•一 | ä¿ç•™çŽ°æœ‰åšæ³•ï¼ˆå¿«æŠ¥æ”¹ `word/document.xml`、JFreeChart å‡º PNG) |
### 11.2 è½åœ°è·¯çº¿ï¼ˆå››é˜¶æ®µï¼‰
- **阶段 1(= M0,3.5–5 å¤©ï¼‰**:实现**按月按需扩列器**(读 N æœˆæ¯ç‰ˆ â†’ äº§å‡º N+1 æœˆç‰ˆå¼ï¼Œä¸é¢„留空列)+ é¡µè§„则表(对齐 F10 / D1)。
  æ–°å¢ž `SummaryLayoutRebuilder` / `SummarySheetRule` / å•测。
  å‡ºå£ï¼š7 æœˆå›žå½’ diff=0;9 æœˆå¯¹ç…§æ‰‹å·¥ç‰ˆ diff=0;10 æœˆèµ·å¯ç›´æŽ¥å‡ºè¡¨ã€‚
- **阶段 2(+1–2 å¤©ï¼‰**:把现有三份文件依赖合并为一份。
  çŽ°çŠ¶ä¾èµ–ï¼šæœˆåº¦æ¯ç‰ˆï¼ˆ`resolveSummaryMother`)+ `_备份_` donor(`resolveSummaryDonor` / `restoreSummaryMonthlyBlocks`)+ ç‰ˆå¼å‚照件(`resolveSummaryLayoutRef`)。
  ç›®æ ‡ï¼šåªç•™ã€Šé“路运输量汇总表_标准母版.xlsx》,参照值从库回填,停用 donor ä¸Žè¿˜åŽŸæœºåˆ¶ã€‚
  å‡ºå£ï¼š`docs/生成汇总大表/` ä¸‹åªå‰© 1 ä¸ªæ¨¡æ¿æ–‡ä»¶ + è¾“出目录(`_bak_*` ç­‰æœ¬åœ°ç•™å­˜ã€ä¸å…¥åº“)。
- **阶段 3(可选,+2–3 å¤©ï¼‰**:母版内用命名区域/占位符标注需填格,程序按名填写;母版被挪列/插行时明确报错。
- **阶段 4(可选,+5–10 å¤©ï¼‰**:把 10 ä¸ªé•¿è¡¨é¡µçš„版式参数化(列组规则 + åˆå¹¶åŒº + åˆ—宽 + æ•°å­—格式 + æ‰“印区),程序从版式定义渲染,母版文件降级为一次性样式提取源;
  3 ä¸ªéšè—å…¬å¼é¡µï¼ˆä¸­å£å¾„计算过程 / 2025年城市客运量 / ä¸­å£å¾„分析)保留文件形态。
### 11.3 ä¸¤æ¡ä¸ç…§æ¬
1. **不把 Excel å½“数据源**:同事那边业务每天填同一形状的 Excel æ–‡ä»¶ï¼›æ±‡æ€»å¤§è¡¨æ•°æ®å¿…须走 DB å¯¼å…¥ + ä¸¤é˜¶æ®µç¡®è®¤ï¼Œä¸èƒ½é€€å›ž"手工填母版"。
2. **必须有「新年组」逻辑**:他的天数是常数(8 å¤©ï¼‰ï¼Œè·¨å¹´åªæ˜¯åŠ ä¸€ç»„å¹´åˆ—ï¼›æˆ‘ä»¬è·¨å¹´è¦æ–°å¢žä¸‹ä¸€å¹´åº¦åˆ—ç»„å¹¶æŠŠå½“å¹´ç»„é™çº§ä¸ºå‚ç…§ç»„ï¼Œè¿™ä¸€æ­¥ä»–æ²¡æœ‰å¯¹åº”å®žçŽ°ã€‚
### 11.4 åº•线与风险
- 3 ä¸ªéšè—å…¬å¼é¡µä¾èµ–母版现成公式,阶段 1–2 å¿…须原样保留,阶段 4 æ‰è°ˆé‡å»ºã€‚
- æ‰“印区、页眉页脚、条件格式、列宽必须逐页核对,是"肉眼版式"最易漏的点。
- ä¸šåŠ¡æ”¹æŒ‡æ ‡è¡Œ/页签/边框属于需求变更,任何方案都要一次适配;本方案把频率从「每月一次」降到「偶尔一次」。
- æ¯ç‰ˆæ”¹ä¸ºåªè¯»ï¼Œå¯é¡ºå¸¦è§„避 WPS/openpyxl é‡å­˜å¸¦æ¥çš„高压缩与残留 `<is>` éžæ³•格两类历史坑。
## åäºŒã€å­˜å‚¨å±‚/展示层约定:参照同事「二维表」模式(2026-10-09)
### 12.1 ä¸‰å±‚职责
- **存储层(DB)**:一张张二维表,键与值明确;存三类内容——原始值、配置值、人工调整值。
- **计算层**:导出时按口径计算(累计、同比、环比、占比、排名)。
- **展示层(Excel)**:只把值和公式按版式摆出来,不承担存储职责。
### 12.2 ã€Œä¸€è¡¨ä¸€ç²’度」约定(示例取自同事的专项统计)
| è¡¨ | ä¸»é”®ï¼ˆç²’度) | å€¼ | ç±»åˆ« |
|---|---|---|---|
| holiday_passenger_flow | å¹´ + æ—¥æœŸ + è¿è¾“方式 | å®¢è¿é‡ | åŽŸå§‹å€¼ |
| holiday_vehicle_flow | å¹´ + æ—¥æœŸ + é“路类别 + è½¦åž‹ | è½¦æµé‡ã€çŽ¯æ¯”åŸºæœŸ | åŽŸå§‹å€¼ |
| holiday_calendar | å¹´ + èŠ‚å‡æ—¥ç±»åž‹ + ç¬¬å‡ æ—¥ | æ—¥æœŸ | é…ç½®å€¼ |
| holiday_passenger_coefficient | å¹´ + æ—¥æœŸç±»åˆ« | å®¢è¿ç³»æ•° | é…ç½®å€¼ |
| holiday_vehicle_adjustment | å¹´ + æ—¥æœŸ | è°ƒæ•´åŽå€¼ + åŽŸå›  | äººå·¥è°ƒæ•´å€¼ |
我们现有导入表同样满足该约定:`city_bus_monthly`(报表期 + åœ°åŒº + ä¼ä¸šï¼‰ã€`city_taxi_monthly`(报表期 + åœ°åŒºï¼‰ã€`freight_turnover_import`(报表期 + åœ°åŒºï¼‰ã€`scale_split_transport`(报表期 + åœ°åŒº + æœˆ/累计)、`h2031_enterprise_monthly`(报表期 + ä¼ä¸šï¼‰ã€`h2032_enterprise_monthly`、`wyc_order_monthly` / `wyc_total_monthly`、`passenger_individual_monthly`。存储层形态是对的。
### 12.3 äººå·¥è°ƒæ•´å€¼ä¸€å¾‹å•独建表(覆盖层)
- æ¨¡å¼ï¼š**原始记录不动**,另表存「覆盖值 + åŽŸå›  + æ—¶é—´ã€ï¼Œå”¯ä¸€é”®ä¸Žæ‰€è¦†ç›–对象一致(参照同事的 `holiday_vehicle_adjustment`)。
- æˆ‘们的适用对象:2025 å‚照值修正、异常站剔除、业务临时改数等。
### 12.4 çŽ°çŠ¶æ ¸éªŒï¼ˆ2026-10-09 å®žæµ‹ï¼Œä¿®æ­£æ—©æœŸåˆ¤æ–­ï¼‰
实测库 `127.0.0.1:3308 / traffic_audit`(MySQL 8.0.29):
| è¡¨ | 2025 æœˆä»½æ•° | ç»“论 |
|---|---|---|
| city_bus_monthly | 12/12 | é½å…¨ |
| city_taxi_monthly | 12/12 | é½å…¨ |
| wyc_order_monthly / wyc_total_monthly | 12/12 | é½å…¨ |
| h2031_enterprise_monthly / h2032_enterprise_monthly | 12/12 | é½å…¨ |
| passenger_individual_monthly | 12/12 | é½å…¨ |
| freight_turnover_import | 1/12(仅 2025-12) | **不构成缺口**:表带 `last_freight_m01..m12` / `last_turnover_m01..m12`,2026 å„期文件自带去年同月值 |
| scale_split_transport | 0/12 | **不构成缺口**:表带 `above/below/total_yoy`,同比已随 2026 å„期入库 |
- æ—©æœŸ"库里没有 2025 å¹´åŸŽå¸‚客运数据"的注释与提示文案(`ReportExportService.java:499 / 558 / 561`)**已过期**,触发条件不再成立;同比取数走的是库内去年同期(`aggOf(data, year-1, m, "湖北省")`,约 540 è¡Œï¼‰ã€‚
- **真正遗留的是口径问题,不是缺数据**:中口径排名/明细的 2025 åˆ—仍以**母版静态定稿值**为准(`readMidDetailLastYearCumulative`,`ReportExportService.java:2745` èµ·ï¼‰ï¼Œä»£ç æ³¨é‡Šï¼ˆ2686-2689 è¡Œï¼‰è¯´æ˜ŽåŽŸå› â€”â€”"排名页原先查库现算,两者在 **2025-03/04 ç½‘约车拆分**上不同"。
- å¤„置(**2026-10-09 ä¿®æ­£**):该"待确认"判断有误——同比基准已在 2026-09-07 æ‹æ¿ä¸ºã€Œ**母版缓存优先,库仅作校验**」(`docs/要求与验收基线清单.md` F8、确认回执 Q1);库内 2025 çŽ°ç®—å€¼**不得**直接替代母版静态定稿值,仅当人工核对并重导一致后才切库值。详见第十三节。
### 12.5 ç»“果层(比同事更进一步,可选)
- åŒäº‹åº“里**不存计算结果**:累计、同比、占比、环比均导出时算,Excel å†…表现为公式。
- æˆ‘们可选增加一张结果表,粒度 = æœŸé—´ + é¡µ + æŒ‡æ ‡ + å¸‚å·ž + å½“月/累计;Calc å†™å…¥ã€Filler è¯»å–。
- æ”¶ç›Šï¼šå°è¡¨ä¸Žè·¨é¡µåˆæˆé¡µå…±ç”¨ä¸€å¥—结果;逐格 diff æ—¶èƒ½ç›´æŽ¥åŒºåˆ†ã€Œç®—错」还是「填错」。
- çº¦å®šï¼šæŒ‰æœŸé—´**幂等重算**(先删该期间再插);显示取整不下沉到库,只在展示层舍入。
### 12.6 è‡ªæ£€çºªå¾‹ï¼ˆçº¢çº¿ï¼‰
> **母版里不允许存在「只有它才有的数据」。**
判定方法:把母版所有值清空后,程序能否重新生成一张完全一致的表?能 â†’ æ•°æ®éƒ½åœ¨åº“;不能 â†’ è¿˜æœ‰æ•°æ®è—åœ¨ Excel é‡Œï¼Œç»§ç»­å¾€åº“里搬。
### 12.7 ä¸Ž M0 çš„关系(依赖顺序)
- 12.4 çš„口径核对不阻塞 M0 é˜¶æ®µ 1(版式重建)。
- 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 åŽŸå£å¾„ï¼‰ | å·²æ‹æ¿ |
→ **已裁定(2026-10-09 ç”¨æˆ·ç¡®è®¤ï¼‰**:沿用既有口径 F10「按月按需」,本文档第九/十一节的"满版式"建议**作废**(上文已就地标注)。
### 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:**"稳定后母版只当版式模板,月度数据一律程序填"**——与本文档目标一致。
## åå››ã€æœ€ç»ˆæ‰§è¡Œå£å¾„(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,否则新列永远要靠参照件补版式。