docs: 记录 09-22 关机交接快照

xyc

9 天以前 5726d878c3225f6529cbcb786846220ac6b7f599

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

@@ -161,7 +161,27 @@
- **报告**：`docs/功能测试报告/数据比对报告_投资明细表软件生成与人工版_2026-09-22.md`（含 156 æ ¼å…¨é‡æ¸…单 + é€æ¡æ ¸å¯¹ç»“论 + å¤„置建议）。
- **临时脚本（保留）**：`_tmp_diff_invest_0922.py`、`_tmp_dump_invest_full_0922.py`、`_tmp_diff_invest_annot_0922.py`、`_tmp_diff_tables_0922.py`、`_tmp_src_spotcheck_0922.py`、`_tmp_src_spotcheck2_0922.py`、`_tmp_db_probe*_0922.py`、`_tmp_tpl_*_0922.py` åŠå¯¹åº” `_*.txt` è¾“出。

## ä¸ƒã€æ±‡æ€»å¤§è¡¨è½¯ä»¶è¾“出与手工定稿差异复核（2026-08）


## ä¸ƒã€æŠ•èµ„明细表取数修复（第一轮，已编译/重启/端到端验证）

按第六节比对结论动手修了三处"会静默出数"的取数缺陷，并顺带端到端暴露+修复了潜江导入选错历史页签。

- **导出**（`ReportExportService.java`）：
  1. `normInvestName()` å½’一化补标点（半/全角句点、顿号、分号等）→ è†å·žã€Œä¸­å›½ä¾›é”€.公安商贸物流园」可匹配，写入库内 15986/15986/8227.5；
  2. æ–°å¢ž `preferMonthlyCandidate()`：同名多档优先取「当月有数据」的档 â†’ åå °ã€Œå¿«é€’物流产业园二期」改取 id=181，写入 20377/3196/296、竣工 2029；
  3. æ–°å¢ž `logSkippedRows()`：未覆盖行逐行 WARN（`[未覆盖] ç¬¬N行 å¸‚å·ž é¡¹ç›®å â†’ åŽŸå› ` + æŒ‰å¸‚州统计），不再静默结转上期值。
- **导入**（`DataImportService.java`）：
  1. `investHeaderKey()` å…ˆåŽ»å…¨éƒ¨ç©ºç™½ï¼ˆå«æ¢è¡Œ/全角空格）再判定关键词 â†’ å¤©é—¨ H/J/K ä¸‰åˆ—恢复识别，2026-08 å…¥åº“ 16677.7/16677.7/500（原为 0/0/0）；
  2. æ–°å¢ž `investSheetPeriodCellHit()` + è¯„分加权 2000000：按表内报表期（`2026.08.24`）选 sheet，优先于「sheet åå«åŒæœˆã€â†’ æ½œæ±Ÿä¸å†æŠŠ **2018 å¹´**「潜江（8月）」当 2026-08，重导后 2026-08 å…¥åº“「中国虾谷冷链仓储物流园」11947.9/1135/0。
- **验证**：`mvn -o compile` é€šè¿‡ï¼›åœæ—§èµ·æ–°åŽç«¯ï¼ˆ8090 å°±ç»ªï¼‰ï¼›æŽ¥å£é‡å¯¼ + é‡è·‘ 2026-08 å¯¼å‡ºï¼›é€æ ¼æ¯”对**156 æ ¼ â†’ 129 æ ¼**（降 27 æ ¼ï¼šç‰©æµåˆ†é¡¹ç›® 108→91、分市州 15→11、市州汇总 17→11），无新增差异。
- **未覆盖清单（新增能力，来自日志）**：物流 6 è¡Œï¼ˆå…¨éƒ¨æ­¦æ±‰ï¼Œåº“内无当月数据）；客运 12 è¡Œï¼ˆé»„石 1「阳新综合客运枢纽站」、黄冈 9、恩施 1「咸丰县坪坝营旅游客运站」、仙桃 1「仙桃市毛嘴客运站」）。
- **报告**：`docs/功能测试报告/功能测试报告_投资明细表取数修复_2026-09-22.md`。
- **遗留（需拍板/补数）**：① L/D/E/F æ˜¯å¦æŒ‰å½“月覆盖（需《建设阶段归一表》）；② æ­¦æ±‰ç‰©æµã€é»„冈客运 8 æœˆæºæ•°æ®ç¼ºå¤±ï¼›â‘¢ æ½œæ±Ÿ 2026-06/07 æœˆåº¦ä»æ˜¯åŽ†å² sheet é”™å€¼ï¼Œéœ€ç”¨ 6/7 æœˆæºè¡¨é‡å¯¼ï¼ˆ**不要**用 8 æœˆæ–‡ä»¶é‡å¯¼ï¼‰ï¼›â‘£ æœªè¦†ç›–清单目前只进日志，建议按 P1-9 å‡ºã€Šæ ¡éªŒæŠ¥é”™_<年月>.xlsx》或页面提示。
- **数据变更**：仅重导修正了天门、潜江两处 2026-08 æœˆåº¦å€¼ï¼Œæœªåˆ é™¤ä»»ä½•é¡¹ç›®ä¸»æ¡£ã€æœªåŠ¨å…¶ä»–市州/期间；临时脚本与产物保留（`_tmp_*_0922.*`、`_tmp/gen_new_0922/`）。


## å…«ã€æ±‡æ€»å¤§è¡¨è½¯ä»¶è¾“出与手工定稿差异复核（2026-08）

- æ¯”对文件：软件输出 `生成_道路运输量汇总表_2026-08 (5).xlsx`，手工定稿 `2026å¹´8月客运量、货运量定稿.xlsx`。
- æ–¹æ³•ï¼šå…ˆç”¨ Excel COM å¯¹ä¸¤ä»½å‰¯æœ¬å…¨é‡é‡ç®—，再按页签、数据块、行标签、列头做语义对齐后逐格比对，避免读取 XLSX æ—§ç¼“存造成 `#VALUE!` å‡å·®å¼‚。
@@ -170,3 +190,11 @@
- ç»“构差异：城市汇总/城市分市州/中口径分析/中口径排名存在软件多出的 8 æœˆå—或不同布局；两个货运排名页签块顺序相反；城市客运手工多一列 AJ；道路运输周转量手工多 AA/AB ç©ºåˆ—。可比业务数据均已逐块对齐核对。
- ä¸Šç‰ˆæŠ¥å‘Šä¸­çš„ `班线包车` 2019、2020 å¹´åŽ†å²å— `#VALUE!` ç»é‡ç®—确认是缓存假差异，本次已剔除。
- äº¤ä»˜ï¼š`docs/问题汇总/汇总大表_软件输出与手工定稿差异清单_2026-08_20260922.md`，逐格明细 `docs/问题汇总/汇总大表_差异明细_2026-08_20260922.csv`。

## ä¹ã€å…³æœºäº¤æŽ¥å¿«ç…§ï¼ˆ2026-09-22 17:20）

- **git**：拉取并合并公司仓库最新 `db0ee92`（投资明细取数/导入修复 + æ—¥ç»“第七/八节）；合并后本地编译 `mvn -q -DskipTests compile` é€šè¿‡ã€‚关机前将 HANDOFF、本日结快照提交并推送 `origin/main`。
- **运行状态**：dev åŽç«¯ `8090`、前端 `8080` å‡æœªè¿è¡Œï¼Œæœªå‘现对应 Java/Node è¿›ç¨‹ï¼›`backend.log` æœ€åŽå†™å…¥ 09-21 17:29，`frontend.log` æœ€åŽå†™å…¥ 09-21 17:36。MySQL80(`3305`)、MySQL57(`3306`) Running，关机后自动停止，无需手工处理。
- **下次启动**：项目根目录执行 `powershell -NoProfile -ExecutionPolicy Bypass -File start-dev.ps1`；数据库和生成缓存已持久化。
- **保留产物**：汇总大表差异报告/CSV、投资 156→129 æ ¼æŠ¥å‘Šã€`_tmp*_0922.*` ä¸Ž `_tmp/gen_new_0922/` ç­‰å‡ä¿ç•™ï¼Œæœªç»ç¡®è®¤ä¸åˆ é™¤ã€‚
- **下次优先**：P0-2《亿元投资项目》按 Q7 è¿½åˆ—、P0-3 å¯¼å‡ºå‰åŸºæ•°ä½“检、P0-4 2026-09 æ¯ç‰ˆï¼›æŠ•èµ„遗留需补武汉物流/黄冈客运 8 æœˆæºæ•°æ®ã€é‡å¯¼æ½œæ±Ÿ 2026-06/07 åŽ†å²é”™å€¼ã€å°†æœªè¦†ç›–清单落文件或页面。