docs/¹¤×÷ÈÕ½á/¹¤×÷ÈÕ½á_2026-09-16.md
@@ -77,4 +77,98 @@
1. ä¸Žç”¨æˆ·ç¡®è®¤ `2021-12` / `2022-12` ç­‰ã€Œæ•´å¹´æŠ¥è¡¨æœŸã€çš„业务口径,以及是否需要把年度数据拆成逐月报表期。
2. ç¡®è®¤æ˜¯å¦éœ€è¦è¡¥ 2023 å¹´æ•°æ®ã€ä»¥åŠ `2026-01`~`2026-07` çš„上年同期是否需要补齐。
3. è§†ç”¨æˆ·æ„è§å¤„理预览弹窗「共 0 è¡Œã€æ–‡æ¡ˆã€‚
4. ç½‘络恢复后补推公司 gitea。
4. ç½‘络恢复后补推公司 gitea。
---
## åã€å‚æ™šè¿½åŠ ï¼ˆç¬¬ 3 è½®ç”¨æˆ·åé¦ˆ 6 æ¡ï¼Œ2026-09-16)
用户本轮提出 6 æ¡åé¦ˆï¼Œé€æ¡å¤„理结果如下:
| # | ç”¨æˆ·åé¦ˆ | å¤„理结果 |
|---|----------|----------|
| 1 | 21–26 å¹´è´§è¿é‡å‘¨è½¬é‡è¡¨æ•°æ®å…¥åº“ | ä¸Šè½®å·²å®Œæˆï¼ˆ`0cfd6e0`),本轮补齐 2023 å¹´ï¼ˆè§ #2) |
| 2 | ç”¨æˆ·æ ¸å®žã€Œ23 å¹´æœ‰ 12 æœˆçš„æ•°æ®ã€ | **属实**。8 æœˆæºæ–‡ä»¶ç¡®å®žæ²¡æœ‰ 2023 å¹´ Sheet,但 7 æœˆæ–‡ä»¶ `D:\05_数据分类\货运\7月\定稿-湖北省各市州运输量数据(2026å¹´1-7月).xlsx` é‡Œæœ‰ä¸€ä¸ªåä¸º `2023` çš„ Sheet。已另存 `_2023_import_tmp.xlsx`(`2023` + `2022å¹´` ä¸¤ä¸ª Sheet)导入,生成 `2023-12`(18 è¡Œï¼‰ï¼Œ**432 é¡¹é€æ ¼æ¯”对零差异** |
| 3 | è¦ä¸€ä»½ã€Œæ‰€æœ‰è¦æ³¨æ„çš„点」的汇总文档 | æ–°å»º `docs/问题汇总/问题与注意事项汇总_2026-09-16.md`(11 ç«  + é€ŸæŸ¥è¡¨ï¼Œå«å¯åЍ/进程、日志验证、数据库、导入路径与期次约定、报表、验证码、文件编码、浏览器取证、git åŒä»“库、遗留问题) |
| 4 | æ¢ WiFi åŽç™»å½•页出现验证码白框 + ã€ŒéªŒè¯ç åŠ è½½å¤±è´¥ã€ | å·²ä¿®å¤ï¼ˆå‰ç«¯é»˜è®¤å€¼ + fail-safe),本轮浏览器复测通过 |
| 5 | é¢„览点一下弹「导出失败,请确认导入数据」 | å·²ä¿®å¤æç¤ºé€»è¾‘(区分网络/后端原因);另外两小项(指标错位、弹窗拖动圆角)本轮浏览器实测通过 |
| 6 | å…¬è·¯æ—…客 H203-1 æ¨¡æ¿è¢«ä¿®æ”¹ | å·²é€‚配并验证:新增 `统一社会信用代码` / `填报单位` ä¸¤åˆ—入库,新老格式双向兼容 |
### 1. 2023 å¹´è´§è¿æ•°æ®è¡¥å½•(用户第 2 æ¡ï¼‰
- **排查过程**:先确认 8 æœˆæºæ–‡ä»¶ 5 ä¸ª Sheet å…¨ä¸ºå¯è§ã€æ—  2023;再全盘搜索 `*运输量*`、`*23å¹´*`、`*货运量*` æ–‡ä»¶åï¼›æœ€åŽæ‰«æ `D:\05_数据分类` ä¸Ž `D:\桌面` ä¸‹æ‰€æœ‰ `.xlsx` çš„ **Sheet å**,命中 7 æœˆæ–‡ä»¶çš„ `2023` Sheet。
- **一致性预检**:7 æœˆä¸Ž 8 æœˆæ–‡ä»¶çš„ `2021å¹´ / 2022å¹´ / 2024å¹´` ä¸‰å¹´æ•°æ®é€æ ¼æ¯”对,`onlyJuly / onlyAug / differ` å…¨ä¸ºç©º â†’ ä¸‰å¹´**零差异**,可安全用 7 æœˆæ–‡ä»¶è¡¥ 2022(作为 2023 çš„上年同期来源)。
- **导入**:`POST /api/import/freightTurnover?period=2023-12`,返回「共 36 æ¡è®°å½•」。
- **验证**:`2023-12` 18 è¡Œï¼›è´§è¿é‡ + å‘¨è½¬é‡å…± 432 é¡¹ä¸Ž Excel é€æ ¼æ¯”对 **mismatches=0**;`last_*` ä¸Ž `2022-12` é€å€¼ç›¸åŒï¼›å…¨éƒ¨æŠ¥è¡¨æœŸ 2021-12 â†’ 2026-08 å…± 13 æœŸã€æ¯æœŸ 18 è¡Œã€‚
- è¯¦è§ã€ŠåŠŸèƒ½æµ‹è¯•æŠ¥å‘Š_货运量周转量2023年数据补录_2026-09-16.md》。
### 2. H203-1 æ¨¡æ¿æ–°å¢žåˆ—适配(用户第 6 æ¡ï¼‰
- **模板 diff ç»“论**:Sheet1 ç”± 773×50 â†’ 816×52;在「企业名称」后插入 `统一社会信用代码`、`填报单位` ä¸¤åˆ—,其余 48 åˆ—整体右移。
- **改动 6 å¤„**:库 DDL、`docs/init.sql`、`docs/database.md`、`PassengerEnterpriseMonthly.java`、`DataImportService.java`、`DataViewController.java`(数据查看页列)。
- **验证**:新模板导入 814 æ¡ 0 å¤±è´¥ï¼Œå››é¡¹æ±‡æ€»ï¼ˆå®¢è¿è½¦è¾† 24584 / æ ¸å®šè½½å®¢ä½ 711018 / å®¢è¿é‡ 16371625 / å‘¨è½¬é‡ 1023386179)与源文件全等;老格式 `.xls` å¯¼å…¥ 767 æ¡ 0 å¤±è´¥ä¸”新列有值(**老文件其实也带这两列**),数值与既有 2026-08 å®Œå…¨ä¸€è‡´ï¼›è´Ÿå‘用例(选错类型)报错清晰。
- **过程中的失误**:`docs/database.md` é‡Œ `| enterprise_name | varchar(200) | ä¼ä¸šåç§° |` å‡ºçް 4 æ¬¡ï¼Œé¦–次批量替换误改 3 å¼ è¡¨ï¼Œå·² `git checkout` å›žé€€åŽæ”¹ä¸ºã€Œæˆªå–章节再替换」。
- è¯¦è§ã€ŠåŠŸèƒ½æµ‹è¯•æŠ¥å‘Š_H2031模板新增列适配_2026-09-16.md》。
### 3. ç™»å½•验证码容错 + æŠ¥è¡¨é¢„览整改(用户第 4、5 æ¡ï¼‰
- **验证码**:`Login.vue` é»˜è®¤ `captchaRequired=false`,改为 fail-safe(仅后端明确返回 `required===true` æ‰æ˜¾ç¤ºï¼‰ï¼›æ¢ WiFi/后端不可达时不再残留验证码白框。
- **失败提示**:`failWith(err, action)` + `errReason(raw)` é‡å†™ï¼ŒåŒºåˆ†ã€Œè¿žä¸ä¸ŠæœåŠ¡å™¨ã€ä¸Žã€ŒåŽç«¯çœŸå®žåŽŸå› ã€ï¼›é¢„è§ˆè°ƒç”¨å¸¦ `action='预览'`;Blob é”™è¯¯å…ˆ `text()` å†è§£æžã€‚
- **指标错位**:预览表头由 3 åˆ—补为 4 åˆ—(分类/指标/数据/同比),实测 x åæ ‡ 35 / 118 / 394 / 587,`16888.76` è½åœ¨ã€Œæ•°æ®ã€åˆ—。
- **弹窗拖动 + åœ†è§’**:新增 `dialogDrag.js` æŒ‡ä»¤ï¼ˆElement UI 2.15.14 æ—  `draggable`),`border-radius:10px`;实测拖动 `(0,40) â†’ (120,200)`,`transform=matrix(1,0,0,1,120,160)`,关闭后复位 `none`。
- ã€Œä¸­å£å¾„之后不再渲染表格」上轮已修,本轮复核弹窗内**有且仅有一张表**。
- è¯¦è§ã€ŠåŠŸèƒ½æµ‹è¯•æŠ¥å‘Š_登录验证码容错与报表预览整改_2026-09-16.md》。
### 4. æ³¨æ„äº‹é¡¹æ±‡æ€»æ–‡æ¡£ï¼ˆç”¨æˆ·ç¬¬ 3 æ¡ï¼‰
新建 `docs/问题汇总/问题与注意事项汇总_2026-09-16.md`,共 11 ç« ï¼š
速查表(10 æ¡ï¼‰ã€å¯åŠ¨ä¸Žè¿›ç¨‹ç®¡ç†ã€æœåŠ¡çŠ¶æ€éªŒè¯ã€æ•°æ®åº“ã€æ•°æ®å¯¼å…¥ï¼ˆè·¯å¾„ + æœŸæ¬¡çº¦å®š + å¤šå¹´åº¦å·¥ä½œç°¿è¯†åˆ«è§„则)、报表生成、登录与验证码、文件写入与文本处理的坑、浏览器自动化取证的坑、Git åŒä»“库工作流、当前已知遗留问题。
## åä¸€ã€æµ‹è¯•结果摘要(傍晚追加部分)
- **2023 è¡¥å½•**(5 æ¡ç”¨ä¾‹ï¼‰ï¼šæ­£å‘入库、432 é¡¹é€æ ¼æ¯”对零差异、上年同期取自 2022、报表期清单无重复/无残留、2022-12 é‡å†™åŽé€å€¼ä¸å˜ â€”— å…¨éƒ¨é€šè¿‡ã€‚
- **H203-1 æ–°å¢žåˆ—**(9 æ¡ç”¨ä¾‹ï¼‰ï¼šæ–°æ¨¡æ¿ 814 æ¡ 0 å¤±è´¥ã€ä¸¤åˆ— 814/814 æœ‰å€¼ã€é¦–行与汇总四项与源文件全等、老格式 767 æ¡ 0 å¤±è´¥ä¸”数值与 2026-08 å…¨ç­‰ã€Excel COM æŠ½æŸ¥é¦–行一致、负向选错类型报错清晰、列右移不影响旧字段 â€”— å…¨éƒ¨é€šè¿‡ã€‚
- **登录验证码 + é¢„览整改**(10 æ¡ç”¨ä¾‹ï¼‰ï¼šæ— éªŒè¯ç ç™½æ¡†ã€æŽ¥å£ `required=false`、表头 4 åˆ—且 x åæ ‡å¯¹é½ã€åœ†è§’ 10px、拖动位移 120/160、关闭复位、弹窗内仅 1 å¼ è¡¨ã€å¤±è´¥æç¤ºå·²ç»†åˆ†ã€å¯¼å‡ºæˆåŠŸ â€”— å…¨éƒ¨é€šè¿‡ã€‚
- **测试数据清理**:H203-1 å¯¼å…¥éªŒè¯äº§ç”Ÿçš„ `2099-06 / 2099-07 / 2099-09` ä¸‰ä¸ªæµ‹è¯•期(共 2395 è¡Œï¼‰åŠå…¶ `import_batch` è®°å½•已删除,`h2031_enterprise_monthly` æ¢å¤ä¸º 2026-01 ~ 2026-08 å…± 8 æœŸï¼›`freight_turnover_import` ä¸º 13 æœŸ Ã— 18 è¡Œã€‚
## åäºŒã€é—留问题与待办(傍晚更新)
| # | é—®é¢˜ | çŠ¶æ€ |
|---|------|------|
| 1 | 8 æœˆæºæ–‡ä»¶ç¼º 2023 å¹´ Sheet | **已解决**(用 7 æœˆæ–‡ä»¶è¡¥å½• `2023-12`) |
| 2 | `2026-01` ~ `2026-07` çš„ `last_*` ä¸ºç©º | å¾…用户确认是否补 |
| 3 | `2026-01` ~ `2026-08` çš„ H203-1 `unified_credit_code` / `report_unit` ä¸ºç©ºï¼ˆæ­¤å‰ä»£ç æœªè¯»è¿™ä¸¤åˆ—) | **待用户确认是否重导历史文件回填** |
| 4 | `2024-12` çš„上年同期未回填(需重导 2024 å¹´æ•°æ®ï¼‰ | å¾…用户确认 |
| 5 | é¢„览弹窗「共 0 è¡Œã€ä¸Žã€Œæœˆåº¦è¦†ç›–:1~8月均有数据」口径文案不同 | å¾…用户确认改文案 |
| 6 | `2021-12` ç­‰ã€Œæ•´å¹´æŠ¥è¡¨æœŸã€çš„业务口径 | å¾…用户确认 |
| 7 | å…¬å¸ gitea æŽ¨é€ï¼ˆç½‘络无响应) | å¾…补推,**禁强推** |
| 8 | ä»“库根目录大量 `_*.*` ä¸´æ—¶æ–‡ä»¶ | ç»ç”¨æˆ·åŒæ„åŽå†æ¸…理 |
## åä¸‰ã€ä¸‹ä¸€æ­¥è®¡åˆ’(傍晚更新)
1. ç­‰ç”¨æˆ·ç¡®è®¤ 3 ä»¶äº‹ï¼šæ˜¯å¦é‡å¯¼ 2026 å¹´åŽ†å² H203-1 æ–‡ä»¶å›žå¡«ä¸¤åˆ—、是否补 `last_*` / `2024-12` ä¸Šå¹´åŒæœŸã€é¢„览弹窗文案是否调整。
2. ç½‘络恢复后补推公司 gitea(先 fetch åˆå¹¶ï¼Œç¦å¼ºæŽ¨ï¼‰ã€‚
3. è§†ç”¨æˆ·æ„è§æ¸…理仓库根目录 `_*.*` ä¸´æ—¶æ–‡ä»¶ã€‚
## åå››ã€git å®žé™…结果(傍晚补记)
1. `git fetch origin`(个人 gitee,`master`):远端与本地一致(`HEAD...origin/master = 0 0`),**无同事/用户新提交**,无需合并。
2. æäº¤ `24b4c28`:`feat(h2031): é€‚配模板新增「统一社会信用代码/填报单位」两列并入库;fix(import): è¡¥å½• 2023 å¹´è´§è¿é‡å‘¨è½¬é‡ï¼›fix(login/report): éªŒè¯ç å®¹é”™ã€é¢„览指标对齐、弹窗可拖动圆角、失败提示细分;docs: æ–°å¢žé—®é¢˜ä¸Žæ³¨æ„äº‹é¡¹æ±‡æ€»`(10 ä¸ªæ”¹åЍ + 4 ä¸ªæ–°å¢žï¼Œå…± 14 ä¸ªæ–‡ä»¶ï¼‰ã€‚
3. æŽ¨ä¸ªäººä»“库 `origin`:`git push origin main:master` æˆåŠŸï¼ˆ`0cfd6e0..24b4c28`)。
4. æŽ¨å…¬å¸ `gitea`:`git fetch gitea` æŠ¥ `Operation too slow. Less than 1000 bytes/sec transferred the last 15 seconds`;`curl --max-time 20 http://61.183.254.94:3000/` è¿”回 `http_code=000 time=20.01`,确认**公司内网不可达**(网络问题,非凭据),本次未推送成功,已列为遗留问题;补推前先 `git fetch gitea` ä¸Žè¿œç«¯ `main` åˆå¹¶ï¼Œ**禁强推**。
## åäº”、用户 4 æ¡ç¡®è®¤çš„落实(2026-09-16 æ”¶å°¾ï¼‰
| ç”¨æˆ·åé¦ˆ | ç»“论与处置 |
|---|---|
| 1-2「我导入的货运量周转量表里有 23 å¹´æ•°æ®ã€ | å·²é€æ ¼å¤æ ¸ï¼š8 æœˆæºæ–‡ä»¶åªæœ‰ `2026å¹´ / 2025å¹´ / 2024å¹´ / 2022å¹´ / 2021å¹´` äº”个 Sheet,内文无任何 2023 æ ‡è¯†ï¼ˆå‘½ä¸­é¡¹å‡ä¸ºæµ®ç‚¹æ•°é‡Œçš„æ•°å­—巧合);`2023` Sheet å‡ºçŽ°åœ¨**7 æœˆ**文件里。已用 7 æœˆæ–‡ä»¶çš„ `2023` Sheet è¡¥å½• `2023-12`,无需再导。 |
| 1「让他空着吧」 | 2026-01~08 çš„ H203-1 `unified_credit_code` / `report_unit` ä¿æŒç©ºï¼Œ**不重导**历史文件。 |
| 2「是不是把 23 å¹´ä¹Ÿå¯¼è¿›åŽ»ã€ | æ˜¯ï¼Œå·²å¯¼å…¥ `2023-12`(18 è¡Œï¼‰ã€‚若要回填 `2024-12` çš„上年同期值,需再重导一次 2024 å¹´æ•°æ®ï¼ˆå¾…用户确认)。 |
| 3「可以」 | é¢„览弹窗文案已按确认修改(汇总大表「指标 N é¡¹ã€ï¼å…¶å®ƒæŠ¥è¡¨ã€Œå…± N è¡Œæ˜Žç»†ã€ï¼‰ï¼Œå¹¶å·²åœ¨æµè§ˆå™¨å®žæµ‹ã€‚ |
| 4「什么时候开始连不上的」 | å…¬å¸ gitea **自 2026-09-15 èµ·ä¸å¯ç”¨**:09-15 ä¸ºå‡­æ®å¼¹çª—未推成功;09-16 èµ·å˜ä¸º TCP 3000 å¯è¿žä½† HTTP æ— å“åº”。今日复测 `Test-NetConnection` ä¸º True、`curl` 25s è¶…æ—¶ `code=000`。 |
## åå…­ã€git å®žé™…结果(收尾补记)
- `git fetch origin`(个人 gitee):`HEAD...origin/master = 0 0`,无新提交,无需合并。
- æäº¤ `e7cddc4`:`fix(report): é¢„览弹窗行数文案按报表类型区分`(4 ä¸ªæ–‡ä»¶ï¼Œ+25/-1)。
- æŽ¨ä¸ªäººä»“库 `origin`:`git push origin main:master` æˆåŠŸï¼ˆ`b0c8b4f..e7cddc4`)。
- æŽ¨å…¬å¸ `gitea`:`git fetch gitea` ä»å¤±è´¥ï¼ŒæŠ¥ `fatal: unable to access ... Recv failure: Connection was reset`(`fetch_exit=128`),本次**未推送成功**,继续列为遗留问题;补推前先 `git fetch gitea` ä¸Žè¿œç«¯ `main` åˆå¹¶ï¼Œ**禁强推**。