From 8b71049bcca61723d586c7c8bceb791c82af7601 Mon Sep 17 00:00:00 2001
From: xyc <jc_xiong@hotmail.com>
Date: 星期一, 05 十月 2026 08:31:22 +0800
Subject: [PATCH] feat(version): add fixed-jar release version management

---
 HANDOFF.md |   24 ++++++++++++++++++------
 1 files changed, 18 insertions(+), 6 deletions(-)

diff --git a/HANDOFF.md b/HANDOFF.md
index a8b4f6d..f785602 100644
--- a/HANDOFF.md
+++ b/HANDOFF.md
@@ -4,7 +4,18 @@
 > **姣忓ぉ缁撴潫鏃�**锛氭妸褰撳ぉ杩涘睍銆佽俯杩囩殑鍧戙�佹柊闇�姹傘�佹湭瀹屾垚浜嬮」鏇存柊鍒版湰鏂囦欢锛岀劧鍚庡彲浠ユ斁蹇冨紑鏂板璇濄��
 > **鍗忎綔绾﹀畾锛�2026-08-31锛�**锛氳銆屾彁浜ゃ��= 鏈湴 commit + 鎺ㄩ�佸埌杩滅 git锛坥rigin main锛孏itblit锛夛紝涓嶅啀鍙仛鏈湴 commit銆�
 
-## 鏈�鏂帮紙2026-10-04锛�
+## 鏈�鏂帮紙2026-10-05锛�
+
+### 10-05锛氱増鏈鐞嗛噰鐢ㄦ柟妗� A锛堝浐瀹� jar 鍚嶏紝宸插畬鎴愬苟閫氳繃娴嬭瘯锛�
+
+- **鐢ㄦ埛鍐崇瓥**锛氶噰鐢ㄦ柟妗� A銆俙traffic-audit-server/pom.xml` 涓哄敮涓�鐗堟湰婧愶紝褰撳墠瀵瑰鐗堟湰 `1.0.0`銆�
+- **鏋勫缓鏀归��**锛歚<finalName>traffic-audit-server</finalName>`锛屼骇鐗╁浐瀹氫负 `target/traffic-audit-server.jar`锛汳aven 璧勬簮杩囨护鐢熸垚 `app-version.properties`锛圫pring Boot 鐖� POM 浣跨敤 `@project.version@` 鍒嗛殧绗︼級锛宍maven-jar-plugin` 鍐欏叆 `Implementation-Version`銆�
+- **椤甸潰鏄剧ず**锛氭柊澧炲厤鐧诲綍 `GET /api/version`锛涚櫥褰曢〉鍜岄〉澶存樉绀� `V1.0.0`銆傚悓鏃朵慨澶嶅彲鎵ц jar 涓� `buildTime` 涓� `null` 鐨勫祵濂� URI 瑙ｆ瀽闂銆�
+- **鍙戝竷閾捐矾**锛氭湇鍔� XML銆佸惎鍔ㄨ剼鏈�佹墦鍖呰剼鏈叏閮ㄦ敼鐢ㄥ浐瀹� jar 鍚嶏紱`pack-deploy.ps1` 浼氭牎楠� pom / `app-version.properties` / `MANIFEST.MF` 涓夎�呯増鏈竴鑷达紝鍙戝竷鍖呭悕涓� `traffic-audit-deploy-YYYYMMDD-v1.0.0(.zip)`锛屽苟杈撳嚭甯� `{version}` 鐨勯儴缃� README銆�
+- **鏃ф湇鍔″櫒棣栨鍗囩骇锛堜粎涓�娆★級**锛氬仠姝㈡湇鍔″悗锛屾妸 `trafficAudit.xml` 鐨� `<arguments>` 鏀逛负 `-Dfile.encoding=UTF-8 -jar "%BASE%\traffic-audit-server.jar"`锛屾浛鎹� jar 鍚庡惎鍔ㄣ�備互鍚庡彂鐗堝彧鏇挎崲 jar 骞堕噸鍚紝涓嶅啀鏀� XML銆�
+- **楠岃瘉**锛歚mvn -o test`銆乣mvn -o clean package -DskipTests`銆佸浐瀹氬悕 jar 瀹為檯鍚姩骞惰闂� `/api/version`銆佸墠绔� `npm run build`銆佹湰鍦版祻瑙堝櫒鐧诲綍椤垫樉绀� `V1.0.0`銆乣pack-deploy.ps1 -SkipFrontend -NoFrontendDist -SkipServiceWrapper` 缁勮/鍘诲瘑/鐗堟湰鑷鍏ㄩ儴閫氳繃锛涜礋鍚戦獙璇佺‘璁ょ増鏈笉鍖归厤鍜� `SNAPSHOT` 閮戒細鍦ㄦ墦鍖呭墠涓銆傛祴璇曟姤鍛婏細鏈湴 `docs/鍔熻兘娴嬭瘯鎶ュ憡/鍔熻兘娴嬭瘯鎶ュ憡_鐗堟湰绠＄悊鏂规A_2026-10-05.md`锛堢洰褰曚笉鍏ュ簱锛夈��
+- **鐘舵��**锛氫唬鐮佷笌鏂囨。宸叉敼瀹岋紝鍑嗗鎻愪氦骞舵墦 `v1.0.0` 鏍囩锛涘皻鏈噸鏂扮敓鎴愭寮忓彂甯冨寘銆�
+
 ### 10-04 娣卞锛氭姌绾挎暟鍊兼爣绛惧洖鍒拌创杩戞湰鐐癸紙v35锛屽緟鐢ㄦ埛楠屾敹锛�
 
 - **鐢ㄦ埛鍙嶉**锛歷31銆岄伩寮�鎶樼嚎銆嶇増鏈笉濡備笂涓�鐗� v27 鈥斺�� 铏界劧鏍囩涓嶅帇绾夸簡锛屼絾寰堝鏍囩绂昏嚜宸辩殑鏁版嵁鐐瑰お杩滐紝涓�鐪肩湅涓嶅嚭鏍囩殑鏄摢涓偣銆傝姹傚洖鍒拌创杩戞湰鐐圭殑鏁堟灉銆�
@@ -17,13 +28,14 @@
 - **鍏朵綑楠岃瘉**锛歚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 楠屾敹閫氳繃 + 鍗曠鍙ｇ槮鍖呭彂甯冿紙 -NoFrontend 锛�
+### 10-05锛氳蛋鍔垮浘 v35 楠屾敹閫氳繃 + 鍗曠鍙ｅ彂甯冨寘锛�-NoFrontendDist -SkipServiceWrapper锛�
 
 - **楠屾敹**锛歷35锛堟姌绾挎暟鍊兼爣绛惧洖鍒拌创杩戞湰鐐� + 鐧芥弿杈癸級2026-10-05 鐢ㄦ埛楠屾敹閫氳繃銆�
-- **鎵撳寘闇�姹�**锛氭湇鍔″櫒鍗曠鍙ｉ儴缃诧紝鍓嶇鏈鏈彉鍔紝瑕佹眰鍙戝竷鍖呬笉鍚墠绔互缂╁皬浣撶Н銆�
-- **鎵撳寘宸ュ叿**锛歚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 浠ｇ爜锛夈�備綋绉鏄庯細鍓嶇 dist 浠呯害 4.8 MB锛屽寘浣撲富瑕佹潵鑷� jar锛�56.3 MB锛変笌 WinSW锛�17.4 MB锛夈��
-- **閮ㄧ讲娉ㄦ剰**锛氭湰鍖呬笉鍚墠绔紝閮ㄧ讲鏃朵笉瑕佸垹闄ら儴缃叉満鍘熸湁 `backend\web\`锛屽惁鍒欓〉闈� 404锛涘彧瑕嗙洊 jar锛堝強鎸夐渶 application.yml锛夈��
+- **鎵撳寘闇�姹傦紙鐢ㄦ埛婢勬竻锛�**锛氭湇鍔″櫒鍗曠鍙ｏ紝鍙渶瑕� `backend\web`锛屼笉瑕佺嫭绔嬬殑 `frontend/dist`锛涗负淇濊瘉鍖呭畬鏁达紝`backend\web` + jar + docs 閮借銆傛湇鍔″櫒闈為娆″彂甯冦�佹湇鍔″凡瑁咃紝鍙姞 `-SkipServiceWrapper` 鍘绘帀鏈嶅姟娉ㄥ唽鍣ㄣ��
+- **鎵撳寘宸ュ叿淇**锛氬厛鍓嶅姞鐨� `-NoFrontend` 璇箟閿欎簡锛堟妸 `backend\web` 涔熷幓鎺変簡锛夛紝鐜版敼涓� `-NoFrontendDist`銆傚畠鍙烦杩囩嫭绔� `frontend\` 鐩綍锛堜笉澶嶅埗 dist / nginx 绀轰緥锛夛紝**浠嶆瀯寤猴紙鎴栬姹傦級dist 骞跺悓姝� `backend\web`**锛堝崟绔彛蹇呴渶锛屽惁鍒欓〉闈� 404锛夈�俙-SkipFrontend` 浠嶄负鈥滀笉閲嶅缓銆佸鐢ㄧ幇鏈� dist鈥濄��
+- **鍙戝竷鍖�**锛歚deploy/traffic-audit-deploy-20261005-2/`锛�351 鏂囦欢 / 94.55 MB锛泎ip **77.78 MB**锛夈�傚凡鏍稿锛氭棤 `frontend/`銆佹棤 `trafficAudit.exe/.xml/install-service*`锛堟湇鍔″寘瑁呭櫒宸叉帓闄わ級锛沗backend\web` 44 鏂囦欢涓� `frontend\dist` 閫愭枃浠跺搱甯屼竴鑷达紱jar 鍐呯疆閰嶇疆鍏ㄥ崰浣嶇锛堝幓瀵嗚嚜妫�閫氳繃锛夛紱鍖呭唴 `HolidayTrendChartService.class` 涓� `target/classes` 涓�鑷达紙鍚� v35 浠ｇ爜锛夈�傝緝涓婁竴瀹屾暣鍖咃紙110.49 MB / zip 83.77 MB锛夌渷绾� 16 MB 瑙ｅ帇 / 6 MB 鍘嬬缉銆�
+- **浣滃簾**锛歚deploy/traffic-audit-deploy-20261005/`锛堥敊璇涔変笅鐨勪骇鐗╋紝缂� `backend\web`锛夊凡琚� `-2` 鍙栦唬锛屽嬁鐢ㄣ��
+- **閮ㄧ讲娉ㄦ剰**锛氳鐩� jar锛堝強鎸夐渶 `application.yml`锛夊嵆鍙紱`backend\web` 宸查殢鍖呮彁渚涖�傛湇鍔″凡瑁咃紝鏃犻渶閲嶆柊娉ㄥ唽銆�
 - **鐘舵��**锛氬凡鎵撳寘锛屽緟鐢ㄦ埛涓婁紶鍒版湇鍔″櫒銆�
 
 ### 10-04 娣卞锛氭姌绾挎暟鍊兼爣绛鹃伩寮�鎶樼嚎骞惰创杩戞湰绾匡紙v31锛屽緟鐢ㄦ埛楠屾敹锛�

--
Gitblit v1.9.1