docs(汇总大表): M0 规格补第十二节（存储/展示分层与红线）+ 2025 数据现状核验（已在库，遗留口径差异）

zhizhijie

8 天以前 9a6ec0530076fff4fa7fd2a6b4c36ed729b23120

docs(汇总大表): M0 规格补第十二节（存储/展示分层与红线）+ 2025 数据现状核验（已在库，遗留口径差异）

 HANDOFF.md

@@ -4,6 +4,17 @@
> **每天结束时**：把当天进展、踩过的坑、新需求、未完成事项更新到本文件，然后可以放心开新对话。
> **协作约定（2026-08-31）**：说「提交」= æœ¬åœ° commit + æŽ¨é€åˆ°è¿œç«¯ git（origin main，Gitblit），不再只做本地 commit。

## æœ€æ–°ï¼ˆ2026-10-09，zyj çº¿ï¼‰

### 10-09：2025 æ•°æ®çŽ°çŠ¶æ ¸éªŒï¼ˆç»“论：已在库，无需补录）+ M0 è§„格补第十二节

- **核验方式**：只读查询库 `127.0.0.1:3308/traffic_audit`（MySQL 8.0.29），未导入、未修改任何数据。
- **2025-01~12 å„ 12 ä¸ªæœˆé½å…¨**：`city_bus_monthly`、`city_taxi_monthly`、`wyc_order_monthly`、`wyc_total_monthly`、`h2031_enterprise_monthly`、`h2032_enterprise_monthly`、`passenger_individual_monthly`。
- **两张"不以为缺口"的表**：`freight_turnover_import` ä»… 2025-12，但表带 `last_freight_m01..m12` / `last_turnover_m01..m12`，2026 å„期文件自带去年同月值；`scale_split_transport` æ—  2025，但表带 `above/below/total_yoy`，同比已随 2026 å„期入库。
- **修正早前判断**：09-07 æ–¹æ¡ˆæ–‡æ¡£"2025 æœªå…¥åº“"的说法已过期（09-16 åŽè¡¥å½•è¿‡å¤šå¹´åº¦æ•°æ®ï¼‰ï¼›`ReportExportService.java:499 / 558 / 561` ä¸‰å¤„"待 2025 å¹´å®šç¨¿æ•°æ®å¯¼å…¥åŽè‡ªåŠ¨å‡ºçŽ°"的提示条件已不成立。同比取数走库内去年同期（`aggOf(data, year-1, m, "湖北省")`，约 540 è¡Œï¼‰ã€‚
- **遗留的是口径问题，不是缺数据**：中口径排名/明细的 2025 åˆ—仍以母版静态定稿值为准（`readMidDetailLastYearCumulative`，`ReportExportService.java:2745` èµ·ï¼‰ï¼Œæ³¨é‡Šï¼ˆ2686-2689 è¡Œï¼‰è¯´æ˜ŽåŽŸå› æ˜¯"排名页原先查库现算，两者在 2025-03/04 ç½‘约车拆分上不同"。→ éœ€å…ˆåšã€Œåº“内 2025 vs æ¯ç‰ˆ 2025」逐项 diff，交业务确认基准后再决定是否切换读库（切换必须过 diff=0 å›žå½’）。
- **规格更新**：`docs/汇总大表M0版式重建器规格_2026-10-06.md` æ–°å¢žç¬¬åäºŒèŠ‚（三层职责 / ä¸€è¡¨ä¸€ç²’度 / è°ƒæ•´å€¼è¦†ç›–层 / 2025 å®žæµ‹æ ¸éªŒ / ç»“果层可选 / ã€Œæ¯ç‰ˆä¸ç•™æ•°æ®ã€çº¢çº¿ / ä¸Ž M0 çš„依赖顺序）。
- **状态**：本节与规格第十二节均为【待验收】；未改动代码、未导入数据。
## æœ€æ–°ï¼ˆ2026-10-06，zyj çº¿ï¼‰

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

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

@@ -142,3 +142,63 @@
- æ‰“印区、页眉页脚、条件格式、列宽必须逐页核对，是"肉眼版式"最易漏的点。
- ä¸šåŠ¡æ”¹æŒ‡æ ‡è¡Œ/页签/边框属于需求变更，任何方案都要一次适配；本方案把频率从「每月一次」降到「偶尔一次」。
- æ¯ç‰ˆæ”¹ä¸ºåªè¯»ï¼Œå¯é¡ºå¸¦è§„避 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 ç½‘约车拆分**上不同"。
- å¤„置：先做「库内 2025 vs æ¯ç‰ˆ 2025」逐项 diff（中口径 4 ç»„件 Ã— 17 å¸‚å·ž Ã— 12 æœˆ + ç´¯è®¡ï¼‰ï¼Œäº¤ä¸šåŠ¡ç¡®è®¤ä»¥å“ªè¾¹ä¸ºå‡†ï¼Œå†å†³å®šæ˜¯å¦åˆ‡æ¢è¯»åº“。

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

- åŒäº‹åº“里**不存计算结果**：累计、同比、占比、环比均导出时算，Excel å†…表现为公式。
- æˆ‘们可选增加一张结果表，粒度 = æœŸé—´ + é¡µ + æŒ‡æ ‡ + å¸‚å·ž + å½“月/累计；Calc å†™å…¥ã€Filler è¯»å–。
- æ”¶ç›Šï¼šå°è¡¨ä¸Žè·¨é¡µåˆæˆé¡µå…±ç”¨ä¸€å¥—结果；逐格 diff æ—¶èƒ½ç›´æŽ¥åŒºåˆ†ã€Œç®—错」还是「填错」。
- çº¦å®šï¼šæŒ‰æœŸé—´**幂等重算**（先删该期间再插）；显示取整不下沉到库，只在展示层舍入。

### 12.6 è‡ªæ£€çºªå¾‹ï¼ˆçº¢çº¿ï¼‰

> **母版里不允许存在「只有它才有的数据」。**

判定方法：把母版所有值清空后，程序能否重新生成一张完全一致的表？能 â†’ æ•°æ®éƒ½åœ¨åº“；不能 â†’ è¿˜æœ‰æ•°æ®è—åœ¨ Excel é‡Œï¼Œç»§ç»­å¾€åº“里搬。

### 12.7 ä¸Ž M0 çš„关系（依赖顺序）

- 12.4 çš„口径核对不阻塞 M0 é˜¶æ®µ 1（版式重建）。
- M0 é˜¶æ®µ 2「停用 `_备份_` donor è¿˜åŽŸã€çš„数据前提**已基本满足**（2025 å·²åœ¨åº“）；但仍需先关闭 12.4 çš„差异，否则切换取数来源会让数字变动、无法通过 diff=0 å›žå½’。