docs: 新增汇总大表软件输出与手工定稿差异报告

xyc

2026-09-21 47a873454ed83a184c55dd7ee904375cee3d7386

 docs/¹¤×÷ÈÕ½á/¹¤×÷ÈÕ½á_2026-09-21.md

@@ -58,17 +58,29 @@
     **导出「按月分目录 + è‡ªåŠ¨å¤‡ä»½ + è¿è¡Œæ—¥å¿—/校验报错」未实现**（Q10 å·²ç­”同意）；
  6. å¯¼å‡ºå‰åŸºæ•°ä½“检（B4）只做了一半：后端 `getLastMidIssues()` **无任何调用方**，前端未消费、无《数据缺失清单》页。

### 5. åå °ç‰©æµæºæ–‡ä»¶æ¸…理（用户「清除掉」）+ æŠ•èµ„系统新模板支持

- **十堰源文件清理（数据处置）**：`docs/投资/输入/物流（物流园区）/8月/湖北省十堰交通物流基础设施投资统计汇总表（月报）（2026å¹´8月）.xls`
  é‡Œçš„武汉段（27 ä¸ªé¡¹ç›®ï¼‰ä¸Žé»„石段（4 ä¸ªé¡¹ç›®ï¼‰ç”¨ Excel COM æ•´è¡Œåˆ é™¤ï¼ˆç¬¬ 11~63 è¡Œï¼‰ï¼Œåªç•™åå °æ®µï¼ˆ7 ä¸ªé¡¹ç›®ï¼‰ï¼›
  åŽŸä»¶å…ˆå¤‡ä»½åˆ° `docs/投资/输出/源文件备份/…_原始含武汉黄石_20260921.xls`。
  é‡å¯¼éªŒè¯ï¼šè¯¥æ–‡ä»¶ç”± **38 æ¡ â†’ 7 æ¡**，8 æœˆç‰©æµ total 128 â†’ 97，库内仍是 152 ä¸ªé¡¹ç›® / 136 æ¡ 2026-08 æœˆåº¦æ•°ï¼ˆä¸å¢žä¸å‡ï¼‰â†’ **残留问题闭环**。
- **投资系统导出新模板**：用户把比对明细表换成《2026å¹´8月投资系统项目明细》（多「项目所处阶段」、少「自年初累计」，列位整体右移）。
  åŽŸå®žçŽ°å†™æ­» 8 åˆ— â†’ æ”¹ä¸º**按表头关键字定位**（`findColByKeywords`），兼容新旧模板；缺列时 `year_cum` ç•™ç©ºè€Œä¸æ˜¯é”™å¡«ã€‚
  æ–°æ¨¡æ¿ 129 æ¡å·²å…¥åº“（`investment_system` 2026-08 = 129，2026-07 = 148 ä¸å—影响），字段逐列抽查一致。
- **审核「基准缺失」保护**：新模板没有「自年初累计」，原 `nvl()` ä¼šæŠŠ NULL å½“ 0 â†’ 100+ æ¡è¯¯æŠ¥ã€‚改为基准为 NULL æ—¶è·³è¿‡å¹¶è®° WARN æ—¥å¿—。
  å®žæµ‹ï¼šRULE_I002 ç”±ã€Œæ¯ä¸ªé¡¹ç›®ä¸€æ¡ã€é™ä¸º **0 æ¡**；RULE_I001 2 æ¡ã€RULE_I003 1 æ¡ã€RULE_I004（存在性）25 æ¡ï¼Œåˆè®¡ 28 æ¡å‡ä¸ºçœŸå®žå·®å¼‚。

## äºŒã€æµ‹è¯•ç»“果摘要

- æœ¬æ¬¡**无代码改动**，无《功能测试报告》（仅有数据核查）。
- è§ã€ŠåŠŸèƒ½æµ‹è¯•æŠ¥å‘Š_投资系统新模板按表头解析与审核基准缺失保护_2026-09-21.md》：**11 æ¡ç”¨ä¾‹é€šè¿‡**（正向 6 / è´Ÿå‘ 1 / å›žå½’ 4）。
- ä¸ŠåŠæ—¥ï¼ˆæ±‡æ€»å¤§è¡¨åŒè½¨åˆ¶å®šä½ï¼‰ï¼šæœ¬æ¬¡**无代码改动**，无《功能测试报告》（仅有数据核查）。
- æ•°æ®æ ¸æŸ¥å£å¾„：全部结果与库内 `h2031_enterprise_monthly` / `passenger_individual_monthly` /
  `city_bus_monthly` / `city_taxi_monthly` / `wyc_order_monthly` çŽ°ç®—值逐位比对，17 å¸‚å·ž Ã— 8 ä¸ªæœˆï¼Œ
  ä¸€è‡´æ€§è¾¾ 1e-9；复现脚本与中间输出已留档（见上）。

## ä¸‰ã€é—留问题与待办

1. **P0-1**：历史同比基数双轨制 â€”— æ–¹æ¡ˆ A（排名页改用母版 2025 é™æ€åˆ—，推荐）/ æ–¹æ¡ˆ B（明细页改现算）
   å¾…用户拍板，**未实施**。
1. **P0-1 å·²è§£å†³**：用户选择方案 A（排名页改用母版 2025 é™æ€åˆ—），已于 2026-09-21 å®žæ–½å¹¶å›žå½’通过，见本文件第六节。
2. **P0-2**：母版依赖 â€”— 9 æœˆå‡ºè¡¨éœ€å…ˆæœ‰æ–°æ¯ç‰ˆï¼›æ–¹æ¡ˆ A（程序自动扩列，2-3 å¤©ï¼‰/ æ–¹æ¡ˆ B（Excel å°å·¥å…·ï¼Œ1 å¤©ï¼‰å¾…拍板。
3. P2：B4 å¯¼å‡ºå‰åŸºæ•°ä½“检 + ã€Šæ•°æ®ç¼ºå¤±æ¸…单》页、D ç»„增速排名措辞、中口径明细 4 æ ¼ `#DIV/0!`、
   ç¼ºæ¯ç‰ˆæç¤ºå®žæµ‹ã€éƒ¨ç½²åŒ…旧母版（用户明确暂不处理）。
@@ -79,3 +91,53 @@
1. æŒ‰ç”¨æˆ·æ‹æ¿çš„方案实施 P0-1（方案 A）并出《功能测试报告》+ åŒé¡µåŒæ¯”一致性回归。
2. P0-2 å…ˆå‡º 9 æœˆæ¯ç‰ˆï¼ˆæ–¹æ¡ˆ B åº”急），再排方案 A çš„扩列器与「7 æœˆæ¯ç‰ˆæ‰© 8 æœˆã€é€æ ¼ diff éªŒè¯ã€‚
3. é…åˆæŽ¥æ‰‹åŒäº‹è¿‡ä¸€éã€Šæ±‡æ€»å¤§è¡¨é—®é¢˜äº¤æŽ¥è¯´æ˜Žã€‹ï¼Œç­”疑并补充遗漏。

---

## äº”、下午追加：全库数据备份（交付给同事）

用户要求「把我的数据备份出来，拷贝给同事」，产出交付包 `_给同事_2026-09-21\`（仓库根，已用包内 `.gitignore` æ•´åŒ…排除入库）：

| æ–‡ä»¶ | è¯´æ˜Ž |
| --- | --- |
| `traffic_audit_full_20260921.sql` | å…¨åº“备份，52,010,797 å­—节（约 49.6 MB），`mysqldump` 8.0.29 å¯¼å‡ºï¼Œå« `CREATE DATABASE` + å…¨ 29 è¡¨ç»“构与数据，共 128,803 è¡Œ |
| `还原说明_2026-09-21.md` | å¤‡ä»½ä¿¡æ¯ / è¿˜åŽŸæ­¥éª¤ï¼ˆA æ•´åº“还原、B å·²æœ‰åº“补数据）/ éªŒè¯æ˜Žç»† / æ³¨æ„äº‹é¡¹ |
| `交接文档_2026-09-21.md` | æ€»äº¤æŽ¥æ–‡æ¡£å‰¯æœ¬ï¼ˆä¸€å¹¶å‘给同事） |

**导出命令**（服务端同版本 mysqldump）：

```
mysqldump --host=127.0.0.1 --port=3308 --user=root --default-character-set=utf8mb4 \
  --single-transaction --routines --triggers --events --hex-blob \
  --databases traffic_audit --result-file=...\traffic_audit_full_20260921.sql
```

**验证**（沿用 2026-09-13 çš„验证口径）：把备份里的库名换成临时库 `traffic_audit_vfy` â†’ å®Œæ•´å¯¼å…¥ â†’ ä¸Žæºåº“逐表 `COUNT(*)` æ¯”对 â†’ æ¯”对后 `DROP DATABASE traffic_audit_vfy`。
结论：**29 å¼ è¡¨å…¨éƒ¨ä¸€è‡´ï¼Œ0 å·®å¼‚**（合计 128,803 è¡Œï¼‰ã€‚关键表：`city_taxi_auth` 85,272 / `h2031_enterprise_monthly` 15,811 / `h2032_enterprise_monthly` 13,056 / `audit_result` 3,393 / `city_bus_monthly` 2,860 / `investment_project` 152 / `investment_monthly` 284 / `freight_turnover_import` 234 â€”— ä¸Žäº¤æŽ¥æ–‡æ¡£ Â§1.2 è®°å½•ä¸€è‡´ã€‚

**留下的临时文件**（未删）：`_tmp/_verify_20260921.sql`（改名后的验证副本，52 MB）、`_tmp/_verify_counts.tsv`（逐表比对结果）、`_tmp/_mk_pkg_20260921.py`、`_tmp/_fix_pkg_doc.py`。

**本次无代码改动**，属数据类工作，故不另出《功能测试报告》。

**待用户确认**：① äº¤ä»˜åŒ…是否需要压缩 zip（50 MB â†’ ä¾¿äºŽå¾®ä¿¡/网盘传输）；② åŒäº‹çŽ¯å¢ƒè‹¥ä¸º MySQL 5.7，需另出一份 5.7 ä¸“用导出；③ æ˜¯å¦éœ€è¦æŠŠ `docs/`（母版、投资源文件）一并打包 â€”— è¯¥éƒ¨åˆ†å·²åœ¨ git ä»“库内，clone å³å¯èŽ·å¾—。

### äº”之补充：10:34 å¤æŸ¥å‘现备份已过期，已重新导出

- ç”¨ `CHECKSUM TABLE` å¤æ£€ 10:17 é‚£ä»½å¤‡ä»½æ—¶å‘现 4 å¼ è¡¨æ ¡éªŒå’Œä¸ä¸€è‡´ï¼Œè¿›ä¸€æ­¥æŸ¥ `COUNT(*)`：`audit_result` 3393→3421、`import_batch` 417→419、`investment_system` 148→277、`investment_monthly` 284→284（行数同但内容变），最后写入时间 10:20~10:22
  â†’ å³ **10:17 å¯¼å‡ºä¹‹åŽï¼Œå¦ä¸€ä¸ªä¼šè¯ï¼ˆæäº¤ 2e6830b）又往库里导入了投资系统数据**，旧备份已过期。
- å·²é‡æ–°å¯¼å‡ºï¼š**10:34:57，52,030,977 å­—节，合计 128,962 è¡Œ**（旧份 128,803 è¡Œï¼‰ï¼Œã€Šè¿˜åŽŸè¯´æ˜Žã€‹å·²æŒ‰æ–°æ•°æ®é‡å†™ï¼ˆå«æ–‡ä»¶ SHA256）。
- é‡æ–°éªŒè¯ï¼ˆä¸‰å±‚，全过）：结构 `CREATE TABLE` 29/29；逐表 `COUNT(*)` 29/29 ä¸€è‡´ï¼›`CHECKSUM TABLE` 29/29 ä¸€è‡´ï¼›`mysqldump --order-by-primary` æœ‰åºå¯¼å‡ºä¸¤ä»½æ•°æ®æ–‡ä»¶ **SHA256 å®Œå…¨ç›¸åŒ**（逐行内容一致）。
- **经验**：备份只是某一时刻的快照，导完之后只要还在导数据/跑审核就旧了；交付前必须最后再导一次。
- æ–°å¢žæ–‡æ¡£ï¼š`docs/工具/数据库备份与还原操作步骤.md`（备份参数说明 / ä¸‰æ­¥éªŒè¯ / è¿˜åŽŸ / å¸¸è§é—®é¢˜ï¼Œå‘½ä»¤å¯ç›´æŽ¥å¤åˆ¶ï¼‰ã€‚

## å…­ã€è¿½åŠ ï¼šP0-1 åŽ†å²åŒæ¯”基数双轨制按方案 A ä¿®å¤

用户选择 **方案 A**（排名页改用母版《中口径明细》2025 é™æ€åˆ—），已完成代码、回归与文档更新。

- ä»£ç ï¼š`ReportExportService.exportPassengerMidRank()` å¢žåŠ æ¯ç‰ˆå·¥ä½œç°¿ä¸Šä¸‹æ–‡é‡è½½ï¼›æ±‡æ€»å¯¼å‡ºå¤ç”¨å†…存母版，独立排名表导出打开对应母版；按表头识别 2025 å¹´é€æœˆåˆ—，读取「总客运量 / æ€»æ—…客周转量」并按 1..N æœˆç´¯è®¡ï¼›å…¨çœåŸºæ•°ç”± 17 å¸‚州求和；静态基数不完整时回退库内现算并写 WARN。
- ç¼–译：`mvn -DskipTests compile` é€šè¿‡ã€‚
- ç”Ÿæˆå›žå½’：2026-08 æ±‡æ€»å¤§è¡¨ï¼›é»„冈客运量累计同比排名/明细均为 `7.641733%`（原 7.744917%）。
- åŒé¡µä¸€è‡´æ€§ï¼š17 å¸‚å·ž Ã— å®¢è¿é‡/周转量的累计值与同比共 68 ä¸ªæ•°å€¼å¯¹å…¨éƒ¨ä¸€è‡´ï¼Œæœ€å¤§ç»å¯¹å·® `2.91e-11`；全省累计值 = Î£17 å¸‚å·žï¼›8 æœˆå½“月同比 34 ä¸ªæ•°å€¼å¯¹æœ€å¤§å·® `5.48e-15`。
- ç‹¬ç«‹ã€Šç”Ÿæˆ_中口径排名.xlsx》也按同一静态口径导出，结果与明细页一致。
- æµ‹è¯•äº§ç‰©ï¼š`_tmp/qa_plan_a_20260921/生成_道路运输量汇总表_202608_方案A.xlsx`、`_tmp/qa_plan_a_20260921/生成_中口径排名_202608_方案A.xlsx`（按约定保留）。
- æµ‹è¯•æŠ¥å‘Šï¼š`docs/功能测试报告/功能测试报告_中口径排名同比基数方案A_2026-09-21.md`。