feat(投资): 投资系统导出新模板按表头解析 + 审核基准缺失保护 + 十堰源文件清理

zhizhijie

2026-09-21 2e6830bcf59c01f29f040652b3e5209a7f21238e

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

@@ -58,9 +58,22 @@
     **导出「按月分目录 + è‡ªåŠ¨å¤‡ä»½ + è¿è¡Œæ—¥å¿—/校验报错」未实现**（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；复现脚本与中间输出已留档（见上）。
@@ -79,3 +92,32 @@
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 å³å¯èŽ·å¾—。