From 49fea21571a4060aa8570cbf220088352e2ccf15 Mon Sep 17 00:00:00 2001
From: zhizhijie <zhizhijie@users.noreply.gitee.com>
Date: 星期三, 16 九月 2026 17:33:01 +0800
Subject: [PATCH] docs(工作日结): 补记 2026-09-16 收工记录（origin 已推 80e0879、gitea 仍不通、未提交项与明日计划）

---
 docs/功能测试报告/功能测试报告_货运量周转量多年度导入_2026-09-16.md |   50 ++++++++++++++++++++++++++++++++++++++++++++++++++
 1 files changed, 50 insertions(+), 0 deletions(-)

diff --git "a/docs/\345\212\237\350\203\275\346\265\213\350\257\225\346\212\245\345\221\212/\345\212\237\350\203\275\346\265\213\350\257\225\346\212\245\345\221\212_\350\264\247\350\277\220\351\207\217\345\221\250\350\275\254\351\207\217\345\244\232\345\271\264\345\272\246\345\257\274\345\205\245_2026-09-16.md" "b/docs/\345\212\237\350\203\275\346\265\213\350\257\225\346\212\245\345\221\212/\345\212\237\350\203\275\346\265\213\350\257\225\346\212\245\345\221\212_\350\264\247\350\277\220\351\207\217\345\221\250\350\275\254\351\207\217\345\244\232\345\271\264\345\272\246\345\257\274\345\205\245_2026-09-16.md"
new file mode 100644
index 0000000..c54758e
--- /dev/null
+++ "b/docs/\345\212\237\350\203\275\346\265\213\350\257\225\346\212\245\345\221\212/\345\212\237\350\203\275\346\265\213\350\257\225\346\212\245\345\221\212_\350\264\247\350\277\220\351\207\217\345\221\250\350\275\254\351\207\217\345\244\232\345\271\264\345\272\246\345\257\274\345\205\245_2026-09-16.md"
@@ -0,0 +1,50 @@
+# 鍔熻兘娴嬭瘯鎶ュ憡锛氳揣杩愰噺鍛ㄨ浆閲忚〃澶氬勾搴﹀伐浣滅翱锛�2021鈥�2026锛変竴娆℃�у叆搴� 2026-09-16
+
+## 鍔熻兘璇存槑
+- 闇�姹傦細8 鏈堝鍏ョ殑銆屽畾绋�-婀栧寳鐪佸悇甯傚窞杩愯緭閲忔暟鎹紙2026骞�1-8鏈堬級.xlsx銆嶄竴涓伐浣滅翱鍐呭惈 21鈥�26 骞达紙婧愭枃浠剁己 2023 骞达級鍏ㄩ儴骞村害鏁版嵁锛岃姹傛妸杩欎簺鏁版嵁鍏ㄩ儴璇诲叆鏁版嵁搴撱��
+- 鏃ц涓猴細`importFreightTurnover` 鍙绗� 1 涓� Sheet锛屽苟鎸夈�屾ā鏉縚璐ц繍閲忓懆杞噺.xlsx銆嶇殑宸﹀彸涓ゅ崐锛堝乏鍗婁粖骞� 1鈥揘 鏈堛�佸彸鍗婂幓骞� 1鈥�12 鏈堬級瑙ｆ瀽锛屽鑷村叾浣欏勾搴� Sheet 鐨勬暟鎹鐩存帴涓㈠純銆�
+- 鏂拌涓猴細瀵煎叆鏃跺厛鍒ゆ柇鏄惁涓恒�屽骞村害宸ヤ綔绨裤�嶏紙Sheet 鏁� 鈮� 2銆佹瘡涓� Sheet 鍚嶅舰濡� `2021骞碻銆佷笖棣栬 A 鍒楀惈銆岃揣杩愰噺銆嶃�丅 鍒楀惈銆屾湀銆嶏級銆�
+  - 鍛戒腑锛氶�� Sheet 瑙ｆ瀽鏁村勾 1鈥�12 鏈堢殑璐ц繍閲忓潡涓庡懆杞噺鍧楋紝**姣忎釜骞村害钀戒竴涓姤琛ㄦ湡**锛堟姤琛ㄦ湡 = 璇ュ勾鏈�鍚庝竴涓湁璐ц繍閲忔暟鎹殑鏈堜唤锛屾湰娆′负 `YYYY-12`锛夛紝涓婂勾鍚屾湡鍙栦笂涓�骞村害 Sheet銆�
+  - 鏈懡涓細瀹屽叏鍥為��鍘熸湁鏈堝害瑙ｆ瀽璺緞锛岃涓轰笌鏀瑰姩鍓嶄竴鑷淬��
+- 骞傜瓑锛氫粛鎸夋姤琛ㄦ湡銆屽厛鍒犲悗鎻掋�嶏紱姣忎釜骞村害鍚勫啓涓�鏉� `import_batch` 璁板綍銆�
+
+## 娑夊強鏀瑰姩
+- 鍚庣 `traffic-audit-server/src/main/java/com/trafficaudit/dataimport/service/DataImportService.java`锛�+153 / 鈭�19锛夛細
+  - `importFreightTurnover` 鏀逛负鍒嗘祦鍏ュ彛锛涘師閫昏緫鏁翠綋鎶戒负 `importFreightTurnoverByMonth`锛堥�昏緫涓庢敼鍔ㄥ墠閫愯涓�鑷达級銆�
+  - 鏂板 `detectYearSheets`锛堝骞村害璇嗗埆锛夈�乣importFreightTurnoverByYear`锛堟寜骞磋В鏋� + 涓婂勾鍚屾湡锛夈�乣parseWholeYearSheet`锛堟暣骞� Sheet 瑙ｆ瀽锛夈�乣persistFreightTurnover`锛堟寜鎶ヨ〃鏈熷厛鍒犲悗鎻� + 璁版壒娆★級銆�
+  - 椤堕儴鏂板 `import java.util.TreeMap;`銆�
+- 鏈敼鏁版嵁搴撶粨鏋勩�佹湭鏀瑰墠绔�佹湭鏀瑰鍏ユ帴鍙ｇ鍚嶏紙浠嶄负 `POST /api/import/freightTurnover?period=yyyy-MM`锛夈��
+
+## 娴嬭瘯鐜
+- 鍚庣锛歵raffic-audit-server 8090锛堝惈鏈鏀瑰姩锛宍start-dev.ps1` 鍚姩鎴愬姛锛宐ackend.log 鍑虹幇 `Tomcat started on port(s): 8090` / `Started TrafficAuditApplication`锛夈��
+- 鍓嶇锛歵raffic-audit-web 8080锛堟湰娆′笉娑夊強鍓嶇锛夈��
+- 鏁版嵁搴擄細鏈満 MySQL `127.0.0.1:3308/traffic_audit`锛岀敤 mysql CLI 鐩存煡鏍稿銆�
+- 婧愭枃浠讹細`D:\05_鏁版嵁鍒嗙被\楂橀�焅瀹氱-婀栧寳鐪佸悇甯傚窞杩愯緭閲忔暟鎹紙2026骞�1-8鏈堬級.xlsx`锛孲heet 涓� `['2026骞�','2025骞�','2024骞�','2022骞�','2021骞�']`锛�2026/2025 鍚� 38 琛屆�15 鍒楋紝2024 48 琛屆�13 鍒楋紝2022 40 琛屆�15 鍒楋紝2021 41 琛屆�14 鍒楋級銆�
+- 璐熷悜/杈圭晫鐢ㄤ緥涓�寰嬪湪涓�娆℃�ф祴璇曟湡 `2099-01` ~ `2099-04` 鍐呰繘琛岋紝鍏ㄧ▼涓嶈Е纰扮湡瀹炴湀浠斤紱娴嬭瘯鍚庡凡閫愪釜娓呯┖銆�
+
+## 鐢ㄤ緥琛�
+| # | 鐢ㄤ緥 | 杈撳叆 | 棰勬湡 | 瀹為檯 | 缁撹 |
+|---|---|---|---|---|---|
+| 1 | 姝ｅ悜-澶氬勾搴﹀鍏� | 涓婁紶婧愭枃浠讹紝`period=2026-08` | 21/22/24/25/26 浜斾釜骞村害鍏ㄩ儴鍏ュ簱 | 杩斿洖銆屽叡 90 鏉¤褰曘�嶏紙5 涓姤琛ㄦ湡 脳 18 琛岋級锛涘簱鍐呮柊澧�/瑕嗙洊 `2021-12`銆乣2022-12`銆乣2024-12`銆乣2025-12`銆乣2026-08` | 閫氳繃 |
+| 2 | 姝ｅ悜-鍏ュ簱鎶芥煡锛堥�愰」瀵归綈锛� | 婧愭枃浠堕�愬勾閫愬競宸為�愭湀涓庡簱鍐呴�愰」姣斿锛堜粖骞磋揣杩愰噺/浠婂勾鍛ㄨ浆閲�/涓婂勾璐ц繍閲�/涓婂勾鍛ㄨ浆閲忥級 | 瀹屽叏涓�鑷� | 姣斿 **1080 涓崟鍏冩牸锛屽樊寮� 0**锛堣剼鏈� `_verify_ft_multi.py`锛� | 閫氳繃 |
+| 3 | 姝ｅ悜-鎶ヨ〃鏈熻涔� | 鏌ョ湅鍚勬湡 `report_period` | 姣忓勾搴︿竴涓姤琛ㄦ湡 | `2021-12 / 2022-12 / 2024-12 / 2025-12 / 2026-08`锛涙簮鏂囦欢鏃� 2023 骞达紝鏁呮湭鐢熸垚 `2023-12` | 閫氳繃 |
+| 4 | 姝ｅ悜-涓婂勾鍚屾湡 | 鍚勬湡 `last_*` 鏄惁鍙栦笂涓�骞村害 Sheet | 鏈変笂涓�骞村害鐨勬湁鍊笺�佹棤鐨勪负绌� | `2022-12`銆乣2025-12`銆乣2026-08` 鍚� 18 琛� `last_*` 鍏ㄩ儴鏈夊�硷紱`2021-12`锛堟棤涓婂勾锛夈�乣2024-12`锛堢己 2023锛変负绌� | 閫氳繃 |
+| 5 | 姝ｅ悜-瀵煎叆鎵规 | 鏌ヨ `import_batch` | 姣忎釜鎶ヨ〃鏈熶竴鏉¤褰� | 棣栨瀵煎叆鍐欏叆 id 324鈥�328锛�2021-12/2022-12/2024-12/2025-12/2026-08锛夛紝5 鏉″潎 total=success=18銆乫ail=0锛宖ile_name 涓烘簮鏂囦欢鍚� | 閫氳繃 |
+| 6 | 璐熷悜-鍗� Sheet 鏈堝害妯℃澘鍥為�� | 鍗� Sheet 鏈堝害妯℃澘鏂囦欢 + `period=2099-01` | 璇嗗埆涓嶅懡涓紝鍥為��鏈堝害璺緞 | 杩斿洖銆屽叡 18 鏉¤褰曘�嶏紝涓庢敼鍔ㄥ墠涓�鑷� | 閫氳繃 |
+| 7 | 璐熷悜-闈炲勾搴﹀懡鍚嶅 Sheet 鍥為�� | 涓や釜闈炲勾搴﹀懡鍚� Sheet锛圫heet1/Sheet2锛�+ `period=2099-02` | 璇嗗埆涓嶅懡涓紝鍥為��鏈堝害璺緞 | `code=200`锛�18 鏉� | 閫氳繃 |
+| 8 | 璐熷悜-娣峰悎鍛藉悕鍥為�� | 骞村害鍚� + 闈炲勾搴﹀悕娣峰悎锛�2021骞�/2022骞�/澶囨敞璇存槑锛�+ `period=2099-03` | 璇嗗埆涓嶅懡涓紝鍥為��鏈堝害璺緞 | `code=200`锛�18 鏉� | 閫氳繃 |
+| 9 | 璐熷悜-闈� Excel 鏂囦欢 | 鏂囨湰鏂囦欢褰� xlsx 涓婁紶 + `period=2099-04` | 鎶ラ敊涓斾笉钀藉簱 | `{"code":500,"message":"瀵煎叆澶辫触: Can't open workbook - unsupported file type: UNKNOWN"}` | 閫氳繃 |
+| 10 | 骞傜瓑-閲嶅瀵煎叆 | 鍚屼竴婧愭枃浠跺啀瀵间竴娆� | 涓嶄骇鐢熼噸澶嶈銆佸�间笉鍙� | 浠嶈繑鍥炪�屽叡 90 鏉¤褰曘�嶏紱瀵煎叆鍚庡啀鍐� id 332鈥�336锛�**鍏ㄨ〃 216 琛屽墠鍚� md5 涓�鑷�**锛坄a2a733b2c5321a9d5efa9be2e0c5dacb`锛� | 閫氳繃 |
+| 11 | 鍥炲綊-娴嬭瘯鏈熸竻鐞� | 閫愪釜 `POST /api/import/clear?period=2099-0x` | 娴嬭瘯鏈熸暟鎹笌鎵规鍏ㄩ儴鍒犻櫎 | 鍚勬湡 dataRows=18銆乥atchRows=1 鍒犻櫎鎴愬姛锛涘綋鍓嶅簱 **0 鏉� 2099 鏁版嵁銆�0 鏉� 2099 鎵规** | 閫氳繃 |
+| 12 | 鍥炲綊-鐪熷疄鏈堜唤鎬婚噺 | 缁熻 `freight_turnover_import` | 涓庡鍏ュ墠鍙ｅ緞涓�鑷� | 12 涓姤琛ㄦ湡 脳 18 琛� = **216 琛�**锛�2021-12 / 2022-12 / 2024-12 / 2025-12 / 2026-01鈥�2026-08锛� | 閫氳繃 |
+
+## 鍙戠幇鐨勯棶棰樹笌澶勭疆
+1. **婧愭枃浠剁己 2023 骞� Sheet**锛氬鑷翠笉鐢熸垚 `2023-12` 鎶ヨ〃鏈燂紝`2024-12` 鏃犱笂骞村悓鏈燂紙`last_*` 涓虹┖锛夈�傚睘婧愭暟鎹己鍙ｏ紝闈炰唬鐮佺己闄凤紱宸插瀹炲弽鏄犲湪搴撳唴銆�
+2. **鎶ヨ〃鏈熻涔変负銆屾暣骞淬��**锛歚2021-12` 绛夋湡瀹為檯鎵胯浇璇ュ勾 1鈥�12 鏈堢殑鍏ㄥ勾鏁版嵁锛堣�岄潪 12 鏈堝崟鏈堬級銆傝嫢鍚庣画鎶ヨ〃/瀹℃牳鎸夈�屽崟鏈堛�嶅彛寰勫彇杩欎簺鏈燂紝闇�瑕佺敤鎴风‘璁ゅ彛寰勶紱鏈鏈仛鏀瑰姩銆�
+3. **閲嶅瀵煎叆浼氳鐩栧悓鎶ヨ〃鏈�**锛氭柊閫昏緫寤剁画銆屽厛鍒犲悗鎻掋�嶇殑骞傜瓑绛栫暐锛岄噸瀵� `2026-08` 浼氳鐩栬鏈熷師鏈夊�笺�傛湰娆″凡閫愰」鏍稿婧愭枃浠朵笌搴撳唴涓�鑷达紙宸紓 0锛夛紝鏃犳暟鎹崯澶便��
+4. **澶囦唤涓嶅畬鏁达紙宸茶褰曪級**锛氭敼鍔ㄥ墠鐨勫浠� `_backup_freight_turnover_before_multiyear_20260916.sql` 鍙湁 59642 瀛楄妭涓斾粎瑙ｆ瀽鍑� `2026-04` 涓�澶� INSERT锛屼笉鑳戒綔涓哄畬鏁村洖婊氫緷鎹��**涓嶈鎶婅鏂囦欢褰撲綔瀹屾暣澶囦唤浣跨敤銆�**
+5. **2026-01鈥�2026-07 鐨� `last_*` 涓虹┖**锛氱粡鏍稿澶囦唤锛坄2026-04`锛夌‘璁よ繖鍑犳湡鍦ㄦ湰娆℃敼鍔ㄥ墠 `last_*` 鍗充负绌猴紝涓旀湰娆″鍏ユ湭瑙︾杩欎簺鎶ヨ〃鏈燂紙鎵规璁板綍鍙鐩� 5 涓湡锛夛紝鏁呴潪鏈鏀瑰姩寮曞叆銆�
+
+## 缁撹
+- 閫氳繃銆傚骞村害宸ヤ綔绨匡紙21鈥�26 骞达級宸插叏閮ㄥ叆搴擄紝閫愬勾涓�涓姤琛ㄦ湡銆侀�愬勾涓婂勾鍚屾湡锛�1080 涓崟鍏冩牸閫愰」姣斿闆跺樊寮傦紱闈炲骞村害鏂囦欢鑷姩鍥為��鍘熸湁鏈堝害璺緞锛岃礋鍚戜笌杈圭晫鐢ㄤ緥鍧囩鍚堥鏈燂紱閲嶅瀵煎叆骞傜瓑锛屾祴璇曟湡宸叉竻鐞嗗共鍑�锛岀湡瀹炴湀浠芥暟鎹笌鏀瑰姩鍓嶅彛寰勪竴鑷达紙216 琛� / 12 鏈燂級銆�
+- 寰呯敤鎴风‘璁わ細`2021-12` 绛夈�屾暣骞淬�嶆姤琛ㄦ湡鐨勪笟鍔″彛寰勬槸鍚︾鍚堝悗缁姤琛�/瀹℃牳鍙栨暟瑕佹眰锛涘闇�銆岄�愭湀鎶ヨ〃鏈熴�嶏紝闇�瑕佸彟琛屾敼閫狅紙鏈鏈仛锛夈��
\ No newline at end of file

--
Gitblit v1.9.1