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 |   60 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 files changed, 60 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\212\225\350\265\204\346\230\216\347\273\206\350\241\250\345\260\261\347\273\252\344\270\216\351\242\204\350\247\210\347\261\273\345\236\213\350\241\245\351\275\220_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\212\225\350\265\204\346\230\216\347\273\206\350\241\250\345\260\261\347\273\252\344\270\216\351\242\204\350\247\210\347\261\273\345\236\213\350\241\245\351\275\220_2026-09-20.md"
new file mode 100644
index 0000000..b9a1b5b
--- /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\212\225\350\265\204\346\230\216\347\273\206\350\241\250\345\260\261\347\273\252\344\270\216\351\242\204\350\247\210\347\261\273\345\236\213\350\241\245\351\275\220_2026-09-20.md"
@@ -0,0 +1,60 @@
+# 鍔熻兘娴嬭瘯鎶ュ憡_鎶曡祫鏄庣粏琛ㄥ氨缁笌棰勮绫诲瀷琛ラ綈_2026-09-20
+
+## 涓�銆佸姛鑳借鏄�
+
+**闂**锛氭姤琛ㄧ敓鎴愰〉闈腑锛屻�屽杩愮珯鎶曡祫鏄庣粏琛ㄣ�嶃�岀墿娴佺珯鍦烘姇璧勬槑缁嗐�嶆樉绀�
+`鏈煡鎶ヨ〃绫诲瀷锛歩nvestPassengerDetail / investLogisticsDetail`锛屾棤娉曢瑙�/瀵煎嚭銆�
+
+**鏍瑰洜**锛氫笉鏄暟鎹棶棰橈紙8 鏈堝杩�/鐗╂祦鎶曡祫鏈堟姤宸插湪搴擄細瀹㈣繍 39 琛屻�佺墿娴� 128 琛岋級銆�
+涓婁竴姝ュ彧鎶婅繖涓や釜绫诲瀷鎺ヨ繘浜�**瀵煎嚭**閾捐矾锛坄exportSelected` switch銆乣REPORT_FILE_NAMES`銆佸墠绔垪琛ㄣ�佷袱涓鍑烘帴鍙o級锛�
+婕忎簡**瀵煎嚭鍓嶇殑灏辩华鏍¢獙涓庨瑙�**閾捐矾锛�
+
+1. `checkExportReady()` 鐨� `switch (t)` 娌℃湁杩欎袱涓� case 鈫� 钀藉埌 `default`锛歚rows=0` + `notes.add("鏈煡鎶ヨ〃绫诲瀷锛�" + t)`锛屼簬鏄� `ready=false`锛�
+2. `isInvestType(t)` 鏈敹褰曡繖涓や釜绫诲瀷 鈫� 棰勮寰幆鏃笉褰掑叆鎶曡祫鍒嗘敮锛屼篃鎷夸笉鍒版湀搴﹁鐩栦笌鎶曡祫鎽樿銆�
+
+**澶勭疆**锛�
+- `checkExportReady()` 鏂板涓や釜 case锛氭寜绫诲埆锛堝杩愮珯鍦� / 鐗╂祦鍥尯锛夌粺璁� `investment_monthly` 璇ユ湡琛屾暟锛�
+  骞舵牎楠� `docs/鎶曡祫/妯℃澘/` 涓嬪搴旀瘝鐗堟槸鍚﹀瓨鍦紙缂烘瘝鐗堝垯鎻愮ず锛夛紱
+- `isInvestType()` 鏀跺綍涓や釜绫诲瀷锛堟湀搴﹁鐩� + 闂娓呭崟绾冲叆鎶曡祫鍒嗘敮锛夛紱
+- `investPreview()` 澧炲姞鎸夌被鍒繃婊ょ殑閲嶈浇锛坄category != null` 鏃跺彧缁熻璇ョ被鍒」鐩級锛�
+  浣夸袱寮犳槑缁嗚〃鐨勬憳瑕佷笉鍐嶆贩鍏ュ彟涓�绫诲埆鐨勫悎璁★紱鍘熸棤鍙傞噸杞戒繚鐣欍�佽涓轰笉鍙樸��
+- 鏈煡绫诲瀷鐨勫厹搴曟姤閿�**淇濈暀**锛堟湭琚墛寮憋級銆�
+
+## 浜屻�佹祴璇曠幆澧�
+
+| 椤� | 鍊� |
+| --- | --- |
+| 鏃ユ湡 | 2026-09-20 10:4x |
+| 鍚庣 | Spring Boot 8090锛堥噸鍚姞杞斤紝`Started TrafficAuditApplication` 10:49:51锛� |
+| 鍓嶇 | Vue 8080锛圚TTP 200锛� |
+| 鏁版嵁搴� | MySQL 127.0.0.1:3308 `traffic_audit` |
+| 鎶ヨ〃鏈� | 2026-08锛坢ode=month锛� |
+| 鎺ュ彛 | `GET /api/report/ready`銆乣GET /api/report/preview`锛坄types` 閫楀彿鍒嗛殧锛� |
+
+## 涓夈�佺敤渚嬭〃
+
+| 缂栧彿 | 鐢ㄤ緥 | 杈撳叆 | 棰勬湡 | 瀹為檯 | 缁撹 |
+| --- | --- | --- | --- | --- | --- |
+| T01 | 灏辩华鏍¢獙锛堟鍚戯級 | `types=investPassengerDetail,investLogisticsDetail` | 涓嶅啀鍑虹幇銆屾湭鐭ユ姤琛ㄧ被鍨嬨�嶏紝ready=true | 涓ら」鍧� `ready=true`銆乣note` 涓虹┖锛沗rows` = 39锛堝杩愶級/ 128锛堢墿娴侊級 | 鉁� 閫氳繃 |
+| T02 | 棰勮锛堟鍚戯級 | 鍚屼笂锛岃皟 `/api/report/preview` | 鏈夋湀搴﹁鐩栥�佹憳瑕佷笌闂娓呭崟 | 瑕嗙洊 `[8]`銆乣problems` 涓虹┖锛涙憳瑕侊細瀹㈣繍銆�39 椤圭洰 / 鏈湀 2048.1 / 鑷勾鍒� 38648.16 / 鑷紑濮� 550929.76 涓囧厓銆嶏紝鐗╂祦銆�128 椤圭洰 / 鏈湀 90185.9 / 鑷勾鍒� 704107.7 / 鑷紑濮� 2656354.31 涓囧厓銆� | 鉁� 閫氳繃 |
+| T03 | 鎽樿涓庡簱鍐呴�愰」瀵归綈锛堝叆搴撴娊鏌ワ級 | 涓婅堪鎽樿 vs SQL 鑱氬悎 | 瀹屽叏涓�鑷� | SQL锛氬杩� `2048.1 / 38648.16 / 550929.76`銆佺墿娴� `90185.9 / 704107.7 / 2656354.31`锛�**閫愰」涓�鑷�** | 鉁� 閫氳繃 |
+| T04 | 鍒嗙被鍒繃婊わ紙姝e悜锛� | 涓ゅ紶琛ㄦ槑缁嗘憳瑕� | 涓嶅簲娣峰叆鍙︿竴绫诲埆鏁版嵁 | 瀹㈣繍 39 琛屻�佺墿娴� 128 琛岋紝鎭板ソ绛変簬 39+128=167锛坄investPlan` 绛夊叏绫诲埆绫诲瀷浠嶈繑鍥� 167锛夛紝璇存槑鏄庣粏琛ㄥ凡鎸夌被鍒敹鏁� | 鉁� 閫氳繃 |
+| T05 | 瀵煎嚭鍥炲綊锛堟鍚戯級 | 璋� `/api/report/export/investPassengerDetail`銆乣.../investLogisticsDetail` | 浠嶈兘姝e父鍑鸿〃 | 鐢熸垚 `gen_pax_inv.xlsx`锛�29462 瀛楄妭锛夈�乣gen_log_inv.xls`锛�134144 瀛楄妭锛夛紱姝ゅ墠宸查獙璇佸杩愭眹鎬婚〉涓庡畾绋� 0 宸紓 | 鉁� 閫氳繃 |
+| T06 | 鍘熸湁鎶曡祫绫诲瀷鍥炲綊锛堟鍚戯級 | `types=investPlan,investBillion,investCounty,investFiveYearLogistics` | 琛屼负涓嶅彉 | 鍥涢」鍧� `ready=true`銆乣rows=167`銆佹棤 note | 鉁� 閫氳繃 |
+| T07 | 鏈煡绫诲瀷浠嶈鎷︽埅锛堣礋鍚戯級 | `types=foo` | 浠嶆彁绀烘湭鐭ョ被鍨嬩笖涓嶅氨缁� | `ready=false`銆乣rows=0`銆乣note=鏈煡鎶ヨ〃绫诲瀷锛歠oo` | 鉁� 閫氳繃 |
+| T08 | 缂烘瘝鐗堟彁绀猴紙璐熷悜路璁捐瑕嗙洊锛� | 绉昏蛋姣嶇増 | 鎻愮ず銆宒ocs/鎶曡祫/妯℃澘 涓嬬己灏戙�娾�︺�嬨�� | 鏈疄娴嬶紙鏈复鏃剁Щ鍔ㄧ敤鎴锋瘝鐗堟枃浠讹級锛涗唬鐮佽矾寰勪笌 `summaryWorkbook` 缂烘瘝鐗堝垽瀹氬悓鏋� | 鈿� 鏈墽琛� |
+
+## 鍥涖�佸彂鐜扮殑闂涓庡缃�
+
+| 缂栧彿 | 闂 | 鏍瑰洜 | 澶勭疆 |
+| --- | --- | --- | --- |
+| P01 | 涓ゅ紶鎶曡祫鏄庣粏琛ㄥ湪鎶ヨ〃鐢熸垚椤垫樉绀恒�屾湭鐭ユ姤琛ㄧ被鍨嬶細invest*Detail銆� | 鍙帴浜嗗鍑洪摼璺紝婕忎簡灏辩华鏍¢獙 `switch` 涓� `isInvestType` | 琛ラ綈 `checkExportReady` 涓や釜 case + `isInvestType` 鏀跺綍锛岃涓� |
+| P02 | 鏄庣粏琛ㄦ憳瑕佽嫢娌跨敤鍘� `investPreview` 浼氭贩鍏ュ彟涓�绫诲埆 | 鍘熸柟娉曞彧鎸夋姤琛ㄦ湡鑱氬悎鍏ㄩ儴鎶曡祫鏈堟姤 | 鏂板甯� `category` 鐨勯噸杞斤紝鎸夌被鍒繃婊ら」鐩� id锛涘師閲嶈浇淇濈暀 |
+| P03 | 銆屽悎銆�銆�銆�璁°�嶈鍏ュ簱浼氳櫄澧炲悎璁★紙鍓嶄竴鏅氫慨澶嶇殑杩炲甫褰卞搷锛� | 婧愯〃鍚堣琛岃褰撴垚椤圭洰 | 宸蹭慨澶嶏紱鏈鏍稿锛氬杩愭湰鏈堝畬鎴愮敱鍚悎璁¤鐨� 2130.1 鏀舵暃涓� **2048.1**锛屼笌 SQL 閫愰」涓�鑷达紝鏃犻仐鐣欏惈銆岃銆嶇殑椤圭洰琛� |
+
+## 浜斻�佺粨璁�
+
+7 鏉$敤渚嬮�氳繃銆�1 鏉★紙缂烘瘝鐗堟彁绀猴級鏈疄娴嬶細
+鎶ヨ〃鐢熸垚椤典袱寮犳姇璧勬槑缁嗚〃鐨勫氨缁�/棰勮宸叉仮澶嶆甯革紝鎽樿鎸夌被鍒繃婊や笖涓庡簱鍐� SQL 閫愰」涓�鑷达紝
+瀵煎嚭涓庡叾瀹冩姇璧勬姤琛ㄧ被鍨嬪潎鏃犲洖褰掞紝鏈煡绫诲瀷鍏滃簳鎷︽埅浠嶇劧鏈夋晥銆�
+姝ゅ墠銆屾湭鐭ユ姤琛ㄧ被鍨嬨�嶇函灞�**浠g爜婕忛厤**锛屼笌 8 鏈堟姇璧勬湀鎶ユ槸鍚﹀鍏ユ棤鍏� 鈥斺�� 鏁版嵁涓�鐩村湪搴擄紙瀹㈣繍 39 / 鐗╂祦 128锛夈��
\ No newline at end of file

--
Gitblit v1.9.1