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

zhizhijie

8 天以前 9a6ec0530076fff4fa7fd2a6b4c36ed729b23120

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

@@ -141,4 +141,64 @@
- 3 ä¸ªéšè—å…¬å¼é¡µä¾èµ–母版现成公式，阶段 1–2 å¿…须原样保留，阶段 4 æ‰è°ˆé‡å»ºã€‚
- æ‰“印区、页眉页脚、条件格式、列宽必须逐页核对，是"肉眼版式"最易漏的点。
- ä¸šåŠ¡æ”¹æŒ‡æ ‡è¡Œ/页签/边框属于需求变更，任何方案都要一次适配；本方案把频率从「每月一次」降到「偶尔一次」。
- æ¯ç‰ˆæ”¹ä¸ºåªè¯»ï¼Œå¯é¡ºå¸¦è§„避 WPS/openpyxl é‡å­˜å¸¦æ¥çš„高压缩与残留 `<is>` éžæ³•æ ¼ä¸¤ç±»åŽ†å²å‘。
- æ¯ç‰ˆæ”¹ä¸ºåªè¯»ï¼Œå¯é¡ºå¸¦è§„避 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 å›žå½’。