feat(import): 货运量周转量支持多年度工作簿（21-26年）一次性入库；fix(report): 汇总大表预览删除中口径之后的明细表

zhizhijie

2026-09-16 0cfd6e093e08566b4199836a54d827067580007e

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

@@ -43,3 +43,38 @@
  2. æäº¤ `0d2a5fc`：`fix(cors): æ”¾è¡Œå†…网网段来源，修复局域网 IP è®¿é—®æ—¶ç™»å½• 403`；
  3. æŽ¨ä¸ªäººä»“库 `origin`：`git push origin main:master` æˆåŠŸï¼ˆ`82100d6..0d2a5fc`）；
  4. æŽ¨å…¬å¸ `gitea`：`git fetch gitea`、`git push gitea main:main` å‡å›  HTTP æ— å“åº”而挂起，未推送成功（详见遗留问题 5）；本次为快进推送，不涉及强推。

---

## å…­ã€ä¸‹åˆè¿½åŠ ï¼ˆä¸¤æ¡ç”¨æˆ·éœ€æ±‚，2026-09-16）

### 1. æŠŠ 8 æœˆå¯¼å…¥çš„「货运量周转量表」中的 21–26 å¹´æ•°æ®å…¨éƒ¨è¯»å…¥æ•°æ®åº“
- **背景**：用户 8 æœˆå¯¼å…¥çš„ `定稿-湖北省各市州运输量数据（2026å¹´1-8月）.xlsx` ä¸€ä¸ªå·¥ä½œç°¿å†…含 5 ä¸ªå¹´åº¦ Sheet（`2026å¹´ / 2025å¹´ / 2024å¹´ / 2022å¹´ / 2021å¹´`，源文件无 2023 å¹´ï¼‰ï¼Œè€Œè€é€»è¾‘只读第 1 ä¸ª Sheet å¹¶æŒ‰ã€Œå·¦åŠä»Šå¹´ 1–N æœˆ / å³åŠåŽ»å¹´ 1–12 æœˆã€çš„月度模板解析，其余年度数据被丢弃。
- **改动（后端 1 æ–‡ä»¶ï¼Œ+153/−19）**：`DataImportService.java` ä¸­ `importFreightTurnover` æ”¹ä¸ºåˆ†æµå…¥å£ï¼›åŽŸé€»è¾‘抽为 `importFreightTurnoverByMonth`（逐行不变）；新增 `detectYearSheets`（识别多年度工作簿）、`importFreightTurnoverByYear`（按年入库 + ä¸Šå¹´åŒæœŸå–自上一年度 Sheet）、`parseWholeYearSheet`（整年 Sheet çš„货运量块/周转量块解析）、`persistFreightTurnover`（按报表期先删后插并记批次）。
- **结果**：源文件 5 ä¸ªå¹´åº¦å…¨éƒ¨å…¥åº“，返回「共 90 æ¡è®°å½•ã€ï¼ŒæŠ¥è¡¨æœŸä¸º `2021-12 / 2022-12 / 2024-12 / 2025-12 / 2026-08`，每期 18 è¡Œï¼›ä¸Žæºæ–‡ä»¶é€é¡¹æ¯”对 **1080 ä¸ªå•å…ƒæ ¼é›¶å·®å¼‚**；重复导入幂等（全表 216 è¡Œ md5 å‰åŽä¸€è‡´ï¼‰ï¼›éžå¤šå¹´åº¦æ–‡ä»¶è‡ªåŠ¨å›žé€€åŽŸæœˆåº¦è·¯å¾„。
- è¯¦è§ã€ŠåŠŸèƒ½æµ‹è¯•æŠ¥å‘Š_货运量周转量多年度导入_2026-09-16.md》。

### 2. æŠ¥è¡¨ç”Ÿæˆ-汇总大表预览：删掉「中口径」之后的表格
- **改动（前端 1 æ–‡ä»¶ï¼Œå•è¡Œï¼‰**：`ReportExport.vue` ç¬¬ 133 è¡Œç”± `v-else-if="it.summary && it.summary.length"` æ”¹ä¸º `v-if="it.key !== 'summaryWorkbook' && it.summary && it.summary.length"`。根因是上面的汇总表用 `v-if`、第二张表用 `v-else-if`，对 `summaryWorkbook` ä¹Ÿç…§æ ·æ¸²æŸ“。
- **验证（推翻上一轮的无效取证）**：早期截图没拍到弹窗、AX æ ‘读到的是缓存，均为无效证据；本轮改用 `tab.playwright.evaluate` ç›´æŽ¥è¯» DOM â€”— å¼¹çª—内有且仅有 1 å¼ è¡¨ï¼ˆ`preview-summary wb-table`，12 è¡ŒæŒ‡æ ‡ï¼‰ï¼Œè¡¨æ ¼ä¸‹æ–¹åªæœ‰ä¸¤æ¡åŒæ¯”缺失提示与「关闭」按钮，**第二张表已彻底消失**。有效截图：`_qa_out/preview_summaryWorkbook_2026-08_verified_20260916.png`（本轮复核重拍 `..._verified2_20260916.png`，均 54006 å­—节）。
- è¯¦è§ã€ŠåŠŸèƒ½æµ‹è¯•æŠ¥å‘Š_汇总大表预览删除中口径后明细表_2026-09-16.md》。

## ä¸ƒã€æµ‹è¯•ç»“果摘要（下午追加部分）
- å¤šå¹´åº¦å¯¼å…¥ï¼š12 æ¡ç”¨ä¾‹å…¨é€šè¿‡â€”—正向（多年度入库、1080 å•å…ƒæ ¼é€é¡¹æŠ½æŸ¥é›¶å·®å¼‚、报表期语义、上年同期、批次记录）、负向（单 Sheet æœˆåº¦æ¨¡æ¿å›žé€€ã€éžå¹´åº¦å‘½ååŒ Sheet å›žé€€ã€æ··åˆå‘½åå›žé€€ã€éž Excel æ–‡ä»¶æŠ¥é”™ï¼‰ã€å¹‚等（重复导入全表 md5 ä¸€è‡´ï¼‰ã€å›žå½’（测试期清理干净、真实月份 216 è¡Œ / 12 æœŸå£å¾„不变）。
- é¢„览弹窗：7 æ¡ç”¨ä¾‹å…¨é€šè¿‡â€”—DOM å®žæµ‹å¼¹çª—内 `table` æ•°é‡ä¸º 1、类名与行数正确、12 è¡Œæ•°å€¼ä¸ŽåŒæ¯”完整、表格下方无第二张表、`git diff` ä»… 1 è¡Œæ”¹åŠ¨ä¸å›žå½’。
- æµ‹è¯•æœŸæ¸…理：`2099-01` ~ `2099-04` å…¨éƒ¨ç”¨ `POST /api/import/clear?period=…` æ¸…空（各 dataRows=18、batchRows=1），当前库 **0 æ¡ 2099 æ®‹ç•™**、`freight_turnover_import` 216 è¡Œ / 12 ä¸ªæŠ¥è¡¨æœŸã€‚

## å…«ã€é—留问题与待办（更新）
1. **`2021-12` ç­‰æŠ¥è¡¨æœŸæ˜¯ã€Œæ•´å¹´ã€è¯­ä¹‰**：这些期承载该年 1–12 æœˆå…¨å¹´æ•°æ®ï¼Œè€Œéž 12 æœˆå•æœˆï¼›åŽç»­æŠ¥è¡¨/审核若按单月口径取数需用户确认口径，必要时再改造。
2. **源文件缺 2023 å¹´ Sheet**：导致不生成 `2023-12`，`2024-12` æ— ä¸Šå¹´åŒæœŸã€‚属源数据缺口。
3. **`2026-01` ~ `2026-07` çš„ `last_*` ä¸ºç©º**：经比对改动前备份（`2026-04` çš„ INSERT）确认这几期改动前即为空，且本次导入未触碰这些报表期（批次只覆盖 5 ä¸ªæœŸï¼‰ï¼Œ**非本次改动引入**；如需补上年同期需重新导入对应年度数据。
4. **改动前的备份不完整**：`_backup_freight_turnover_before_multiyear_20260916.sql` ä»… 59642 å­—节、只解析出 `2026-04` ä¸€å¤„ INSERT，**不能作为完整回滚依据**。
5. å¼¹çª—内「共 0 è¡Œã€ä¸Žã€Œæœˆåº¦è¦†ç›–：1~8月均有数据」口径不同（前者是明细行数），易误解，可考虑改文案（未做，等用户确认）。
6. ä¸Šåˆé—留继续挂账：域名/公网访问的白名单补充、`Login.vue` é”™è¯¯æç¤ºç»†åˆ†ã€AI å¤–发脱敏补齐、4 å¼ æ˜Žç»†æŠ¥è¡¨æ¨¡æ¿æ‰©åˆ—、审核比对基准缺失保护、`sys_role` æƒé™è½åœ°ã€3D éªŒè¯ç ç”Ÿäº§å¼€å¯ã€`backend.log` åŽ†å²æ˜Žæ–‡æ¸…理、仓库根目录临时文件清理。
7. **公司 gitea ä»å¾…补推**（网络问题，非凭据），补推前先 `git fetch gitea` ä¸Žè¿œç«¯ `main` å¯¹æ¯”合并，禁强推。

## ä¹ã€æ˜Žå¤©è®¡åˆ’
1. ä¸Žç”¨æˆ·ç¡®è®¤ `2021-12` / `2022-12` ç­‰ã€Œæ•´å¹´æŠ¥è¡¨æœŸã€çš„业务口径，以及是否需要把年度数据拆成逐月报表期。
2. ç¡®è®¤æ˜¯å¦éœ€è¦è¡¥ 2023 å¹´æ•°æ®ã€ä»¥åŠ `2026-01`~`2026-07` çš„上年同期是否需要补齐。
3. è§†ç”¨æˆ·æ„è§å¤„理预览弹窗「共 0 è¡Œã€æ–‡æ¡ˆã€‚
4. ç½‘络恢复后补推公司 gitea。