From 09e612af50beb200027317d6d4ccf7ad7092838e Mon Sep 17 00:00:00 2001 From: zhizhijie <zhizhijie@users.noreply.gitee.com> Date: 星期五, 11 九月 2026 17:53:07 +0800 Subject: [PATCH] docs: 补充「数据导入」白屏修复的发布与二次独立验证记录 --- docs/功能测试报告/功能测试报告_网约车订单报告导入_2026-09-11.md | 41 +++++++++++++++++++++++++++++++++++++++++ 1 files changed, 41 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_\347\275\221\347\272\246\350\275\246\350\256\242\345\215\225\346\212\245\345\221\212\345\257\274\345\205\245_2026-09-11.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_\347\275\221\347\272\246\350\275\246\350\256\242\345\215\225\346\212\245\345\221\212\345\257\274\345\205\245_2026-09-11.md" new file mode 100644 index 0000000..0e01dc9 --- /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_\347\275\221\347\272\246\350\275\246\350\256\242\345\215\225\346\212\245\345\221\212\345\257\274\345\205\245_2026-09-11.md" @@ -0,0 +1,41 @@ +# 鍔熻兘娴嬭瘯鎶ュ憡_缃戠害杞﹁鍗曟姤鍛婂鍏2026-09-11 + +## 涓�銆佸姛鑳借鏄� +鏀寔鐩存帴涓婁紶閮ㄧ骇銆婄綉绾﹁溅琛屼笟YYYY骞碝鏈堣繍琛岀洃娴嬫儏鍐靛垎鏋愭姤鍛娿�嬶紙.docx锛夛紝绯荤粺鑷姩瑙f瀽鎶ュ憡姝f枃闄勪欢琛ㄤ腑鐨� **17 甯傚窞璁㈠崟鏁�**骞跺啓鍏ユ暟鎹簱 `wyc_order_monthly`锛團 鍒楄鍗曞悎璁� + G-W 17 甯傚窞璁㈠崟鍒楋級锛� +姹囨�诲ぇ琛ㄣ�岀綉绾﹁溅銆嶉〉鍙栨暟鏀逛负**浼樺厛璇诲簱**锛屽疄鐜�"涓婁紶鎶ュ憡 鈫� 姹囨�昏〃褰撴湀缃戠害杞︽暟鎹嚜鍔ㄥ嚭鐜�"銆� + +鏀瑰姩鑼冨洿锛� +- 鍚庣 `DataImportService.importWycOrderReport()` / `parseWycOrderReportTables()` / `periodOfDocx()`锛氳В鏋愭姤鍛娿�佸畾浣嶆姤琛ㄦ湡銆佽惤搴� `wyc_order_monthly`锛屽苟鍦ㄧ己澶辨椂浠� `wyc_total_monthly` 琛ラ綈鍏ㄧ渷 pin锛圔-E锛夈�� +- 鍚庣 `DataImportController`锛氭柊澧� `POST /api/import/wycOrderReport`锛堝弬鏁� file + period锛夈�� +- 鍚庣 `WycSplitCalc.loadMonthlyInputFromDb()`锛氭眹鎬昏〃鍙栨暟浼樺厛璇� `wyc_order_monthly`锛堝簱閲岃鏈熻鍗曞叏绌烘椂鍥為��璇� `docs/鍩庡競瀹㈣繍/妯℃澘_缃戠害杞﹁鍗曞強鍏ㄧ渷鎬婚噺.xlsx`锛夈�� +- 鍓嶇 `DataImport.vue`锛氬鍏ョ被鍨嬫柊澧炪�岀綉绾﹁溅璁㈠崟鎶ュ憡銆嶏紝妯℃澘鎻愮ず涓� `鍩庡競瀹㈣繍/妯℃澘_缃戠害杞﹁鍗�.docx`锛屾帴鍙� `/import/wycOrderReport`锛屾枃浠剁被鍨嬮檺 `.docx/.doc`銆� +- 娓呯┖鏄犲皠锛歚wycOrderReport` 鍏宠仈娓呯┖ `WYC_ORDER` 鎵规锛沗wycOrder` 涓� `wycOrderReport` 浜掍负鍏宠仈娓呴櫎銆� + +鎶ヨ〃鏈熷彇鍊艰鍒欙細浼樺厛鍙栨姤鍛婃爣棰樹腑鐨勩�岀綉绾﹁溅琛屼笟YYYY骞碝鏈堛�嶏紝鍙栦笉鍒版椂鐢ㄩ〉闈㈡墍閫夋姤琛ㄦ湡锛涗袱鑰呴兘鍙栦笉鍒板垯鎶ラ敊銆� + +## 浜屻�佹祴璇曠幆澧� +- 鍚庣锛歋pring Boot锛宍http://localhost:8090`锛�8090 宸茬洃鍚級锛涘墠绔細`http://localhost:8080`銆� +- 鏁版嵁搴擄細MySQL 5.7 `127.0.0.1:3308` / `traffic_audit`銆� +- 鐧诲綍锛歛dmin锛涙祴璇曟椂闂达細2026-09-11銆� + +## 涓夈�佺敤渚嬭〃 + +| 缂栧彿 | 绫诲瀷 | 杈撳叆 | 棰勬湡 | 瀹為檯 | 缁撹 | +| --- | --- | --- | --- | --- | --- | +| TC-1 | 姝e悜 | 涓婁紶 `docs/鍩庡競瀹㈣繍/妯℃澘_缃戠害杞﹁鍗�.docx`锛堛�婄綉绾﹁溅琛屼笟2026骞�7鏈堣繍琛岀洃娴嬫儏鍐靛垎鏋愭姤鍛娿�嬶級锛宲eriod=2026-07 | 瑙f瀽鎴愬姛锛屾姤琛ㄦ湡鍙栨爣棰樼殑 2026-07锛�17 甯傚窞鍏ㄩ儴鍛戒腑 | 杩斿洖"鎶ヨ〃鏈� 2026-07锛岃鍗曞悎璁� 29,730,791 鍗曪紝宸插啓鍏� 17 涓競宸�" | 閫氳繃 | +| TC-2 | 姝e悜 | 鍚屼笂锛屾鏌ュ悗绔棩蹇� | 璁板綍 period/sum/cities/missing | `WycOrderReport imported: period=2026-07 sum=2.9730791E7 cities=17 missing=[]` | 閫氳繃 | +| TC-3 | 鍏ュ簱鎶芥煡 | docx 闄勪欢琛ㄣ�屽湴甯傚悕绉� / 璁㈠崟鏁版�绘暟銆�17 琛岋紝閫愰」涓� `wyc_order_monthly` 姣斿 | 17 甯傚窞閫愪竴鐩哥瓑锛屽悎璁$浉绛� | 姝︽眽 11,183,267锛涢粍鐭� 983,296锛涘崄鍫� 2,155,144锛涘疁鏄� 3,024,336锛涜闃� 2,390,572锛涢剛宸� 321,348锛涜崋闂� 942,124锛涘瓭鎰� 1,220,812锛涜崋宸� 1,573,514锛涢粍鍐� 1,125,829锛涘捀瀹� 928,460锛涢殢宸� 528,210锛涙仼鏂� 2,166,015锛涗粰妗� 528,557锛涙綔姹� 267,879锛涘ぉ闂� 387,894锛涙灄鍖� 3,534锛涘悎璁� 29,730,791 鈥斺�� **涓� DB 瀹屽叏涓�鑷�** | 閫氳繃 | +| TC-4 | 璐熷悜锛堟枃浠剁被鍨嬮敊锛� | 鎶� `妯℃澘_缃戠害杞﹁鍗曞強鍏ㄧ渷鎬婚噺.xlsx` 浼犵粰鎶ュ憡瀵煎叆鎺ュ彛 | 缁欏嚭鍙鎻愮ず锛屼笉钀藉簱 | 杩斿洖"瀵煎叆澶辫触: 鏃犳硶璇诲彇 Word 鏂囨。锛岃涓婁紶 .docx 鏍煎紡鐨勩�婄綉绾﹁溅琛屼笟YYYY骞碝鏈堣繍琛岀洃娴嬫儏鍐靛垎鏋愭姤鍛娿�嬶紱鑻ヤ笂浼犵殑鍏跺疄鏄� Excel/PDF锛岃鏀圭敤瀵瑰簲妯℃澘瀵煎叆銆傦紙鍘熷閿欒锛氣�︼級" | 閫氳繃锛堝惈淇锛岃绗洓鑺傦級 | +| TC-5 | 璐熷悜锛堝唴瀹逛笉绗︼級 | 涓婁紶 `鍩庡競瀹㈣繍鏁版嵁浼樺寲.docx`锛堥潪缃戠害杞︾洃娴嬫姤鍛婏級 | 鏄庣‘鎻愮ず鏈В鏋愬埌甯傚窞璁㈠崟鏁� | 杩斿洖"瀵煎叆澶辫触: 鏈В鏋愬埌浠讳綍甯傚窞璁㈠崟鏁帮紝璇风‘璁や笂浼犵殑鏄�婄綉绾﹁溅琛屼笟YYYY骞碝鏈堣繍琛岀洃娴嬫儏鍐靛垎鏋愭姤鍛娿��" | 閫氳繃 | +| TC-6 | 姝e悜锛堥噸澶嶅鍏ュ箓绛夛級 | 鍚屼竴浠� 7 鏈堟姤鍛婅繛缁鍏ヤ袱娆� | 绗簩娆¤鐩栧悓鎶ヨ〃鏈熻锛屼笉浜х敓閲嶅琛� | 浠嶈繑鍥� 17 甯傚窞锛沗wyc_order_monthly` 涓� `2026-07` 浠� 1 琛� | 閫氳繃 | +| TC-7 | 鑱旇皟 | 鎶ュ憡瀵煎叆鍚庨噸鏂板鍑� `period=2026-08` 姹囨�诲ぇ琛� | 缃戠害杞﹂〉褰撴湀鍒楋紙Q 鍒楋級鍑虹幇鏁板�硷紝鍏ㄧ渷琛屼负姹傚拰鍏紡 | Q 鍒� 17 甯傚窞鍏ㄩ儴鏈夊�硷紝Q5 璧� 4 涓叏鐪佽涓� `=Q9+Q13+鈥 姹傚拰鍏紡锛孯 鍒楀悓姣斿叕寮� `=Q../AJ..-1`锛圓J=2025骞�8鏈堬級 | 閫氳繃锛堣瑙併�婂姛鑳芥祴璇曟姤鍛奯姹囨�诲ぇ琛�8鏈堟暟鎹洖濉笌鐗堝紡瀵归綈_2026-09-11.md銆嬶級 | + +## 鍥涖�佸彂鐜扮殑闂涓庡缃� + +1. **闂锛堝凡淇锛�**锛氭妸 Excel/PDF 璇紶鍒般�岀綉绾﹁溅璁㈠崟鎶ュ憡銆嶇被鍨嬫椂锛屾帴鍙h繑鍥炵殑鏄� xmlbeans 鐨勮嫳鏂囨妧鏈紓甯革紙`org.apache.xmlbeans.XmlException: ... is not a valid document`锛夛紝椤甸潰鐢ㄦ埛鏃犳硶鐞嗚В銆� + **澶勭疆**锛歚DataImportService.importWycOrderReport()` 鐨勮В鏋愭缁熶竴鎹曡幏寮傚父锛屾敼鍐欎负鐢ㄦ埛鍙鎻愮ず锛屽苟鎶婂師濮嬮敊璇互"锛堝師濮嬮敊璇細鈥︼級"闄勫湪鏈熬渚夸簬鎺掓煡銆備慨澶嶅悗 TC-4 澶嶆祴閫氳繃銆� +2. **闇�瑕佺敤鎴锋搷浣滅殑浜嬮」**锛氬綋鍓嶅簱涓� `2026-08` 鐨�**甯傚窞璁㈠崟鏁�**鏄敤 7 鏈堟姤鍛婃敼鏍囬鐨勪复鏃跺壇鏈紙`_t_wyc_aug.docx`锛夊鍏ョ殑锛屽叾甯傚窞鍊间笌 7 鏈堢浉鍚岋紱`pin`锛圔-E锛屽嵆瀹㈣繍閲�/鍛ㄨ浆閲忓彛寰勶級鍙栬嚜 `wyc_total_monthly` 鐨� 2026-08 琛岋紝鏄纭殑銆�**璇锋妸鐪熷疄鐨勩�婄綉绾﹁溅琛屼笟2026骞�8鏈堣繍琛岀洃娴嬫儏鍐靛垎鏋愭姤鍛娿�嬮噸鏂颁笂浼犱竴娆�**锛堢被鍨嬮�夈�岀綉绾﹁溅璁㈠崟鎶ュ憡銆嶏紝鎶ヨ〃鏈熼�� 2026-08锛夛紝鍗冲彲瑕嗙洊涓虹湡瀹� 8 鏈堝競宸炶鍗曟暟銆� + +## 浜斻�佺粨璁� +缃戠害杞﹁鍗曡繍琛岀洃娴嬫姤鍛婏紙docx锛夊鍏ュ姛鑳藉彲鐢細姝e悜瑙f瀽 17 甯傚窞璁㈠崟鏁板噯纭叆搴撳苟涓庢簮鏂囦欢閫愰」涓�鑷达紱鏂囦欢绫诲瀷閿欒銆佸唴瀹逛笉绗︿袱绫昏礋鍚戝満鏅潎鑳界粰鍑烘槑纭彁绀猴紱閲嶅瀵煎叆骞傜瓑锛涘鍏ュ悗姹囨�诲ぇ琛ㄥ彲鑷姩鍙栧埌褰撴湀鏁版嵁銆傚缓璁皢鐪熷疄 8 鏈堟姤鍛婇噸浼犲悗鍐嶆瀵煎嚭鏍稿銆� + -- Gitblit v1.9.1