From a08c70db67e49bf6cd125df04ebaf68c26f0d8dd Mon Sep 17 00:00:00 2001
From: zhizhijie <zhizhijie@users.noreply.gitee.com>
Date: 星期日, 20 九月 2026 16:19:16 +0800
Subject: [PATCH] feat(投资): 市州月报统一填报模板 + 县(市、区)列解析 + 表头行判定收紧
---
docs/功能测试报告/功能测试报告_汇总大表异步导出与缓存_2026-09-20.md | 86 +++++++++++++++++++++++++++++++++++++++++++
1 files changed, 86 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_\346\261\207\346\200\273\345\244\247\350\241\250\345\274\202\346\255\245\345\257\274\345\207\272\344\270\216\347\274\223\345\255\230_2026-09-20.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_\346\261\207\346\200\273\345\244\247\350\241\250\345\274\202\346\255\245\345\257\274\345\207\272\344\270\216\347\274\223\345\255\230_2026-09-20.md"
new file mode 100644
index 0000000..6d90647
--- /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_\346\261\207\346\200\273\345\244\247\350\241\250\345\274\202\346\255\245\345\257\274\345\207\272\344\270\216\347\274\223\345\255\230_2026-09-20.md"
@@ -0,0 +1,86 @@
+锘�# 鍔熻兘娴嬭瘯鎶ュ憡_姹囨�诲ぇ琛ㄥ紓姝ュ鍑轰笌缂撳瓨_2026-09-20
+
+## 涓�銆佸姛鑳借鏄�
+
+鐢ㄦ埛涓婃姤锛堥棶棰� 3锛夛細**銆屾眹鎬诲ぇ琛ㄧ偣涓嬭浇鍚庤杩囦竴浼氭墠鍙嶅簲涓嬭浇锛岀幇鍦ㄦ暟鎹簱鐨勬暟鎹繕涓嶆槸寰堝锛岄偅鏁版嵁搴撶殑鏁版嵁澶氫簡杩欎釜绋嬪簭浼氬崱姝诲悧锛熴��**
+
+鑳屾櫙锛氭眹鎬诲ぇ琛ㄥ鍑烘槸**鍚屾璇锋眰**鈥斺�旂偣鍑诲悗娴忚鍣ㄨ绛� 10~20 绉掓墠鎷垮埌鏂囦欢锛堟瘝鐗堣鍙�+鍥炲～ 6.5s銆佹暣鏈害 4 涓囨牸鍏紡閲嶇畻 4.1s銆佸啓鐩樹紶杈� 3.4s锛夛紝鏈熼棿椤甸潰鏃犱换浣曞弽棣堬紱
+涓旂敓鎴愯繃绋嬩竴鐩村崰鐫� HTTP 璇锋眰绾跨▼锛屽浜哄悓鏃剁偣浼氳瀹瑰櫒绾跨▼姹犺闀夸换鍔″崰婊°��
+
+鏈鏀归�狅紙鐢ㄦ埛纭銆屽彲浠ャ�嶏級锛�
+
+1. **寮傛浠诲姟鍖�**锛氭柊澧� `ReportExportTaskService`锛堝浐瀹� 1 绾跨▼姹� `report-export-task`锛宒aemon锛夈��
+ 鍓嶇鎻愪氦鍚庣珛鍗虫嬁鍒般�屼换鍔″彿銆嶏紝鍐嶆寜 700ms 杞杩涘害锛堟楠� + 鐧惧垎姣� + 宸茬敤鏃堕暱锛夛紝瀹屾垚鍚庡崟鐙笅杞芥枃浠躲��
+2. **缁撴灉缂撳瓨**锛氬悓涓�鎶ヨ〃鏈� 10 鍒嗛挓鍐呯殑鎴愬姛缁撴灉鐩存帴澶嶇敤锛坄fromCache=true`锛夛紝璺宠繃姣嶇増璇诲彇涓庡叕寮忛噸绠楋紱
+ 缂撳瓨甯�**鏁版嵁鐗堟湰瀹堝崼**鈥斺�旀暟鎹増鏈彇 `SELECT IFNULL(MAX(id),0) FROM import_batch`锛屾湡闂村彧瑕佹湁鏂板鍏ュ氨鑷姩澶辨晥锛堝彇涓嶅埌鐗堟湰鏃剁鐢ㄧ紦瀛橈級銆�
+3. **鍘婚噸涓庢帓闃�**锛氬悓涓�鎶ヨ〃鏈熷凡鏈変换鍔″湪璺戞椂鐩存帴澶嶇敤璇ヤ换鍔★紝涓嶄細閲嶅鎺掗槦閲嶇畻銆�
+4. **鍓嶇杩涘害寮圭獥**锛氳繘搴︽潯 + 姝ラ鏂囨 + 宸茬敤鏃堕暱 + 缂撳瓨鏉ユ簮鏃堕棿 + 澶辫触鍘熷洜锛涚敓鎴愪腑鍙�屽悗鍙拌繍琛屻�嶏紙鏀跺脊绐楋紝瀹屾垚鍚庝粛鑷姩涓嬭浇锛夛紝瀹屾垚鍚庡彲銆屼繚瀛樻枃浠� / 閲嶆柊鐢熸垚 / 鍏抽棴銆嶃��
+5. **杩涘害鐐�**锛�2% 鏍￠獙姣嶇増 鈫� 6% 璇诲彇姣嶇増 鈫� 12% 杩樺師鏈堝害鍧� 鈫� 22% 鍥炲～褰撴湀鏁版嵁 鈫� 45% 鍒锋柊鎺掑悕椤典笌璺ㄩ〉鍚堟垚椤� 鈫� 70% 閲嶇畻鏁存湰鍏紡 鈫� 95% 鍐欏嚭鏂囦欢 鈫� 100% 瀹屾垚銆�
+
+鍥炵瓟鐢ㄦ埛鐤戦棶锛�**鏁版嵁閲忓澶т富瑕佹槸 SQL 鑱氬悎鍙樻參锛屼笉浼氥�屽崱姝汇��**锛涙敼閫犲悗鐢熸垚璧板悗鍙扮嚎绋嬨�佸悓鎶ヨ〃鏈熺粨鏋滃彲澶嶇敤銆佸悓鎶ヨ〃鏈熷苟鍙戣嚜鍔ㄥ幓閲嶏紝
+鍗充娇澶氫汉鍚屾椂鐐逛篃鍙槸鎺掗槦锛堝脊绐楁樉绀恒�屾帓闃熶腑銆嶏級锛屼笉浼氬崰婊� Web 绾跨▼銆�
+
+## 浜屻�佹祴璇曠幆澧�
+
+- 鍚庣 Spring Boot 8090锛坄Started TrafficAuditApplication` 15:10:53锛夈�佸墠绔� Vue 8080锛坄Compiled successfully`锛�
+- 鏁版嵁搴� MySQL localhost:3308/traffic_audit
+- 鎶ヨ〃鏈燂細2026-08锛堟湀鎶ワ紝姝ｅ父鐢ㄤ緥锛�/ 2025-01锛堟棤鏁版嵁锛岃礋鍚戠敤渚嬶級
+- 鎺ュ彛鑴氭湰锛歚_qa_task.ps1`銆乣_qa_task2.ps1`銆乣_qa_task3.ps1`锛堜繚鐣欐湭鍒狅級
+- 娴忚鍣ㄥ疄娴嬶細Playwright 1.57 + 鏈満 Chrome锛堟棤澶达級锛岀湡瀹炵偣鍑汇�屾姤琛ㄧ敓鎴愩�嶉〉鎸夐挳
+- 璇佹嵁鎴浘锛歚docs/鍔熻兘娴嬭瘯鎶ュ憡/姹囨�诲ぇ琛ㄥ紓姝ュ鍑鸿繘搴﹀脊绐梍2026-09-20.png`
+
+## 涓夈�佺敤渚嬭〃
+
+### 3.1 鎺ュ彛灞�
+
+| 缂栧彿 | 鐢ㄤ緥 | 杈撳叆 | 棰勬湡 | 瀹為檯 | 缁撹 |
+| --- | --- | --- | --- | --- | --- |
+| T-A1 | 鎻愪氦寮傛浠诲姟 | `GET /api/report/exportTask/summaryWorkbook?period=2026-08&mode=month` | 绔嬪嵆杩斿洖 taskId锛屼笉闃诲 | 鎻愪氦鑰楁椂 **0.07s**锛岃繘搴� 6鈫�22鈫�45鈫�70鈫�95鈫�100锛岀粓鎬� DONE锛�**14.4s** | 閫氳繃 |
+| T-A2 | 涓嬭浇浠诲姟鏂囦欢 | `GET /api/report/exportTask/{id}/file` | 杩斿洖 xlsx | 1,325,109 瀛楄妭锛�**1.27s** | 閫氳繃 |
+| T-A3 | 10 鍒嗛挓鍐呭悓鎶ヨ〃鏈熷鐢� | 鍐嶆鎻愪氦鍚屽弬鏁� | fromCache=true銆佸悓 taskId銆佽繎涔庣灛鏃� | fromCache=true锛�**0.01s**锛宼askId 鐩稿悓 | 閫氳繃 |
+| T-A4 | 寮哄埗閲嶇畻 | 鎻愪氦 `refresh=true` | 鏂颁换鍔″彿銆佺湡瀹為噸绠� | 鏂� taskId锛�14.2s 閲嶇畻瀹屾垚 | 閫氳繃 |
+| T-A5 | 杩愯涓苟鍙戝幓閲� | 杩炲彂涓ゆ `refresh=true` | 杩斿洖鍚屼竴 taskId | 鍚屼竴 taskId锛�11.1s | 閫氳繃 |
+| T-A6 | 鏂板瀵煎叆浣跨紦瀛樺け鏁� | 涓存椂鎻掑叆涓�鏉� `import_batch`锛坕d 533鈫�534锛夊悗鎻愪氦 | fromCache=false锛岄噸鏂扮敓鎴� | fromCache=false锛�11.4s 閲嶇畻锛�**娴嬭瘯鍚庡凡 DELETE 娓呭洖 id=533** | 閫氳繃 |
+| T-A7 | 璐熷悜锛氫笉瀛樺湪鐨� taskId | `GET /exportTask/notexist123` / `.../file` | 杩斿洖鏄庣‘閿欒 | 鐘舵�佹帴鍙� `code=500`銆屽鍑轰换鍔′笉瀛樺湪鎴栧凡杩囨湡锛堢敓鎴愮粨鏋滀繚鐣� 30 鍒嗛挓锛夈�嶏紱鏂囦欢鎺ュ彛 HTTP 500 + 鍚屾彁绀� | 閫氳繃 |
+| T-A8 | 璐熷悜锛氭湭瀹屾垚灏变笅杞� | 浠诲姟 RUNNING 鏃惰姹� `/file` | 鎷掔粷骞惰鏄� | 鎶涖�屽鍑轰换鍔″皻鏈畬鎴愶紙褰撳墠鐘舵�侊細RUNNING锛夈�� | 閫氳繃 |
+
+### 3.2 娴忚鍣ㄥ疄娴嬶紙鐪熷疄鐐瑰嚮锛�
+
+| 缂栧彿 | 鐢ㄤ緥 | 杈撳叆 | 棰勬湡 | 瀹為檯 | 缁撹 |
+| --- | --- | --- | --- | --- | --- |
+| UI-1 | 杩涘害寮圭獥 | 鎶ヨ〃鐢熸垚 鈫� 姹囨�诲ぇ琛� 鈫� 2026-08 鈫� 鐐广�屽鍑恒�� | 绔嬪嵆寮圭獥骞堕�愭。鎺ㄨ繘 | 寮圭獥鍗虫椂鍑虹幇锛屽疄娴嬮噰鏍凤細0.7s 璇诲彇姣嶇増宸ヤ綔绨�(6%) 鈫� 1.5s 鍥炲～褰撴湀鏁版嵁(22%) 鈫� 2.2s 鍒锋柊鎺掑悕椤典笌璺ㄩ〉鍚堟垚椤�(45%) 鈫� 7.2s 閲嶇畻鏁存湰鍏紡锛堢害 4 涓囨牸锛�(70%) 鈫� 10.1s 鍐欏嚭鏂囦欢(95%) 鈫� 11.6s 瀹屾垚(100%) | 閫氳繃 |
+| UI-2 | 瀹屾垚鍚庤嚜鍔ㄤ笅杞� | 鍚屼笂 | 鑷姩瑙﹀彂淇濆瓨 | 涓嬭浇 `鐢熸垚_閬撹矾杩愯緭閲忔眹鎬昏〃_2026-08.xlsx`锛�**1,325,109 瀛楄妭**锛屼笌鎺ュ彛浜х墿鍚屽搱甯� | 閫氳繃 |
+| UI-3 | 缂撳瓨鍛戒腑鎻愮ず | 鍏抽棴鍚庡啀娆＄偣銆屽鍑恒�� | 鎻愮ず鏉ユ簮鏃堕棿 + 銆屼笅杞姐�嶆寜閽� | 銆屼笂娆＄敓鎴愮敤鏃� 11.3 绉掋�嶃�屾湰娆＄洿鎺ヤ娇鐢� 2026-09-20 15:43:50 鐢熸垚鐨勭粨鏋滐紙10 鍒嗛挓鍐呬笖鏈熼棿娌℃湁鏂板鍏ユ暟鎹級銆嶏紝鎸夐挳鍙樸�屼笅杞姐�嶏紝绉掔骇瀹屾垚 | 閫氳繃 |
+| UI-4 | 銆岄噸鏂扮敓鎴愩�� | 缂撳瓨鎬佺偣銆岄噸鏂扮敓鎴愩�� | 鐪熷疄閲嶇畻 | 杩涘害浠� 0 閲嶆柊鎺ㄨ繘锛堛�屽凡鐢� 2.1 绉掋�嶏級锛屾寜閽尯鍒囧洖銆屼繚瀛樻枃浠�/閲嶆柊鐢熸垚/鍚庡彴杩愯銆嶏紝23.4s 鍐呭畬鎴愬苟鑷姩涓嬭浇 | 閫氳繃 |
+| UI-5 | 銆屽悗鍙拌繍琛屻�� | 鐢熸垚涓偣銆屽悗鍙拌繍琛屻�� | 鏀惰捣寮圭獥銆佷换鍔＄户缁�佸畬鎴愪粛鑷姩涓嬭浇 | 寮圭獥鏀惰捣 + 鎻愮ず銆屽凡杞叆鍚庡彴鐢熸垚锛屽畬鎴愬悗浼氳嚜鍔ㄤ笅杞姐�嶏紝闅忓悗鑷姩涓嬭浇 1,325,109 瀛楄妭 | 閫氳繃 |
+| UI-6 | 璐熷悜锛氭棤鏁版嵁鎶ヨ〃鏈� | 閫� 2025-01 鈫� 瀵煎嚭 鈫� 纭銆屼粛瑕佸鍑恒�� | 鏄剧ず澶辫触鍘熷洜銆佸彲鍏抽棴銆佷笉鍙繚瀛� | 寮圭獥鏄剧ず銆岀敓鎴愬け璐ワ綔鏈壘鍒版ā鏉挎枃浠�: 2025骞�1鏈堥亾璺繍杈撻噺姹囨�昏〃.xlsx銆嶏紝X 鍙叧闂紝銆屼繚瀛樻枃浠躲�嶇鐢紝銆岄噸鏂扮敓鎴愩�嶅彲鐢� | 閫氳繃 |
+| UI-7 | 浜х墿涓�鑷存�� | 鍐峰惎鍔ㄤ欢 vs 鍒锋柊閲嶇畻浠� | 鏁版嵁涓�鑷� | 涓ゆ浜х墿瑙ｅ寘鍚�**閫愭潯鐩竴鑷�**锛堟棤宸紓鏉＄洰锛夛紱涓変唤缂撳瓨涓嬭浇浠� SHA256 瀹屽叏鐩稿悓 | 閫氳繃 |
+
+### 3.3 椤烘墜澶嶉獙锛堢敤鎴烽棶棰� 2锛�
+
+| 缂栧彿 | 鐢ㄤ緥 | 杈撳叆 | 棰勬湡 | 瀹為檯 | 缁撹 |
+| --- | --- | --- | --- | --- | --- |
+| P-1 | 棰勮鍚屾瘮椤规槸鍚﹁ˉ鍏� | 姹囨�诲ぇ琛ㄩ瑙堝脊绐� | 8 椤瑰悓姣旈兘鍦� | 12 琛岋紙璐ц繍/鍩庡競瀹㈣繍/涓彛寰� 脳 褰撴湀路绱 脳 閲徛峰懆杞級锛屽悓姣斿垪榻愬叏 | 閫氳繃 |
+| P-2 | 銆岀疮璁¤揣鐗╁懆杞噺路绱鍚屾瘮 0%銆嶆槸鍚︿负 bug | 鏌ュ簱 `scale_split_transport` | 搴斾负鍙栨暟婧愭湰韬殑鍊� | 搴撳唴 `total_yoy=0.00000346`锛堢害 0.0003%锛夆啋 涓�浣嶅皬鏁板洓鑸嶄簲鍏ュ嵆 **0%**锛岄潪璁＄畻閿欒 | 閫氳繃锛堥潪缂洪櫡锛� |
+
+## 鍥涖�佸彂鐜扮殑闂涓庡缃�
+
+1. **`ReportExport.vue` 鍑虹幇閲嶅鐨� `computed` 閿紙鏈娴忚鍣ㄥ疄娴嬪彂鐜帮紝灞炰弗閲嶅洖褰掞級**
+ 鏂板鐨勫紓姝ュ鍑鸿绠楀睘鎬э紙taskRunning/taskDone/taskCacheTime锛夊彟璧蜂簡涓�涓� `computed: {`锛�
+ JS 瀵硅薄瀛楅潰閲�**鍚屽悕閿悗鑰呰鐩栧墠鑰�**锛屽鑷村師鏈夌殑 `username / realName / myModules / visibleModules` 璁＄畻灞炴�у叏閮ㄤ涪澶憋紝
+ 銆屾姤琛ㄧ敓鎴愩�嶉〉 `created()` 鐩存帴鎶� `Cannot read properties of undefined (reading 'filter')`锛�**鏁撮〉鐧藉睆涓嶅彲鐢�**銆�
+ 鈫� 宸叉妸 4 涓绠楀睘鎬у苟鍏ュ師 `computed` 鍧楋紙骞跺姞娉ㄩ噴璇存槑涓嶅彲鍙﹁捣鍚屽悕 key锛夛紝缂栬瘧閫氳繃骞舵祻瑙堝櫒澶嶉獙姝ｅ父銆�
+ 锛堟帴鍙ｅ眰娴嬭瘯鏃犳硶鍙戠幇姝ょ被闂锛岃繖涔熸槸鏈鍧氭寔鍋氭祻瑙堝櫒鐐瑰嚮瀹炴祴鐨勫師鍥犮�傦級
+2. **鎻愪氦/杞澶辫触鏃跺脊绐椾細绌鸿浆**锛氬悗绔粺涓�杩斿洖 `Result`锛堥敊璇椂 HTTP 浠� 200銆乣data` 涓虹┖锛夛紝
+ 鍘熶唬鐮佺洿鎺� `this.taskInfo = res.data || {}` 浼氬緱鍒颁竴涓┖瀵硅薄 鈫� 杩涘害鍋滃湪 0% 涓斾笉缁欐彁绀恒��
+ 鈫� 鎻愪氦涓庤疆璇㈤兘鏀逛负鍏堝垽 `res.code !== 200 || !res.data`锛氭彁浜ゅけ璐ョ珛鍗虫樉绀哄け璐ュ師鍥狅紱杞鍒や负銆屼换鍔″凡澶辨晥銆嶅苟鍋滄杞銆�
+3. **鐢熸垚涓脊绐楁棤鍑哄彛**锛氬師銆屽叧闂�嶆寜閽� `:disabled="!taskDone"`锛岀敓鎴愪腑涓変釜鎸夐挳鍏ㄧ伆銆佸彸涓婅 X 涔熼殣钘忥紝鐢ㄦ埛琚攣鍦ㄥ脊绐楅噷绛� 10~20 绉掋��
+ 鈫� 鏀逛负鐢熸垚涓樉绀恒�屽悗鍙拌繍琛屻�嶏紙鏀跺脊绐椼�佺户缁敓鎴愩�佸畬鎴愯嚜鍔ㄤ笅杞斤級锛岀粨鏉熷悗鎵嶆樉绀恒�屽叧闂�嶏紱X 鍦ㄦ垚鍔熸垨澶辫触鍚庡潎鍙銆�
+4. **缂撳瓨鎬佹枃妗堟涔�**锛氬懡涓紦瀛樻椂鍏冧俊鎭粛鍐欍�屽凡鐢� 11.3 绉掋�嶏紙鍏跺疄鏄笂娆＄敓鎴愯�楁椂锛夈��
+ 鈫� 缂撳瓨鎬佹敼涓恒�屼笂娆＄敓鎴愮敤鏃躲�嶏紝閬垮厤璇互涓烘湰娆′篃绠椾簡 11.3 绉掋��
+
+## 浜斻�佺粨璁�
+
+- 鎺ュ彛鐢ㄤ緥 8 鏉°�佹祻瑙堝櫒瀹炴祴 7 鏉°�佸楠� 2 鏉★紝**鍏ㄩ儴閫氳繃**锛涙棤閬楃暀鏈獙璇侀」銆�
+- 姹囨�诲ぇ琛ㄥ鍑虹幇鍦ㄦ槸銆岀偣鍑诲嵆鍙嶉 鈫� 杩涘害鍙 鈫� 瀹屾垚鍗充笅杞姐�嶏紝缂撳瓨鍛戒腑鏃剁绾ц繑鍥烇紱鍚屼竴鎶ヨ〃鏈熷苟鍙戣嚜鍔ㄥ幓閲嶏紝鐢熸垚涓嶅崰 Web 绾跨▼銆�
+- 闄勫甫淇浜嗕細瀵艰嚧鎶ヨ〃鐢熸垚椤垫暣椤电櫧灞忕殑閲嶅 `computed` 鍥炲綊锛堣闂鍦ㄦ帴鍙ｆ祴璇曚腑涓嶅彲瑙侊級銆�
\ No newline at end of file
--
Gitblit v1.9.1