From 4ca4444ad33a2a1a51f5c06e78ee9365dfb1eed6 Mon Sep 17 00:00:00 2001
From: liu <2021943741@qq.com>
Date: 星期四, 08 十月 2026 17:11:11 +0800
Subject: [PATCH] feat(mes): 种子二维码标签国标四要素合规改造
---
docs/seed_flow_trace_integration.md | 53 +++++++++++++++++++++++++++++++++++++++++++++++++++++
1 files changed, 53 insertions(+), 0 deletions(-)
diff --git a/docs/seed_flow_trace_integration.md b/docs/seed_flow_trace_integration.md
new file mode 100644
index 0000000..ff9ecd5
--- /dev/null
+++ b/docs/seed_flow_trace_integration.md
@@ -0,0 +1,53 @@
+# 绉嶅瓙娴佸悜淇℃伅锛堥攢鍞嚭搴撳嚭鍏ュ簱娴佹按锛� - H5 婧簮鑱旇皟璇存槑
+
+## 鑳屾櫙
+
+H5 鎵爜婧簮椤碉紙`mes.trace-base-url` 鎸囧悜鐨� `trace.html`锛夋柊澧炪�岀瀛愭祦鍚戜俊鎭�嶅尯鍧楋細
+鎸�**鎵规鍏ㄦ祦姘�**灞曠ず璇ユ壒娆＄殑鍏ュ簱涓庡嚭搴撹褰曪紙鏁版嵁婧愪负閿�鍞嚭搴� `/sales-outbound/product-sales` 妯″潡瀵瑰簲鐨勫簱瀛樹簨鍔★級銆�
+
+鍚屾椂淇鏃㈡湁銆岄攢鍞幓鍚戙�嶆暟鎹摼璺細绉嶅瓙閿�鍞嚭搴撴寜琚嬬爜/鎵樼洏鎵爜鎷ｈ揣鏃讹紝鎵规鍙峰彧鍐欏叆鍑哄簱**鏄庣粏琛�**
+锛坄mes_wm_product_sales_detail.batch_code`锛夛紝鍘熸煡璇㈠彧鍖归厤鍑哄簱**琛岃〃**鎵规鍙凤紝瀵艰嚧婧簮姘歌繙鏌ヤ笉鍒伴攢鍞嚭搴撲俊鎭��
+
+## 娑夊強鎺ュ彛
+
+| 鏂规硶 | 璺緞 | 璇存槑 |
+|------|------|------|
+| GET | /public/mes/trace/query?code={杩芥函鐮亇 | H5 婧簮鏌ヨ锛堝厤鐧诲綍锛夛紝鍝嶅簲鏂板 `seedFlows` 鍖哄潡 |
+
+**鍝嶅簲鏂板瀛楁 `seedFlows`锛堟壒娆″嚭鍏ュ簱娴佹按锛屾寜浜嬪姟鏃堕棿鍗囧簭锛夛細**
+
+| 瀛楁 | 绫诲瀷 | 璇存槑 |
+|------|------|------|
+| type | Integer | 浜嬪姟鏂瑰悜锛�1-鍏ュ簱 2-鍑哄簱 |
+| bizType | Integer | 涓氬姟绫诲瀷锛�118-鐢熶骇鍏ュ簱銆�119-閿�鍞嚭搴撱��124-浜у搧浜у嚭銆�120-閿�鍞��璐у叆搴撶瓑锛岃 MesBizTypeConstants锛� |
+| bizCode | String | 鏉ユ簮涓氬姟鍗曞彿锛堝閿�鍞嚭搴撳崟鍙� SL_xxx锛� |
+| quantity | BigDecimal | 鍙樺姩鏁伴噺锛堝嚭搴撲负璐熸暟锛屽睍绀烘椂鍙栫粷瀵瑰�硷級 |
+| transactionTime | LocalDateTime | 浜嬪姟鍙戠敓鏃堕棿 |
+| warehouseName | String | 浠撳簱鍚嶇О |
+| locationName | String | 搴撳尯鍚嶇О |
+| areaName | String | 搴撲綅鍚嶇О |
+| clientName | String | 瀹㈡埛鍚嶇О锛堜粎閿�鍞嚭搴撴祦姘村甫鍑猴紝鏉ヨ嚜鍑哄簱鍗曞揩鐓э級 |
+
+**`salesTargets` 瀛楁鍙樺寲锛堝悓鎺ュ彛锛屽悜鍚庡吋瀹癸級锛�**
+
+- 鏌ヨ鍙ｅ緞鎵╁睍锛氭壒娆″彿闄ゅ尮閰嶅嚭搴撹澶栵紝鍚屾椂鎸夊嚭搴撴槑缁嗚仛鍚堝尮閰嶏紙鎺掗櫎宸插彇娑堝崟鎹級銆�
+- 鏂板濉厖 `clientName`锛堝鎴峰悕绉板揩鐓э級銆乣clientCode` 涓嶅彉锛涙鍓嶆亽涓� null銆�
+
+## H5 椤甸潰灞曠ず瑙勫垯
+
+| 鍖哄潡 | 灞曠ず鏉′欢 | 鍒� |
+|------|----------|----|
+| 绉嶅瓙娴佸悜淇℃伅 | `seedFlows` 闈炵┖锛堜紭鍏堬級 | 鏂瑰悜锛堝叆搴�/鍑哄簱寰芥爣锛夈�佷笟鍔°�佹潵婧愬崟鍙枫�佸鎴枫�佹暟閲忋�佹椂闂淬�佷粨搴�/搴撳尯 |
+| 绉嶅瓙娴佸悜淇℃伅锛堝洖閫�锛� | `seedFlows` 涓虹┖浣� `salesTargets` 闈炵┖ | 閿�鍞嚭搴撳崟銆佸鎴枫�佹暟閲忋�佹棩鏈� |
+
+## 閮ㄧ讲娉ㄦ剰浜嬮」
+
+1. `trace.html` 涓� `yudao-server` 闈欐�佽祫婧愶紙`src/main/resources/static/trace.html`锛夛紝闇�**閲嶆柊鎵撳寘鍙戝竷鍚庣**锛�
+ 鑻ョ敓浜� nginx 鐨� `/prod/trace.html`锛堝 `http://47.97.181.254:9008/prod/trace.html`锛夋槸鐙珛鎷疯礉閮ㄧ讲鐨勶紝闇�鍚屾鏇挎崲璇ユ枃浠躲��
+2. 閿�鍞嚭搴撴祦姘寸殑瀹㈡埛鍚嶇О鍙� `mes_wm_product_sales.client_name` 蹇収瀛楁锛岃姹傜幆澧冨簱鍖呭惈璇ュ垪锛�
+ 缁忔帓鏌� `mom-thzy` 搴撳凡鏈夛紝**`mom-xgdl` 搴撶己澶� `client_name` / `outbound_time` / `outbound_user_id` 鍒�**锛堣惤鍚庝簬浠ｇ爜锛夛紝浣跨敤 local 鐜鏃堕渶鍏堣ˉ鍒椼��
+3. 鍘嗗彶鍑哄簱鍗曚笉浼氳ˉ鐢熸垚娴佹按锛屼粎鏂板嚭搴撳彲鐪嬪埌瀹屾暣鍏�+鍑鸿褰曪紱鏃犳祦姘存椂鍥為��灞曠ず閿�鍞嚭搴撳崟銆�
+
+## 楠岃瘉鏁版嵁锛坢om-thzy锛�
+
+鎵规 `PC20260819twoITEM_001`锛氬叆搴� 100锛堜骇鍝佷骇鍑猴紝铏氭嫙绾胯竟浠撳簱锛夆啋 鍑哄簱 1锛堥攢鍞嚭搴� SL_20260901002锛屾垚鍝佸悎鏍煎簱锛屽崡閫氬鎴凤級銆�
--
Gitblit v1.9.3