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/功能测试报告/功能测试报告_汇总大表8月数据回填与版式对齐_2026-09-11.md | 70 +++++++++++++++++++++++++++++++++++ 1 files changed, 70 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\2508\346\234\210\346\225\260\346\215\256\345\233\236\345\241\253\344\270\216\347\211\210\345\274\217\345\257\271\351\275\220_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_\346\261\207\346\200\273\345\244\247\350\241\2508\346\234\210\346\225\260\346\215\256\345\233\236\345\241\253\344\270\216\347\211\210\345\274\217\345\257\271\351\275\220_2026-09-11.md" new file mode 100644 index 0000000..caad084 --- /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\2508\346\234\210\346\225\260\346\215\256\345\233\236\345\241\253\344\270\216\347\211\210\345\274\217\345\257\271\351\275\220_2026-09-11.md" @@ -0,0 +1,70 @@ +# 鍔熻兘娴嬭瘯鎶ュ憡_姹囨�诲ぇ琛�8鏈堟暟鎹洖濉笌鐗堝紡瀵归綈_2026-09-11 + +## 涓�銆佸姛鑳借鏄� +閽堝鐢ㄦ埛鍙嶉鐨� 4 涓棶棰橈紝瀵广�婇亾璺繍杈撻噺姹囨�昏〃銆嬪鍑洪摼璺仛鏁版嵁椹卞姩鍥炲～涓庣増寮忓榻愶細 + +1. **8 鏈堟暟鎹凡鍏ュ簱浣嗘眹鎬昏〃娌℃湁 8 鏈堟暟鎹�** 鈫� 姹囨�诲伐浣滅翱濉厖鍣ㄨ瘑鍒�屽綋鏈堝�煎垪銆嶏紙8 鏈堜负 Q 鍒楋級骞跺洖濉紱 +2. **鍚屾瘮涓�寰嬩互姹囨�昏〃 2025 骞� 8 鏈堟暟鎹负鍑�** 鈫� 褰撴湀鍚屾瘮鍒楋紙R 鍒楋級鍏紡缁熶竴涓� `=Q../AJ..-1`锛孉J 鍒楀嵆 2025 骞� 8 鏈堬紱 +3. **鍏氦銆佸嚭绉熸暟鎹槸鏃ユ湡褰㈠紡** 鈫� 鍥炲～鏁板�兼椂鎸夊悓琛� 1 鏈堝垪鏍峰紡濂楃敤锛岄伩鍏嶆暟鍊艰濂椾笂鏃ユ湡鏍煎紡锛堟樉绀烘垚 1902/1910 骞达級锛� +4. **鐝嚎鍖呰溅銆佽建閬撹疆娓″彧鏈夊垎甯傚窞娌℃湁鍏ㄧ渷鏁版嵁** 鈫� 涓哄叏鐪佽琛ラ綈鍚堣鍏紡锛堟瘝鐗堝師鏈彧瀵� 1 鏈堝啓姝诲叕寮忥級锛� +5. **鐗堝紡瀹屽叏鎸夈�婄敓鎴恄閬撹矾杩愯緭閲忔眹鎬昏〃.xlsx銆�** 鈫� 閫愬垪濂楃敤鍙傜収浠跺垪瀹�/闅愯棌鏍囪锛�**鍚庣画鎵╁垪锛�8 鏈� Q/R 鍒楋級涔熸寜鍙傜収浠跺搴�**銆� + +鏀瑰姩鑼冨洿锛� +- `SummaryWorkbookFiller`锛歚fillFreightSheet` / `fillWycSheet` 閲嶅啓锛堝彧鍥炲～鐩爣鏈熷綋鏈堬紝娲剧敓琛屼繚鎸佸叕寮忥級锛涙柊澧� `ensureMonthFormulas`銆乣ensureMonthYoyFormulas`銆乣monthColumnCapacity`锛� +- `ReportExportService`锛氬鍑烘椂璋冪敤 `ensureMonthFormulas` + 鏂板 `applySummaryReferenceLayout`锛堟寜鍙傜収浠跺榻愬垪瀹斤級锛� +- `WycSplitCalc`锛氭眹鎬昏〃缃戠害杞﹀彇鏁颁紭鍏堣搴撱�� + +鍏抽敭鍙ｅ緞锛氬綋鏈堝�煎垪锛�0 鍩猴級= `2 + 2*(m-1)`锛屽悓姣斿垪 = 鍊煎垪 + 1锛涘悓姣斿垎姣嶅浐瀹氫负 AJ 鍒楋紙2025 骞� 8 鏈堬級銆� + +## 浜屻�佹祴璇曠幆澧� +- 鍚庣 `http://localhost:8090`锛屽鍑烘帴鍙� `GET /api/report/export/summaryWorkbook?period=YYYY-MM`銆� +- 姣嶇増锛歚docs/鐢熸垚姹囨�诲ぇ琛�/2026骞�8鏈堥亾璺繍杈撻噺姹囨�昏〃.xlsx`锛涚増寮忓弬鐓э細`docs/鐢熸垚姹囨�诲ぇ琛�/鐢熸垚_閬撹矾杩愯緭閲忔眹鎬昏〃.xlsx`銆� +- 娴嬭瘯鏃堕棿锛�2026-09-11銆� + +## 涓夈�佺敤渚嬭〃 + +### 3.1 姝ｅ悜锛�2026-08 鐢熸垚涓庡綋鏈堝彇鍊� + +| 缂栧彿 | 妫�鏌ラ」 | 棰勬湡 | 瀹為檯 | 缁撹 | +| --- | --- | --- | --- | --- | +| TC-1 | 瀵煎嚭 2026-08 | HTTP 200锛屾甯镐骇鍑烘枃浠� | 4.6 绉掕繑鍥烇紝948,735 瀛楄妭 | 閫氳繃 | +| TC-2 | 鍚庣鍥炲～鏃ュ織 | 鏈夊啓鍏ユ牸鏁扮粺璁°�佹棤缂烘暟鎻愮ず | 鍐欏叆褰撴湀鍊兼牸鏁�=1659锛岃ˉ鍐欏綋鏈堝悓姣斿叕寮忔牸鏁�=600锛岃ˉ鍐欏綋鏈堝悎璁″叕寮忔牸鏁�=43锛屽榻愬垪瀹藉垪鏁�=422锛岀己鏁版彁绀�=[] | 閫氳繃 | +| TC-3 | 璐ц繍椤靛叏鐪佸潡锛堣5-10锛塓 鍒� | 瑙勪笂/瑙勪笅璐ц繍閲忎笌鍛ㄨ浆閲忔湁鍊硷紝鍚堣琛屼负鍏紡 | 瑙勪笂璐ц繍閲� 3666.1401銆佽涓� 13222.6214銆佽涓婂懆杞� 570004.4355銆佽涓嬪懆杞� 1700006.166锛決5=`=Q7+Q9`銆丵6=`=Q8+Q10` | 閫氳繃 | +| TC-4 | 璐ц繍椤� 危17甯傚窞 = 鍏ㄧ渷 | 鐩哥瓑 | 危17甯傚窞璐ц繍閲� = 16888.7615锛涘叏鐪� Q5 = 3666.1401 + 13222.6214 = 16888.7615 | 閫氳繃 | +| TC-5 | 璐ц繍椤靛競宸炴淳鐢熻 | 涓嶅啓姝诲�硷紝淇濇寔鍏紡 | 姝︽眽 Q14锛堣涓�+瑙勪笅鍛ㄨ浆閲忥級=`=Q15+Q16`锛涜涓�/瑙勪笅鍒嗛」涓烘暟鍊� | 閫氳繃 | +| TC-6 | 缃戠害杞﹂〉 | 17 甯傚窞褰撴湀鏈夊�硷紝鍏ㄧ渷琛屼负鍏紡 | 姝︽眽 Q9=1879.9049鈥︺�丵10=13407.6982鈥︼紱鍏ㄧ渷 Q5=`=Q9+Q13+鈥�+Q73`锛浳�17甯傚窞瀹㈣繍閲�=4997.74銆佸懆杞噺=29166.7 | 閫氳繃 | +| TC-7 | 鍏氦椤� | 甯傚窞褰撴湀鏈夊�间笖**涓嶆槸鏃ユ湡鏄剧ず** | Q9=3856.83锛堟姹夊杩愰噺锛夛紝鍗曞厓鏍兼牸寮� `0.00`锛涘叏鐪� Q5 涓烘眰鍜屽叕寮� | 閫氳繃 | +| TC-8 | 鍑虹椤� | 鍚屼笂 | Q9=1058.95锛堟姹夊杩愰噺锛夛紝鏍煎紡 `0.00`锛涘叏鐪� Q5 涓烘眰鍜屽叕寮� | 閫氳繃 | +| TC-9 | 鐝嚎鍖呰溅椤靛叏鐪佽 | 鏈夊叏鐪佸悎璁★紙鍘熺己澶憋級 | Q4=`=Q8+Q10+Q14+鈥�+Q56`銆丵5=`=Q9+Q11+鈥�+Q57`銆丵6/Q7 涓綋鍚堣浜︿负鍏紡 | 閫氳繃 | +| TC-10 | 杞ㄩ亾銆佽疆娓￠〉鍏ㄧ渷琛� | 鏈夊叏鐪佸悎璁★紙鍘熺己澶憋級 | 杞ㄩ亾 鍏ㄧ渷 Q4=`=SUM(Q6,Q8)`銆丵5=`=Q7+Q9`锛涜疆娓� 鍏ㄧ渷 Q13=`=Q15`銆丵14=`=Q16` | 閫氳繃 | +| TC-11 | 鍚屾瘮鍏紡鎸囧悜 2025 骞� 8 鏈� | R 鍒楀垎姣嶄负 AJ 鍒� | 鍚勯〉琛ㄥご AJ 鍒� = `2025骞�8鏈坄锛汻 鍒楀叕寮忓舰濡� `=Q9/AJ9-1`锛汚J 鍒楃‘鏈� 2025 骞� 8 鏈堟瘝鐗堟暟鍊硷紙濡傝揣杩� AJ7=3716.1158锛� | 閫氳繃 | +| TC-12 | 鎵撳紑鍗抽噸绠� | 鏂囦欢甯﹀叏閲忛噸绠楁爣璁� | `xl/workbook.xml` 鍐� `<calcPr calcId="191029" fullCalcOnLoad="true"/>`锛孍xcel/WPS 鎵撳紑鍗崇畻鍑哄叏鐪佸悎璁� | 閫氳繃 | + +### 3.2 鐗堝紡瀵归綈锛堢 5 椤癸級 + +| 缂栧彿 | 妫�鏌ラ」 | 棰勬湡 | 瀹為檯 | 缁撹 | +| --- | --- | --- | --- | --- | +| TC-13 | 鍏ㄨ〃鍒楀涓庛�婄敓鎴恄閬撹矾杩愯緭閲忔眹鎬昏〃銆嬫瘮瀵癸紙灞曞紑 `<col min..max>` 鑼冨洿閫愬垪姣斿锛� | 瀹屽叏涓�鑷� | 19 涓〉绛惧叏閮ㄦ瘮瀵癸紝**鐪熷疄宸紓 0 鍒�** | 閫氳繃 | +| TC-14 | 鎵╁垪锛�8 鏈� Q/R锛夊垪瀹� | 涓庡弬鐓т欢 8 鏈堜竴鑷� | 璐ц繍 P/Q/R = 12.67/10.55/11.67锛堝弬鐓� 12.67/10.56/11.67锛屼粎 0.01 娴偣鑸嶅叆锛夛紱缃戠害杞�/杞ㄩ亾杞浮 Q/R=13.0/13.0锛涘叕浜� Q/R=11.89/13.0锛涘嚭绉� Q/R=11.89/13.0锛涚彮绾垮寘杞� Q/R=10.22/9.78 鈥斺�� 鍧囦笌鍙傜収浠剁浉鍚� | 閫氳繃 | + +### 3.3 璐熷悜涓庡洖褰� + +| 缂栧彿 | 妫�鏌ラ」 | 棰勬湡 | 瀹為檯 | 缁撹 | +| --- | --- | --- | --- | --- | +| TC-15 | 鍘嗗彶鏈堬紙2026-07锛変笉寰楄褰撴湀鍥炲～姹℃煋锛氫笌 `docs/鐢熸垚姹囨�诲ぇ琛�/_澶囦唤_2026骞�7鏈堥亾璺繍杈撻噺姹囨�昏〃_娓呯悊鍓峗20260904.xlsx` 閫愭牸姣斿 | 闄ゆ棦瀹氭敼閫犲鏃犲樊寮� | 宸紓鍏变笁绫伙細鈶� 426 澶勬诞鐐规湯浣嶅樊锛堟渶澶х浉瀵瑰樊 7.26e-15锛屽睘 Excel 15 浣嶆湁鏁堟暟瀛楁埅鏂紝鏃犲疄璐ㄥ樊寮傦級锛涒憽 57 澶�"鏂囨湰 vs 绛夊�兼暟瀛�"锛涒憿 148 澶勫叏閮ㄩ泦涓湪銆屼腑鍙ｅ緞鎺掑悕銆嶉〉 鈥斺�� 璇ラ〉宸︿晶闄堟棫鍧楀凡浜� 2026-09-08 鎸夐渶姹傛暣鍧楀垹闄わ紝灞�**棰勬湡鍙樺寲**銆�**鏃犲洖褰�** | 閫氳繃 | +| TC-16 | 缂烘湀鎻愮ず | 缂烘暟鎹殑鏈堜唤鏈夋彁绀� | 2026-08 瀵煎嚭 `缂烘暟鎻愮ず=[]` | 閫氳繃 | + +## 鍥涖�佸彂鐜扮殑闂涓庡缃� + +1. **闂锛堝凡淇锛�**锛歚monthColumnCapacity` 鍘熷疄鐜板彧璁�"鍚� 2026+绱"鐨勮〃澶达紝鑰岃揣杩愰〉琛ㄥご鏄�"绱鍛ㄨ浆閲�"锛屽鑷村叾鎭掕繑鍥為粯璁ゅ垪鏁般��8 鏈堝垪姘镐笉鍥炲～銆�**澶勭疆**锛氭敼涓恒�岀疮璁″垪銆嶄笌銆屾渶鍚庝竴涓湀浠�/鏃ユ湡鏍煎紡鏈堝垪銆嶅彇杈冨ぇ鍊笺�� +2. **闂锛堝凡淇锛�**锛歚shiftFormulaColumns` 杩炵画缁勫紩鐢ㄨ鎷兼垚 `Q5AJ5O5`銆�**澶勭疆**锛歚sb.append(quoteReplacement(...))` 鈫� `m.appendReplacement(sb, quoteReplacement(...))`銆� +3. **闂锛堝凡淇锛�**锛歚ensureMonthYoyFormulas` 涓� `setCellFormula` 澶辫触琚潤榛樺悶鎺夈��**澶勭疆**锛氭敼涓烘姏鍑哄惈椤电/鍗曞厓鏍�/鍘熷紡/鐩爣寮忕殑 `IllegalStateException`锛屼究浜庡畾浣嶃�� +4. **闂锛堝凡淇锛�**锛氬洖濉洰鏍囨牸鑻ヨ濂椾笂鏃ユ湡鏍煎紡锛屾暟鍊间細鏄剧ず鎴� 1902/1910 骞达紙鍗崇敤鎴峰弽棣堢殑"鏃ユ湡褰㈠紡"锛夈��**澶勭疆**锛歚setNumeric` 瀵圭┖/鏃ユ湡鏍煎紡鏍煎鐢ㄥ悓琛� 1 鏈堝垪鏍峰紡锛涘宸叉湁鍏紡鏍肩洿鎺ヨ烦杩囦笉瑕嗙洊銆� +5. **宸茬煡鏃犲鍛婅**锛�2026-08 瀵煎嚭鏃舵棩蹇楀嚭鐜� `姹囨�诲伐浣滅翱鏈壘鍒板悓鏈熷浠芥瘝鐗堬紙_澶囦唤_2026骞�8鏈堚�︼級锛岃緭鍑哄皢淇濇寔姣嶇増鐜扮姸`銆傚師鍥犳槸 8 鏈堟病鏈�"娓呯悊鍓嶅浠芥瘝鐗�"锛岃�� 8 鏈堟瘝鐗堟湰韬凡鏄畬鏁存瘝鐗堬紝鏃犻渶浠庡浠借繕鍘燂紝鏁呬笉褰卞搷杈撳嚭锛堝凡閫愰」楠岃瘉鍙栧�兼纭級銆�7 鏈堝洜瀛樺湪 `_澶囦唤_2026骞�7鏈堚� 鏃犳鍛婅銆� +6. **鎬ц兘娉ㄦ剰**锛歚applySummaryReferenceLayout` 鐨勫垪鏁颁笂闄愪繚鐣� `min(鍙傜収浠跺凡鐢ㄥ垪鏁�, 鐩爣浠跺凡鐢ㄥ垪鏁� + 4)` 鈥斺�� 鍘绘帀璇ヤ笂闄愪細璁� POI 鍦ㄥぇ鍒楀彿锛堣揣杩愰〉 147 鍒楋級涓婂嚭鐜版寚鏁扮骇鍗￠】銆� + +## 浜斻�佺粨璁� +8 鏈堟眹鎬诲ぇ琛ㄥ凡鑳界敱搴撲腑鏁版嵁鑷姩鐢熸垚锛氳揣杩愯涓�/瑙勪笅銆佺綉绾﹁溅銆佸叕浜ゃ�佸嚭绉熴�佺彮绾垮寘杞︺�佽建閬撹疆娓＄殑褰撴湀鍒楀潎宸插洖濉紝鍏ㄧ渷鍚堣涓庡垎甯傚窞鍚堣涓�鑷达紱鍚屾瘮缁熶竴鍙� 2025 骞� 8 鏈堬紱鍏氦/鍑虹涓嶅啀鏄剧ず涓烘棩鏈燂紱鐝嚎鍖呰溅涓庤建閬撹疆娓＄殑鍏ㄧ渷鏁版嵁宸茶ˉ榻愶紙鍏紡锛屾墦寮�鍗崇畻锛夛紱鍏ㄨ〃鍒楀涓庣敤鎴锋寚瀹氱殑銆婄敓鎴恄閬撹矾杩愯緭閲忔眹鎬昏〃銆嬮�愬垪涓�鑷达紙鍚� 8 鏈堟墿鍒楀搴︼級銆�7 鏈堝巻鍙叉湀鍥炲綊鏃犲疄璐ㄥ樊寮傘�� + +閬楃暀锛氳灏嗙湡瀹炵殑銆婄綉绾﹁溅琛屼笟2026骞�8鏈堣繍琛岀洃娴嬫儏鍐靛垎鏋愭姤鍛娿�嬮噸浼犱竴娆★紝瑕嗙洊褰撳墠鐢� 7 鏈堟姤鍛婁复鏃跺壇鏈鍏ョ殑 8 鏈堝競宸炶鍗曟暟銆� + -- Gitblit v1.9.1