Merge remote-tracking branch 'origin/main'

xyc

9 天以前 71a77e721619e956cab116be691cc3ab58e18093

 docs/½»½ÓÎĵµ_2026-09-21.md

@@ -11,12 +11,13 @@
## 0. å…ˆè¯»è¿™ä¸€é¡µï¼ˆæŽ¥æ‰‹çš„第 1 å°æ—¶ï¼‰

1. **先把系统跑起来**，再谈改代码。见 Â§7.1（一键脚本，必须在沙箱外执行）。
2. **当前最紧急的 4 ä»¶äº‹**（详见 Â§4 P0）：① ã€Šäº¿å…ƒæŠ•èµ„项目》月份列每月覆盖上月（用户 Q7 è¦çš„「加一列」未做）；
   â‘¡ å¯¼å‡ºå‰ã€ŒåŸºæ•°ä½“检 + å¼¹çª— +《数据缺失清单》页」只做了一半；③ ç¼º 2026-06 / 2026-09 æ¯ç‰ˆï¼Œé‚£ä¸¤æœŸå‡ºä¸äº†è¡¨ï¼›
   â‘£ æ±‡æ€»å¤§è¡¨ã€Œä¸­å£å¾„排名 vs ä¸­å£å¾„明细」历史同比基数双轨制（16 ä¸ªå¸‚州有差）。
   > åŽŸã€Œ8 æœˆåå °ç‰©æµæºæ–‡ä»¶å«éžåå °æ®µã€å·²äºŽ 2026-09-21 é—­çŽ¯ï¼Œè§ Â§4 P0-1。
2. **当前最紧急的 3 ä»¶äº‹**（详见 Â§4 P0）：① ã€Šäº¿å…ƒæŠ•èµ„项目》月份列每月覆盖上月（用户 Q7 è¦çš„「加一列」未做）；
   â‘¡ å¯¼å‡ºå‰ã€ŒåŸºæ•°ä½“检 + å¼¹çª— +《数据缺失清单》页」只做了一半；③ ç¼º 2026-06 / 2026-09 æ¯ç‰ˆï¼Œé‚£ä¸¤æœŸå‡ºä¸äº†è¡¨ã€‚
   > å·²é—­çŽ¯ï¼ˆä¸å¿…再查）：**8 æœˆåå °ç‰©æµæºæ–‡ä»¶å«éžåå °æ®µ**（2026-09-21，见 Â§4 P0-1）；
   > **中口径排名历史同比基数双轨制**（2026-09-21 åŒäº‹æŒ‰æ–¹æ¡ˆ A å®žçŽ°ï¼Œcommit `abf468c`，见 Â§4 P1-1）；
   > **导出缓存**（2026-09-22 è½ç›˜ + æ•°æ®æŒ‡çº¹ + å¤±æ•ˆæç¤ºï¼Œè§ Â§4 P2-6）。
3. **别自己拍板业务口径**，第 5 ç« åˆ—的是必须业务确认的事。
4. æ”¹å®Œå¿…须：写《功能测试报告》→ æ›´æ–°ã€Šå·¥ä½œæ—¥ç»“》→ åŒä»“库推送（§7.4）。这是本项目的硬规矩。
4. æ”¹å®Œå¿…须：写《功能测试报告》→ æ›´æ–°ã€Šå·¥ä½œæ—¥ç»“》→ æŽ¨é€åˆ°å…¬å¸ gitea（`origin`，§7.4）。这是本项目的硬规矩。

---

@@ -56,7 +57,7 @@
| --- | --- |
| å·¥ä½œåŒº | `D:\文档\ChatGPT\traffic-audit`，分支 `main` |
| HEAD | `a08c70d feat(投资): å¸‚州月报统一填报模板 + åŽ¿(市、区)列解析 + è¡¨å¤´è¡Œåˆ¤å®šæ”¶ç´§` |
| ä¸ªäººè¿œç«¯ | `origin` â†’ `https://gitee.com/zhizhijie/traffic-audit.git`（分支 `master`） |
| è¿œç«¯ï¼ˆå”¯ä¸€ï¼‰ | `origin` â†’ `http://61.183.254.94:3000/r/trafficAudit.git`（分支 `main`，账号 zyj）——2026-09-21 èµ·**只用公司 gitea å•ä»“库**，个人 gitee å·²å¼ƒç”¨ï¼›æ—§çš„ `gitea` åˆ«åæŒ‡å‘同一地址，可用可删 |
| å…¬å¸è¿œç«¯ | `gitea` â†’ `http://61.183.254.94:3000/r/trafficAudit.git`（分支 `main`，账号 zyj） |
| å·¥ä½œåŒºçŠ¶æ€ | å¹²å‡€ï¼ˆäº¤æŽ¥æ–‡æ¡£ã€æ±‡æ€»å¤§è¡¨é—®é¢˜äº¤æŽ¥ã€æ—¥ç»“、投资系统新模板支持均已提交并推送两端） |

@@ -194,7 +195,7 @@

| # | äº‹é¡¹ | è¯´æ˜Ž | çŠ¶æ€ |
| --- | --- | --- | --- |
| P1-1 | ä¸­å£å¾„排名 vs ä¸­å£å¾„明细「历史同期基数双轨制」 | é™¤æ­¦æ±‰å¤– 16 ä¸ªå¸‚州累计同比都有差（黄冈 7.74% vs 7.64%）；根因是母版 2025 å¹´ 3、4 æœˆç½‘约车拆分用了一套与出租列自相矛盾的旧输入。**方案 A å·²å®žæ–½å¹¶å›žå½’：排名页改用母版 2025 é™æ€åˆ—**；黄冈 1-8 æœˆç´¯è®¡åŒæ¯”修正为 `7.641733%`，17 å¸‚å·ž Ã— ä¸¤æŒ‡æ ‡å…± 68 ä¸ªåŒæ¯”/累计格全部一致（最大差 `2.91e-11`），当月同比无回归 | âœ…（2026-09-21，详见汇总大表交接第 4 ç« ï¼‰ |
| P1-1 | ä¸­å£å¾„排名 vs ä¸­å£å¾„明细「历史同期基数双轨制」 | é™¤æ­¦æ±‰å¤– 16 ä¸ªå¸‚州累计同比都有差（黄冈 7.74% vs 7.64%）；根因是母版 2025 å¹´ 3、4 æœˆç½‘约车拆分用了一套与出租列自相矛盾的旧输入。**方案 A å·²å®žæ–½å¹¶å›žå½’：排名页改用母版 2025 é™æ€åˆ—**；黄冈 1-8 æœˆç´¯è®¡åŒæ¯”修正为 `7.641733%`，17 å¸‚å·ž Ã— ä¸¤æŒ‡æ ‡å…± 68 ä¸ªåŒæ¯”/累计格全部一致（最大差 `2.91e-11`），当月同比无回归 | âœ…（2026-09-21 ç”±åŒäº‹ xyc æŒ‰æ–¹æ¡ˆ A å®žçŽ°ï¼Œcommit `abf468c`；报告《功能测试报告_中口径排名同比基数方案A_2026-09-21.md》；详见汇总大表交接第 4 ç« ï¼‰ |
| P1-2 | ä¸­å£å¾„排名全省行差 0.0002 ä¸‡äººå…¬é‡Œ | æ¯ç‰ˆå…¬å¼ `=SUM(O4:O20)` å…ˆå››èˆäº”入再求和的结构性差异，是否改全精度写值需拍板 | â¸ |
| P1-3 | ä¸­å£å¾„明细 4 æ ¼ `#DIV/0!` | 2025 å¹´ 8 æœˆåŸºæ•°ä¸º 0（不可比），是否改空白需业务确认 | â¸ |
| P1-4 | å…¨çœ h2031 1-8 æœˆ 27524.49 vs Î£17 å¸‚å·ž 24481.74 | å·® **3042.75**（企业上报的「全省」含市州明细外的数据，或某市州漏报）。程序一律按母版口径（Σ市州）走 â†’ å»ºè®®ä¸šåŠ¡ä¾§æ ¸ä¸€æ¬¡ | â¸ |
@@ -217,7 +218,7 @@
| P2-3 | `applySummaryReferenceLayout()` æŒ‰**列序号**套列宽/隐藏 | å‚照件一加减列就整体错位，应改为按表头文字匹配 | âŒ |
| P2-4 | ç¼ºæ¯ç‰ˆæç¤ºï¼ˆT08）未实测 | æœ‰æµ‹è¯•å‰¯æœ¬æ—¶è¡¥æµ‹ | âŒ |
| P2-5 | éƒ¨ç½²åŒ…内是**带 AJ åˆ—的旧母版** | `deploy/traffic-audit-deploy-20260913/backend/docs/生成汇总大表/`、`_deploytest/`；用户 09-20 æ˜Žç¡®ã€Œéƒ¨ç½²åŒ…先不管」，发包前必须同步 | â¸ |
| P2-6 | ~~导出缓存是内存态~~ | **已解决（2026-09-22）**：结果落盘到 `docs/生成汇总大表/_cache/`（文件名带数据版本 `MAX(import_batch.id)`），内存 â†’ è½ç›˜ â†’ çœŸç®—逐级命中，重启后端后仍可秒回复用；有新导入即失效，7 å¤©ä¸Šé™å¹¶è‡ªåŠ¨æ¸…理。遗留：数据版本是全局的（与汇总无关的导入也会让缓存失效），如需按导入类型细分待排期 | âœ…（可优化项见右）|
| P2-6 | ~~导出缓存是内存态~~ | **已解决（2026-09-22）**：结果落盘到 `docs/生成汇总大表/_cache/`（文件名带数据版本 `MAX(import_batch.id)`），内存 â†’ è½ç›˜ â†’ çœŸç®—逐级命中，重启后端后仍可秒回复用；有新导入即失效，7 å¤©ä¸Šé™å¹¶è‡ªåŠ¨æ¸…理。遗留项已闭环（2026-09-22 ä¸‹åˆï¼‰ï¼šç‰ˆæœ¬å·å‡çº§ä¸º**数据指纹**（依赖源表 `CHECKSUM TABLE` + æ¯ç‰ˆç­‰æ–‡ä»¶èº«ä»½ï¼ŒæŽ’除投资/能耗/审核/系统/导入日志），无关导入不再失效、换母版必定失效；失效时进度弹窗会说明原因 | âœ… |
| P2-7 | å¸‚州单表「多市州块」兜底提示 | æ˜¯å¦åœ¨è¯†åˆ«åˆ°ä¸€ä»½æ–‡ä»¶å«å¤šä¸ªå¸‚州块时弹窗提示/跳过，待确认（与 P0-1 åŒä¸€æ ¹å› ï¼‰ | â¸ |
| P2-8 | ä»“库根目录 `_*.*` ä¸´æ—¶æ–‡ä»¶å¢žå¤š | `_chk_*`（本次汇总大表排查产生，见汇总大表交接第 10 èŠ‚）、`_hyb_*`、`_loo_*` ç­‰ï¼Œ**经用户同意后再清** | â¸ |
| P2-9 | `2026å¹´8月道路运输量汇总表_版式原型.xlsx` åŽ»ç•™ | è¿è¡Œæ—¶æœªè¢«å¼•ç”¨ | â¸ |
@@ -250,6 +251,8 @@
| `docs/问题汇总/汇总表三条主线修复方案_2026-09-18.md` | ã€Œå…¬å¼ä¸é‡ç®—」统一根因 + é¡µèŒƒå›´æ¼é¡¹ + å£å¾„缺口 |
| `docs/问题汇总/中口径排名同比与城市客运列错位_根因与长效方案_2026-09-18.md` | 2025 åŸºæ•°ä¸‰å¤„缺陷（公交城际城乡=0、网约车 pin ç¼ºå¤±ã€å‡ºç§Ÿ 6 æœˆé‡å¤ï¼‰ä¸Ž A/B/C/D å››ç»„方案 |
| `docs/问题汇总/汇总大表问题交接_2026-09-21.md` | æ±‡æ€»å¤§è¡¨**逐行代码地图**与 P0-1/P0-2 è¯¦ç»†è®ºè¯ï¼ˆæŽ¥æ‰‹å¿…读） |
| `docs/功能测试报告/功能测试报告_中口径排名同比基数方案A_2026-09-21.md` | åŒäº‹å®žçŽ°æ–¹æ¡ˆ A çš„回归报告（黄冈 7.744917%→7.641733%，68 ä¸ªæ•°å€¼å¯¹ä¸€è‡´ï¼‰ |
| `docs/功能测试报告/功能测试报告_汇总大表软件输出与手工定稿差异_2026-09-21.md`、`docs/问题汇总/汇总大表差异核对回执_2026-09-21.md` | è½¯ä»¶è¾“出 vs æ‰‹å·¥å®šç¨¿çš„逐格差异清单与回执 |

**最容易被改回去的 6 ä¸ªç‚¹**（取自汇总大表交接第 6 èŠ‚）：

@@ -298,7 +301,7 @@
### 7.4 äº¤ä»˜è§„矩（硬性）

1. æ¯åšå®Œä¸€ä¸ªåŠŸèƒ½ï¼š**先测试 â†’ å†™ã€ŠåŠŸèƒ½æµ‹è¯•æŠ¥å‘Šã€‹**（`docs/功能测试报告/功能测试报告_<功能名>_<日期>.md`，含正向/负向/入库抽查）→ **更新《工作日结》**（`docs/工作日结/工作日结_<日期>.md`）。
2. ç„¶åŽ `git fetch origin`（个人 gitee，分支 `master`）与 `git fetch gitea`（公司，分支 `main`）比对合并，**禁止强推**，再 commit + push。
2. ç„¶åŽ `git fetch origin`（公司 gitea，分支 `main`）与远端比对合并，**禁止强推**，再 commit + push。
3. å…¬å¸è´¦å·å¯†ç åªèµ°æœ¬æœº git å‡­æ®ï¼Œ**禁止写进仓库任何文件**。

---
@@ -311,7 +314,7 @@
- [ ] ç”Ÿæˆä¸€æ¬¡ 2026-08 æ±‡æ€»å¤§è¡¨ï¼ˆæŠ¥è¡¨ç”Ÿæˆé¡µæˆ– Â§2.4 æŽ¥å£ï¼‰ï¼Œç¡®è®¤èƒ½äº§å‡ºã€èƒ½æ‰“开。
- [ ] è¯» `docs/问题汇总/汇总大表问题交接_2026-09-21.md`（重点第 3、4、5 ç« ï¼‰ã€‚
- [ ] è¯»æœ¬æ–‡ Â§4，按 P0 é¡ºåºå’Œç”¨æˆ·ç¡®è®¤å‰ 4 ä»¶äº‹æ€Žä¹ˆæŽ¨è¿›ã€‚
- [ ] ç¡®è®¤è‡ªå·±çŸ¥é“「改完要写测试报告 + å·¥ä½œæ—¥ç»“ + åŒä»“库推送」。
- [ ] ç¡®è®¤è‡ªå·±çŸ¥é“「改完要写测试报告 + å·¥ä½œæ—¥ç»“ + æŽ¨é€å…¬å¸ gitea（origin/main）」。

---

@@ -321,4 +324,5 @@
| --- | --- |
| 2026-09-21 | é¦–次成文：整合汇总大表交接（`docs/问题汇总/汇总大表问题交接_2026-09-21.md`）与投资/货运/客运各线遗留 |
| 2026-09-21（下午） | P0-1 é—­çŽ¯ï¼ˆåå °æºæ–‡ä»¶å·²åˆ æ®µ + é‡å¯¼éªŒè¯ï¼‰ï¼›æ–°å¢ž P1-13（投资系统新模板支持）；数据快照补 `investment_system` è¡Œ |
| 2026-09-22（下午） | å¯¼å‡ºç¼“存：结果落盘 + æ•°æ®æŒ‡çº¹å®ˆå« + å¤±æ•ˆæç¤ºï¼ˆP2-6 é—­çŽ¯ï¼‰ï¼›/ åŒæ­¥åŒäº‹è¿›å±•ï¼ˆ`abf468c` P1-1 æ–¹æ¡ˆ A、`47a8734` å·®å¼‚报告、`a5a9545` 09-22 è®°å½•ï¼‰ï¼›/ ä»“库约定改为公司 gitea å•ä»“库、§0 æ¸…单更新 |
| 2026-09-21（下午） | P1-1 é—­çŽ¯ï¼šç”¨æˆ·é‡‡ç”¨æ–¹æ¡ˆ A，中口径排名的 2025 ç´¯è®¡åŸºæ•°æ”¹è¯»æ¯ç‰ˆã€Šä¸­å£å¾„明细》静态列；黄冈累计同比由 7.74% ä¿®æ­£ä¸º 7.641733%，双页一致性回归通过 |