From de1405ba56db542f64fb8bf5a381a19126837cb2 Mon Sep 17 00:00:00 2001
From: xyc <jc_xiong@hotmail.com>
Date: 星期一, 05 十月 2026 06:36:19 +0800
Subject: [PATCH] feat(deploy): pack-deploy 支持 -NoFrontend 生成单端口瘦包

---
 HANDOFF.md |   33 +++++++++++++++++++++++++++++++++
 1 files changed, 33 insertions(+), 0 deletions(-)

diff --git a/HANDOFF.md b/HANDOFF.md
index 0a0cf2c..a8b4f6d 100644
--- a/HANDOFF.md
+++ b/HANDOFF.md
@@ -5,6 +5,39 @@
 > **鍗忎綔绾﹀畾锛�2026-08-31锛�**锛氳銆屾彁浜ゃ��= 鏈湴 commit + 鎺ㄩ�佸埌杩滅 git锛坥rigin main锛孏itblit锛夛紝涓嶅啀鍙仛鏈湴 commit銆�
 
 ## 鏈�鏂帮紙2026-10-04锛�
+### 10-04 娣卞锛氭姌绾挎暟鍊兼爣绛惧洖鍒拌创杩戞湰鐐癸紙v35锛屽緟鐢ㄦ埛楠屾敹锛�
+
+- **鐢ㄦ埛鍙嶉**锛歷31銆岄伩寮�鎶樼嚎銆嶇増鏈笉濡備笂涓�鐗� v27 鈥斺�� 铏界劧鏍囩涓嶅帇绾夸簡锛屼絾寰堝鏍囩绂昏嚜宸辩殑鏁版嵁鐐瑰お杩滐紝涓�鐪肩湅涓嶅嚭鏍囩殑鏄摢涓偣銆傝姹傚洖鍒拌创杩戞湰鐐圭殑鏁堟灉銆�
+- **鏂伴棶棰樹笌鏃ч渶姹傜殑鍐茬獊**锛氭洿鏃╃殑鍘熷璇夋眰鏄�屾暟瀛楀帇绾跨湅涓嶆竻銆嶏紱杩欐璇夋眰鏄�屾暟瀛楀繀椤昏创杩戞湰鐐广�嶃�備袱鑰呭苟瀛橈紝蹇呴』鍚屾椂婊¤冻銆�
+- **瀹炵幇锛坄HolidayTrendChartService`锛�**锛�
+  - 鏍囩鎺掔増**瀹屾暣鍥為��鍒� v27 绠楁硶**锛氭寜鍚屾棩鐐逛綅璺濈鍋氫唬浠凤紙`ownDistance 脳10`锛夛紝鍊欓�夊惈杩�/杩滅殑涓娿�佷笅銆佸乏銆佸彸鍙婂洓瑙掞紝鍔ㄦ�佽鍒掍繚璇佸悓鏃ユ爣绛句笌鐐逛綅涓婁笅椤哄簭涓�鑷达紙`lineLabelCost`銆乣lineLabelCandidates`锛夈�倂31 鐨勭嚎鏉℃帺鑶溿�丆hamfer 璺濈鍦恒�侀鑹蹭翰鍜岄」鍏ㄩ儴绉婚櫎銆�
+  - **鏂板绮楃櫧鎻忚竟锛坔alo锛�** 瑙e喅銆屽帇绾跨湅涓嶆竻銆嶏細`drawLabelWithHalo` 鐢� `TextLayout` 鍙栧瓧褰㈣疆寤擄紝鍏堜互鐧借壊 `HALO_OUTLINE_WIDTH=4.0f` 鍦嗚鎻忚竟锛屽啀鐢ㄦ湰鑹插~鍏呫�傛暟瀛楀嵆浣胯惤鍦ㄦ姌绾夸笂涔熸竻鏅板彲璇伙紝浠庤�屽厑璁告爣绛捐创鍥炴湰鐐广�傛姌绾垮浘銆佸爢鍙犲浘澶栫疆鏍囩銆侀ゼ鍥炬爣绛剧粺涓�璧拌鏂规硶銆�
+  - 椤哄甫娓呯悊璋冭瘯閬楃暀锛氬垹闄� `LABEL_DEBUG`/`CHART_SEQ`/`TRENDDBG` 鎵撳嵃锛屼互鍙婁笉鍐嶄娇鐢ㄧ殑 `lineNormal(...)` 涓� `DayLabel.normalX/normalY`銆�
+- **閲忓寲楠岃瘉锛圧apidOCR 鏍囩鍖呭洿妗嗕腑蹇� 鈫� 鐪熷疄鏁版嵁鐐瑰潗鏍囷級**锛氭爣绛惧埌鏈偣骞冲潎璺濈 v27=`36.8px`銆乿31=`53.2px`銆乿35=`36.7px`锛堣秺灏忚秺璐磋繎鏈偣锛夈�倂35 涓庣敤鎴疯鍙殑 v27 鍩烘湰涓�鑷达紝鏄庢樉浼樹簬琚惁鐨� v31銆�
+- **鍏朵綑楠岃瘉**锛歚mvn compile`/`mvn test` 閫氳繃锛堟棤缂栬瘧鍛婅閬楃暀锛夛紱Word COM 8 椤� 15 鍥撅紙1+2脳7锛夛紱RapidOCR 澶嶆 12 寮犳姌绾垮浘鏁板�兼爣绛惧寘鍥存閲嶅彔鏁� = 0锛沗label_affinity` 澶嶆鍥� 11 姣忎釜鏁版嵁鏍囩鍒版湰绾� 3~8px 涓旀湰绾挎槸鏈�杩戠嚎锛堟棤銆孋LOSER TO 鍏朵粬鑹层�嶏級锛涙斁澶� 6脳 澶嶆牳鍥� 11 宸︿笂鏍囩纭负 `630.99`锛堜綆鍒嗚鲸鐜� OCR 鏇捐璇讳负 `1630.99`锛夈�倂27鈫攙35 鍍忕礌宸害 1%锛岄泦涓湪鏍囩澶勶紝鍗崇櫧鎻忚竟鐢熸晥涓旀湭鐮村潖鎶樼嚎銆�
+- **浜х墿涓庣姸鎬�**锛歚_tmp_holiday_verify/holiday_trend_2026-10-04_v35.docx`锛涗笅杞藉壇鏈� `C:\Users\jcxiong\Downloads\2026骞村崄涓�鍋囨湡鍏ㄧ渷缁煎悎杩愯緭瀹㈡祦閲忚蛋鍔垮浘锛堜慨鏀圭増-鏁板瓧璐磋繎鎶樼嚎-鐧借竟娓呮櫚锛�.docx`銆傛湭瀵煎叆銆佽鐩栨垨閲嶅浠讳綍鏁版嵁銆傚緟鐢ㄦ埛楠屾敹锛涢獙鏀跺墠涓嶆彁浜ゃ�佷笉鎺ㄩ�侊紱鐜版湁 `deploy/traffic-audit-deploy-20261004.zip` 浠嶆槸 v24 琛屼负锛岄獙鏀跺悗闇�閲嶅缓銆�
+
+### 10-05锛氳蛋鍔垮浘 v35 楠屾敹閫氳繃 + 鍗曠鍙g槮鍖呭彂甯冿紙 -NoFrontend 锛�
+
+- **楠屾敹**锛歷35锛堟姌绾挎暟鍊兼爣绛惧洖鍒拌创杩戞湰鐐� + 鐧芥弿杈癸級2026-10-05 鐢ㄦ埛楠屾敹閫氳繃銆�
+- **鎵撳寘闇�姹�**锛氭湇鍔″櫒鍗曠鍙i儴缃诧紝鍓嶇鏈鏈彉鍔紝瑕佹眰鍙戝竷鍖呬笉鍚墠绔互缂╁皬浣撶Н銆�
+- **鎵撳寘宸ュ叿**锛歚pack-deploy.ps1` 鏂板 `-NoFrontend`銆傚紑鍚悗涓嶆墽琛� npm 鏋勫缓銆佷笉瑕佹眰 `traffic-audit-web\dist`銆佷笉鐢熸垚 `frontend\`銆佷笉澶嶅埗 `backend\web`锛涘叾浣欙紙鍗犱綅绗︽瀯寤� + 鍘诲瘑鑷 + db + docs + README + WinSW锛夌収鏃с�傞儴缃叉満淇濈暀涓婁竴鐗� `backend\web`锛屾湰娆″彧鏇挎崲 jar銆�
+- **鍙戝竷鍖�**锛歚deploy/traffic-audit-deploy-20261005/`锛�311 鏂囦欢 / 105.71 MB锛泎ip 83.60 MB锛夈�傚凡鏍稿锛氭棤 `frontend/`銆佹棤 `backend\web`锛沯ar 鍐呯疆閰嶇疆鍏ㄥ崰浣嶇锛堝幓瀵嗚嚜妫�閫氳繃锛夛紱鍖呭唴 `HolidayTrendChartService.class` 涓� `target/classes` 涓�鑷达紙鍗冲惈 v35 浠g爜锛夈�備綋绉鏄庯細鍓嶇 dist 浠呯害 4.8 MB锛屽寘浣撲富瑕佹潵鑷� jar锛�56.3 MB锛変笌 WinSW锛�17.4 MB锛夈��
+- **閮ㄧ讲娉ㄦ剰**锛氭湰鍖呬笉鍚墠绔紝閮ㄧ讲鏃朵笉瑕佸垹闄ら儴缃叉満鍘熸湁 `backend\web\`锛屽惁鍒欓〉闈� 404锛涘彧瑕嗙洊 jar锛堝強鎸夐渶 application.yml锛夈��
+- **鐘舵��**锛氬凡鎵撳寘锛屽緟鐢ㄦ埛涓婁紶鍒版湇鍔″櫒銆�
+
+### 10-04 娣卞锛氭姌绾挎暟鍊兼爣绛鹃伩寮�鎶樼嚎骞惰创杩戞湰绾匡紙v31锛屽緟鐢ㄦ埛楠屾敹锛�
+
+- **鐢ㄦ埛鍙嶉锛堥瀵肩湅鍚庯紝涓よ疆锛�**锛氣憼 鍚勫勾浠芥暟瀛楃鏈嚎鏈夎繙鏈夎繎锛屽笇鏈涜创杩戝悇鑷壊绾夸笖涓嶉敊涔憋紱鈶� 浠嶆湁鏁板瓧鍘嬪湪鎶樼嚎涓婄湅涓嶆竻锛堢涓�杞彧鏄�滆创杩戔�濓紝鏍囩浼氳惤鍦ㄧ嚎涓婏級銆傜敤鎴峰缓璁細璋冪旱杞村埢搴︽媺寮�鎶樼嚎銆佹垨鍔犲乏鍙抽伩璁╄鏍囩涓嶅帇绾裤��
+- **瀹炵幇锛坄HolidayTrendChartService`锛�**锛�
+  - 鏍囩鎺掔増鏀逛负銆屽姩鎬佽鍒� + 绾挎潯鍍忕礌閬胯銆嶃�傚浘琛ㄥ厛鐢绘姌绾垮拰鏍囪锛屽啀鎶婃墍鏈夌郴鍒楅鑹插儚绱狅紙瀹瑰樊 45锛夊仛鎴愭帺鑶滐紝瀵规瘡涓�欓�夋爣绛句綅缃粺璁″叾瑕嗙洊鐨勭嚎鏉″儚绱犳暟锛宍脳700` 閲嶇綒鈥斺�旀暟瀛椾笉鍐嶅帇绾裤��
+  - 涓烘瘡鏉$郴鍒楀缓绔� Chamfer 璺濈鍦猴紙鍒拌鑹叉渶杩戝儚绱犵殑璺濈锛夈�備唬浠锋柊澧炰袱椤癸細`max(0, 鑷繁閭f潯绾跨殑璺濈-3)脳40`锛堟妸鏍囩鎷夊洖鏈嚎鏃侊紝闃叉椋樿繙锛変笌棰滆壊浜插拰椤� `max(0, 鑷繁绾胯窛 - 鍒殑绾胯窛 + 4)脳200`锛堣姹傛湰绾挎槸鏈�杩戠殑绾匡紝閬垮厤璐村埌鍒殑绯诲垪锛夈��
+  - 鏃х殑銆岀鍒殑鍚屾棩鐐逛綅鏇磋繎銆嶆儵缃氱敱 `脳5000` 闄嶅埌 `脳400`锛岄伩鍏嶅畠鍘嬪�掍翰鍜岄」锛沗ITEM_LABEL_GAP` 12鈫�10锛涘�欓�夊惈杩�/杩滅殑涓娿�佷笅銆佸乏銆佸彸鍙婂洓瑙掋��
+  - 淇濈暀鍚屾棩鏍囩涓庢暟鎹偣涓�鑷寸殑涓婁笅椤哄簭锛岄伩鍏嶆爣绛句笌鎶樼嚎涓婁笅鍙嶈浆銆�
+- **璋冨弬杩囩▼鎻愮ず**锛歷27锛堝彧鎸夌偣浣嶈窛绂绘帓搴忥級鈫� 鏍囩鍘嬬嚎锛泇28锛堝彧鍔犺鐩栧儚绱犳儵缃氾級鈫� 鏍囩绂绘湰绾裤�佽创鍒板埆鐨勮壊绾挎梺锛泇31锛堣鐩栨儵缃� + 鏈嚎璺濈 + 棰滆壊浜插拰锛夆啋 涓よ�呭吋椤俱�傞獙璇佹爣绛炬槸鍚︹�滆创閿欑嚎鈥濅笉鑳藉彧鐪� OCR 鍖呭洿妗嗗埌寮傝壊鐨勮窛绂伙細鐩搁偦鐨勫紓鑹�**鏍囩**浼氳璇垽涓哄紓鑹�**绾�**锛屽繀椤昏倝鐪兼牳瀵规暣鍥俱��
+- **楠岃瘉**锛歚mvn test -f traffic-audit-server\pom.xml` 閫氳繃銆傜湡瀹炲簱鍙鐢熸垚 `_tmp_holiday_verify/holiday_trend_2026-10-04_v31.docx`锛沇ord COM 8 椤� 15 鍥撅紙1+2脳7锛夈�俁apidOCR 澶嶆 15 寮犲浘鏁板�兼爣绛惧寘鍥存閲嶅彔鏁颁负 0銆傝倝鐪兼牳瀵瑰浘 1锛堣法鍖哄煙浜哄憳娴佸姩閲忥級銆佸浘 2锛堢疮璁★級銆佸浘 4锛堣嚜椹撅級銆佸浘 6锛堟按璺級銆佸浘 9锛堥珮閫燂級銆佸浘 11锛堣溅娴佹�婚噺锛夛細鏁板�兼爣绛惧潎绂诲紑鎶樼嚎銆佷綅浜庡悇鑷壊绾挎梺銆侀鑹插搴旀纭紱鍥� 11 鐨� 630.99/601.04/571.31 鍒嗗埆绱ц创钃�/绾�/缁挎姌绾裤��
+- **浜х墿涓庣姸鎬�**锛歚C:\Users\jcxiong\Downloads\2026骞村崄涓�鍋囨湡鍏ㄧ渷缁煎悎杩愯緭瀹㈡祦閲忚蛋鍔垮浘锛堜慨鏀圭増-鏁板�兼爣绛鹃伩寮�鎶樼嚎锛�.docx`銆傛湭瀵煎叆銆佽鐩栨垨閲嶅浠讳綍鏁版嵁銆傚緟鐢ㄦ埛楠屾敹锛岄獙鏀跺墠涓嶆彁浜ゃ�佷笉鎺ㄩ�侊紱鐜版湁 `deploy/traffic-audit-deploy-20261004.zip` 浠嶆槸 v24 琛屼负锛岄渶楠屾敹鍚庨噸寤恒��
+
 ### 10-04 鏅氾細璧板娍鍥� 3 椤瑰潗鏍囪酱璋冩暣锛坴24锛岀敤鎴峰凡楠屾敹锛�
 
 - **鐢ㄦ埛淇敼椤�**锛氣憼 鍧愭爣杞村崟浣嶏紙涓囦汉娆°�佷竾杈嗘銆佸叕閲�/灏忔椂銆佹嫢鎸ゅ害銆佹棩鏈燂級鏀规垚鍜屽埢搴︿竴鏍风殑棰滆壊锛涒憽 涓や釜鍫嗗彔鍥剧殑鍧愭爣杞存敼鎴愪笌鍏朵粬鍥句竴鏍风殑榛戣壊锛涒憿 鈥滀竾浜烘/鍗犳瘮鈥濈户缁斁鍦ㄥ爢鍙犲浘鍙充笂瑙掋��

--
Gitblit v1.9.1