From 251be431ad12399fe4ebce599c353d05dcec7888 Mon Sep 17 00:00:00 2001
From: 云 <2163098428@qq.com>
Date: 星期四, 29 十月 2026 12:28:34 +0800
Subject: [PATCH] feat(mes): 支持追溯二维码解析功能

---
 docs/追溯二维码扫码业务操作方案.md                                                                                                       |  242 ++++++++++++++++++++++++++++++++++++++++
 yudao-module-mes/src/main/java/cn/iocoder/yudao/module/mes/framework/qrcode/MesTraceCodeUtils.java                          |   46 +++++++
 yudao-module-mes/src/main/java/cn/iocoder/yudao/module/mes/service/pro/scan/MesProScanEventServiceImpl.java                 |   15 +-
 yudao-module-system/src/main/java/cn/iocoder/yudao/module/system/controller/admin/auth/MobileMenuAdapter.java               |   24 ++-
 yudao-module-mes/src/main/java/cn/iocoder/yudao/module/mes/controller/admin/pro/trace/MesProTraceResolveController.java     |    8 
 yudao-module-system/src/test/java/cn/iocoder/yudao/module/system/controller/admin/auth/MobileMenuAdapterTest.java           |   10 +
 yudao-module-mes/src/main/java/cn/iocoder/yudao/module/mes/service/wm/productsales/MesWmProductSalesServiceImpl.java        |    5 
 yudao-module-mes/src/main/java/cn/iocoder/yudao/module/mes/service/wm/stocktaking/task/MesWmStockTakingTaskServiceImpl.java |    7 
 8 files changed, 335 insertions(+), 22 deletions(-)

diff --git "a/docs/\350\277\275\346\272\257\344\272\214\347\273\264\347\240\201\346\211\253\347\240\201\344\270\232\345\212\241\346\223\215\344\275\234\346\226\271\346\241\210.md" "b/docs/\350\277\275\346\272\257\344\272\214\347\273\264\347\240\201\346\211\253\347\240\201\344\270\232\345\212\241\346\223\215\344\275\234\346\226\271\346\241\210.md"
new file mode 100644
index 0000000..fa7da04
--- /dev/null
+++ "b/docs/\350\277\275\346\272\257\344\272\214\347\273\264\347\240\201\346\211\253\347\240\201\344\270\232\345\212\241\346\223\215\344\275\234\346\226\271\346\241\210.md"
@@ -0,0 +1,242 @@
+# 杩芥函浜岀淮鐮佹壂鐮佷笟鍔℃搷浣滄柟妗�
+
+鐗堟湰锛歏1锛堝緟纭锛�
+鏃ユ湡锛�2026-10-29
+鐘舵�侊細闇�姹傛柟妗堬紝鏈紑濮嬬紪鐮�
+
+## 1. 鑳屾櫙涓庣洰鏍�
+
+鐜板満鏍囩涓婂嵃鐨勬槸**杩芥函浜岀淮鐮�**锛岀爜鍐呭涓嶆槸绾爜鍊硷紝鑰屾槸涓�鏉¤拷婧綉鍧�锛�
+
+```
+{mes.trace-base-url}?code={杩芥函鐮亇
+```
+
+渚嬪 `http://1.95.78.124:9008/prod/trace.html?code=0286267849370923`銆�
+
+闇�姹傦細**娴忚鍣ㄧЩ鍔ㄧ锛�/mobile锛夊拰 PC 绔紙绠$悊鍚庡彴锛夐兘鑳芥壂鎻忚拷婧簩缁寸爜锛岀洿鎺ュ甫鍑轰笟鍔℃槑缁嗗苟鎵ц鍏ュ簱銆佸嚭搴撱�佺Щ搴撱�佺洏鐐广�侀��璐х瓑涓氬姟鎿嶄綔**锛屽噺灏戞墜宸ュ綍鍏ョ墿鏂欍�佹壒娆″拰鏁伴噺銆�
+
+鏈湡鍙璁�"杩芥函浜岀淮鐮� / 杩芥函鐮�"杩欐潯涓昏矾寰勩�備笟鍔$爜銆佷复鏃剁爜淇濇寔鍏煎锛屼笉浣滀负涓昏鍏ュ彛銆�
+
+## 2. 鐮佸唴瀹逛笌瑙f瀽瑙勫垯
+
+| 鏉ユ簮 | 鍐呭褰㈠紡 | 瑙f瀽鏂瑰紡 |
+|------|----------|----------|
+| 杩芥函浜岀淮鐮侊紙琚嬬爜 / 鎵樼洏鐮� / 鎵规鐮侊級 | `http(s)://...?code=xxxx` | 鍙� `code` 鏌ヨ鍙傛暟 |
+| 绾拷婧爜 | 16 浣嶆暟瀛� | 鍘熸牱浣跨敤 |
+| 涓氬姟鐮� | 16 浣嶆暟瀛� | 鍘熸牱浣跨敤锛堝吋瀹癸級 |
+| 涓存椂鐮侊紙鎵樼洏 / 鎵规锛� | 涓存椂缂栫爜 | 鍘熸牱浣跨敤锛堝吋瀹癸級 |
+
+缁熶竴瑙勫垯锛堝墠鍚庣鍚勫疄鐜颁竴浠斤紝鍙e緞蹇呴』涓�鑷达級锛�
+
+1. 鍘婚櫎棣栧熬绌虹櫧锛�
+2. 浠� `http://` 鎴� `https://` 寮�澶存椂锛岃В鏋� URL 骞跺彇 `code` 鍙傛暟锛涘彇涓嶅埌鍒欐姤"璇ラ摼鎺ヤ笉鍖呭惈杩芥函鐮�"锛�
+3. 鍏朵綑鎯呭喌鎸夊師鍊煎鐞嗭紱
+4. 鐮佸�奸暱搴︿笉瓒呰繃 64銆佷笉鍚┖鐧藉瓧绗︼紝鍚﹀垯鎶�"鐮佸�兼牸寮忎笉姝g‘"锛�
+5. 鍓嶇宸叉彁鍙栬繃鐨勭爜鍊间紶鍒板悗绔椂锛屽悗绔啀鍋氫竴娆″悓鏍风殑鎻愬彇锛岄伩鍏嶆壂鐮佹灙鐩存帴鎶婃暣娈� URL 鎻愪氦杩涙帴鍙c��
+
+绉诲姩绔凡鏈夌瓑浠峰疄鐜帮紙`src/mobile/access.ts` 鐨� `extractCode`锛夛紝闇�瑕佹彁鍗囦负鍓嶅悗绔叡鐢ㄧ殑鍏叡閫昏緫锛孭C 绔幇鏈夋壂鐮佹娌℃湁杩欎竴姝ワ紝蹇呴』琛ラ綈銆�
+
+## 3. 鐜扮姸鏍告煡
+
+| 绔� | 鐜版湁鑳藉姏 | 缂哄彛 |
+|----|----------|------|
+| 绉诲姩绔� | 鎽勫儚澶存壂鐮� + 鎵嬪姩杈撳叆锛坄mobile/scanner.vue`锛実etUserMedia + jsQR锛夛紱宸茶兘浠庤拷婧綉鍧�鎻愬彇 code锛涘凡瑕嗙洊鎵爜鍏ュ簱銆佽鐮�/鎵樼洏/鎵规鏌ヨ缁戝畾銆佺瀛愯川妫�銆侀攢鍞嚭搴撴嫞璐� | 鏈鐩栫洏鐐广�佺Щ搴撱�侀��璐х瓑涓氬姟锛涘悇椤甸潰鍚勮嚜缁存姢鎵爜閫昏緫 |
+| PC 绔� | 閿�鍞嚭搴撴嫞璐с�佺洏鐐规墽琛屾湁杈撳叆妗嗭紙鍙帴鎵爜鏋級 | 鏃犳憚鍍忓ご鎵爜锛涜緭鍏ユ鐩存帴浣跨敤鍘熷鏂囨湰锛屾壂杩芥函浜岀淮鐮佷細澶辫触锛涘叾浣� 10 涓粨鍌ㄥ崟鎹棤鎵爜甯﹀嚭鍏ュ彛 |
+| 鍚庣 | `/mes/pro/trace/resolve-type` 瑙f瀽鐮佺被鍨嬶紱琚�/鎵樼洏/鎵规 `get-by-code`锛涢攢鍞嚭搴� `scan`銆乣scan-preview`锛涚洏鐐� `scan`锛涙壂鐮佸叆搴� `inbound` | 鍚勬帴鍙i兘鎸夌函鐮佸�兼煡璇紝涓嶅鐞� URL锛涙病鏈夎鐩栧叾浠栧崟鎹殑鎵爜棰勮 |
+
+## 4. 闇�姹傝寖鍥�
+
+瑕嗙洊 8 绫绘湁鐢熶骇杩芥函鐮佺殑浠撳偍涓氬姟鍗曟嵁锛屼袱绔榻愶紱渚涘簲鍟嗘潵鏂欑被鍗曟嵁涓嶆帴鍏ワ細
+
+| 涓氬姟 | PC 椤甸潰 | 绉诲姩绔� | 鎵爜甯﹀嚭鍐呭 |
+|------|---------|--------|--------------|
+| 浜у搧鍏ュ簱 | `wls/productreceipt` | 寰呰ˉ | 鐗╂枡銆佹壒娆°�佹暟閲� |
+| 閿�鍞嚭搴� | `wls/productsales` | 宸叉湁锛岃ˉ榻� URL 瑙f瀽 | 鎷h揣鏄庣粏锛堣鐮佸彲鍒拌锛� |
+| 鐢熶骇棰嗘枡 | `wls/productissue` | 寰呰ˉ | 鐗╂枡銆佹壒娆°�佹暟閲� |
+| 鍏朵粬鍑哄簱 | `wls/miscissue` | 寰呰ˉ | 鐗╂枡銆佹壒娆°�佹暟閲� |
+| 绉诲簱 / 璋冩嫧 | `wls/transfer` | 寰呰ˉ | 鐗╂枡銆佹壒娆°�佹暟閲忋�佺洰鏍囧簱浣� |
+| 鐩樼偣浠诲姟 | `wls/stocktaking/task` | 寰呰ˉ | 鐩樼偣瀵硅薄銆佽处闈㈡暟閲忋�佸綍鍏ョ洏鐐规暟閲� |
+| 閿�鍞��璐� | `wls/returnsales` | 寰呰ˉ | 鐗╂枡銆佹壒娆°�佹暟閲� |
+| 鐢熶骇閫�鏂� | `wls/returnissue` | 寰呰ˉ | 鐗╂枡銆佹壒娆°�佹暟閲� |
+
+涓嶆帴鍏ワ紙渚涘簲鍟嗘潵鏂欙紝鎵规鐢卞悗绔寜鐗╂枡 + 鐢熶骇鏃ユ湡 + 鎵瑰彿鑷姩鐢熸垚锛屾壂鐮佸緱鍒扮殑鐢熶骇杩芥函鐮佷笌鏉ユ枡涓嶅尮閰嶏級锛氶噰璐叆搴撱�佸澶栧叆搴撱�佸叾浠栧叆搴撱�侀噰璐��璐с��
+
+璐ㄦ锛堢瀛愯川妫�銆佽川妫�璁板綍锛変笉鍦ㄦ湰鏂规鍐咃紝绉诲姩绔凡鍗曠嫭瀹炵幇銆�
+
+## 5. 缁熶竴浜や簰娴佺▼
+
+姣忎釜鍗曟嵁鐨勬槑缁嗗尯涓婃柟澧炲姞"鎵爜甯﹀嚭"鍖哄煙锛屾祦绋嬪浐瀹氫负鍥涙锛�
+
+1. **閫夋嫨鐮佺被鍨�**锛氳嚜鍔ㄨ瘑鍒紙榛樿锛�/ 琚嬬爜 / 鎵樼洏鐮� / 鎵规鐮併�傝嚜鍔ㄨ瘑鍒皟鐢� `resolve-type`銆�
+2. **鎵爜鎴栬緭鍏�**锛氭憚鍍忓ご鎵爜銆佹壂鐮佹灙鍥炶溅銆佹墜鍔ㄨ緭鍏ヤ笁绉嶆柟寮忕瓑浠凤紱璇嗗埆鍚庡厛鎻愬彇鐮佸�硷紝鍐嶈В鏋愬璞°��
+3. **鏍稿纭**锛氬睍绀烘牳瀵瑰崱鐗団�斺�旂爜鍊笺�佺爜绫诲瀷銆佸搧绉嶃�佹壒娆°�佸彲鎿嶄綔鏁伴噺銆佽鏄庣粏锛堟墭鐩� / 鎵规鎵爜鏃堕�愯鍕鹃�夛級銆佺洰鏍囦粨搴撳簱浣嶏紙闇�瑕佹搷浣滃憳閫夋嫨鐨勫瓧娈碉級銆�
+4. **纭鍚庡啓鍏�**锛氱偣鍑�"纭鍔犲叆鏄庣粏"鎵嶈皟鐢ㄥ師鍗曟嵁鐨勬柊澧炴槑缁� / 鎵爜鎺ュ彛锛涗换浣曞啓鎿嶄綔閮藉繀椤荤粡杩囪繖涓�姝ワ紝璇嗗埆鏈韩涓嶅叆璐︺��
+
+宸插瓨鍦ㄤ笖鍙鐢ㄧ殑浜や簰鍩哄噯锛歅C 閿�鍞嚭搴撴嫞璐э紙棰勮 鈫� 鍕鹃�夎 鈫� 纭鍔犲叆鎷h揣锛夈�佺Щ鍔ㄧ鎵爜鍏ュ簱锛堣瘑鍒� 鈫� 鏍稿 鈫� 纭鍏ュ簱锛夈��
+
+## 6. 鏄庣粏绮掑害瑙勫垯锛堝繀椤诲厛纭锛�
+
+杩欐槸鏈柟妗堝奖鍝嶆渶澶х殑绾︽潫锛�
+
+- **閿�鍞嚭搴撴槑缁�**鏈� `bag_code_id` / `pallet_code_id`锛屽彲浠ョ簿纭埌琚嬶紱
+- **鍏朵綑鍗曟嵁鏄庣粏鍙湁 `batch_id` / `batch_code`**锛屾病鏈夎瀛楁銆�
+
+鍥犳锛�
+
+| 鎵爜瀵硅薄 | 閿�鍞嚭搴� | 鍏朵粬鍗曟嵁 |
+|----------|----------|----------|
+| 琚嬬爜 | 绮剧‘鍒拌琚嬶紝鏁伴噺 1 | 鎸�"鐗╂枡 + 鎵规"甯﹀嚭锛屾暟閲� 1锛�**涓嶈褰曞叿浣撹** |
+| 鎵樼洏鐮� | 鏁存墭锛岄�愯鍕鹃�� | 鎸夋墭鐩樻墍灞炴壒娆″甫鍑烘暣鎵樿鏁� |
+| 鎵规鐮� | 鏁存壒锛岄�愯鍕鹃�� | 鎸夋壒娆″甫鍑烘暣鎵硅鏁� |
+
+濡傛灉涓氬姟瑕佹眰"姣忎竴琚嬮兘鑳借拷婧埌杩涘叆鍝紶鍏ュ簱鍗� / 绉诲簱鍗�"锛岄渶瑕佺粰鐩稿叧鏄庣粏琛ㄥ鍔犺瀛楁骞舵敼閫犲簱瀛樹簨鍔★紝灞炰簬鐙珛鐨勫ぇ鏀瑰姩锛屽缓璁崟鐙珛椤广��
+
+## 7. 鎺ュ彛璁捐
+
+### 7.1 澶嶇敤锛堜笉鏂板锛�
+
+| 鏂规硶 | 璺緞 | 鐢ㄩ�� |
+|------|------|------|
+| GET | `/mes/pro/trace/resolve-type` | 鐮佸�� 鈫� bag / pallet / batch |
+| GET | `/mes/pro/bag-code/get-by-code` | 琚嬬爜璇︽儏 |
+| GET | `/mes/pro/pallet/get-by-code` | 鎵樼洏璇︽儏 |
+| GET | `/mes/pro/batch/get-by-code` | 鎵规璇︽儏 |
+| POST | `/mes/wm/product-sales/scan-preview` | 閿�鍞嚭搴撴嫞璐ч瑙� |
+| POST | `/mes/wm/product-sales/scan` | 閿�鍞嚭搴撳姞鍏ユ嫞璐� |
+| POST | `/mes/wm/stocktaking-task/scan` | 鐩樼偣鎵爜璁℃暟 |
+
+### 7.2 鏀归��
+
+1. 涓婅堪鎵�鏈夋帴鍙e湪鎺ユ敹鐮佸�煎弬鏁版椂锛岀粺涓�鍋�"URL 鎻愬彇 code"锛屽吋瀹硅拷婧簩缁寸爜鐩翠紶銆�
+2. `resolve-type` 澧炲姞鍙�夌殑 `bizType` 鍙傛暟锛岃繑鍥炶鐮佸湪褰撳墠涓氬姟涓嬫槸鍚﹀彲鐢紙鍙�夛紝闈炲繀椤伙級銆�
+
+### 7.3 鏂板缁熶竴棰勮鎺ュ彛
+
+鍚勫崟鎹殑鍙敤鎬ф牎楠屼笉鍚岋紙搴撳瓨鏄惁鍏呰冻銆佹壒娆℃槸鍚︿綔搴熴�佹槸鍚﹀悎鏍笺�佹槸鍚﹀凡鍏ュ簱锛夛紝鍓嶇鏃犳硶鑷鍒ゆ柇銆傚缓璁柊澧烇細
+
+```
+POST /mes/wm/trace/scan-preview
+```
+
+璇锋眰锛�
+
+| 鍙傛暟 | 绫诲瀷 | 蹇呭~ | 璇存槑 |
+|------|------|------|------|
+| rawCode | String | 鏄� | 鎵弿鍘熸枃锛屽彲涓鸿拷婧綉鍧�鎴栫函鐮� |
+| bizType | String | 鏄� | 涓氬姟绫诲瀷锛欼TEM_RECEIPT / PRODUCT_RECEIPT / PRODUCT_SALES / TRANSFER / STOCK_TAKING / RETURN_VENDOR 绛� |
+| bizId | Long | 鍚� | 鍗曟嵁 ID锛岀敤浜庢牎楠屾壒娆℃槸鍚﹀湪鍗曟嵁鑼冨洿鍐� |
+
+鍝嶅簲锛�
+
+| 瀛楁 | 绫诲瀷 | 璇存槑 |
+|------|------|------|
+| codeType | String | bag / pallet / batch |
+| code | String | 瑙勮寖鍖栧悗鐨勭爜鍊� |
+| itemId / itemName | Long / String | 鍝佺 |
+| batchId / batchCode | Long / String | 鎵规 |
+| unitName | String | 璁¢噺鍗曚綅 |
+| availableQuantity | BigDecimal | 褰撳墠涓氬姟涓嬪彲鎿嶄綔鏁伴噺 |
+| bags | Array | 鎵樼洏 / 鎵规鍦烘櫙鐨勯�愯鏄庣粏锛堣鐮併�佸簱瀛樿褰� ID銆佸簱浣嶏級 |
+| blockReason | String | 涓嶅彲鎿嶄綔鍘熷洜锛屼负绌鸿〃绀哄彲鎿嶄綔 |
+
+棰勮鍙锛屼笉鍐欎换浣曟暟鎹�傜‘璁ら樁娈电殑鍐欐搷浣滀粛璋冪敤鍚勫崟鎹師鏈夋帴鍙o紝淇濊瘉搴撳瓨鏍¢獙鍜屾祦姘撮�昏緫涓嶅彉銆�
+
+## 8. PC 绔壂鐮佺粍浠惰姹�
+
+鏂板 PC 閫氱敤鎵爜杈撳叆缁勪欢锛屼緵鍚勫崟鎹鐢細
+
+- 杈撳叆妗� + "鎵撳紑鎽勫儚澶�"鎸夐挳 + "璇嗗埆"鎸夐挳锛涙壂鐮佹灙浣滀负閿洏杈撳叆锛屽洖杞﹀嵆璇嗗埆锛�
+- 鎽勫儚澶村鐢� jsQR锛堥」鐩凡渚濊禆锛夛紝鎴愬姛鍚庤嚜鍔ㄥ仠姝㈢浉鏈猴紝绂婚〉鎴栧垏鍚庡彴涔熷仠姝紱
+- 璇嗗埆缁撴灉鍏堣蛋缁熶竴鐮佸�兼彁鍙栵紝鍐嶆妸瑙勮寖鍖栫爜鍊间氦缁欎笟鍔¢�昏緫锛�
+- 鏍峰紡鑷寘鍚紝涓嶄緷璧� `mobile.css` 鍜岀Щ鍔ㄧ鍥炬爣锛�
+- 杩炵画鎵爜寮�鍏筹細寮�鍚椂璇嗗埆鎴愬姛鍚庡彲缁х画鎵笅涓�琚嬶紝鍏抽棴鏃惰瘑鍒竴娆″嵆鍋滐紱
+- 鐩告満涓嶅彲鐢ㄣ�佹潈闄愭嫆缁濄�侀潪 HTTPS 鏃剁粰鍑轰笌绉诲姩绔竴鑷寸殑涓枃鎻愮ず锛屽苟淇濈暀鎵嬪姩杈撳叆銆�
+
+## 9. 绉诲姩绔ˉ榻�
+
+1. `scanner.vue` 鐨勫彇鐮侀�昏緫鎻愬崌涓哄叕鍏辨ā鍧楋紝PC / 绉诲姩鍏辩敤鍚屼竴浠� `extractCode`銆�
+2. 鏂板绉诲姩椤甸潰锛氱洏鐐逛换鍔°�佺Щ搴撱�侀噰璐��璐с�侀攢鍞��璐с�佺敓浜ч��鏂欙紙鎸� PC 鍚屼竴浜や簰瀹炵幇锛屽彧鍋氱幇鍦洪珮棰戝瓧娈碉級銆�
+3. 鑿滃崟涓庤矾鐢辨部鐢ㄧЩ鍔ㄧ鐜版湁鐨勬潈闄愭槧灏勬満鍒讹紝涓嶆柊澧炴暟鎹簱鑿滃崟銆�
+
+## 10. 鏉冮檺
+
+娌跨敤鐜版湁鏉冮檺锛屼笉鏂板鏉冮檺鐮侊細
+
+- 鐮佹煡璇細`mes:pro-bag-code:query`銆乣mes:pro-pallet:query`銆乣mes:pro-batch:query`锛堣瘑鍒爜鍊煎繀闇�锛夛紱
+- 涓氬姟鎿嶄綔锛氭部鐢ㄥ悇鍗曟嵁鐨� `create` / `update` / `stock` / `scan` 鏉冮檺锛堝 `mes:wm-product-sales:stock`銆乣mes:wm-stock-taking-task:update`锛夛紱
+- 鎵爜甯﹀嚭灞炰簬杈呭姪褰曞叆锛屾渶缁堝啓鎿嶄綔浠嶆寜鍘熶笟鍔℃潈闄愭牎楠屻��
+
+## 11. 宸茬‘璁ゅ喅绛栵紙2026-10-29锛�
+
+| 闂 | 鍐崇瓥 |
+|------|------|
+| 琚嬬骇杩借釜 | 涓嶆墿灞曘�傞櫎閿�鍞嚭搴撳锛屽叾浣欏崟鎹竴寰嬫寜"鐗╂枡 + 鎵规"甯﹀嚭锛屼笉璁板綍鍏蜂綋琚� |
+| 瀹炴柦鑼冨洿 | PC 绔笌绉诲姩绔竴璧峰仛锛岃鐩栫 4 鑺� 8 绫讳笟鍔★紱鏉ユ枡绫诲崟鎹笉鎺ュ叆 |
+| 鍐欏叆鏂瑰紡 | 鎵爜鏍稿纭鍚�**鏂板涓�琛屾槑缁�**锛屼笉瑕嗙洊姝e湪缂栬緫鐨勮 |
+| 鐮佽В鏋愬煙鍚� | 鍙彁鍙� `code` 鍙傛暟锛屼笉鏍¢獙杩芥函缃戝潃鍩熷悕锛屽吋瀹规棫鏍囩鐨� HTTP 鍦板潃 |
+| 鑼冨洿鏍¢獙 | 鍏佽鏂板鏄庣粏锛屼笉瑕佹眰鎵爜瀵硅薄宸插湪鍗曟嵁宸叉湁琛屼腑 |
+
+## 12. 瀹炴柦鎷嗗垎
+
+| 灞� | 鍐呭 |
+|----|------|
+| 鍚庣鍩虹 | 缁熶竴鐮佸�兼彁鍙栧伐鍏凤紱`resolve-type` 涓庡悇鎵爜鎺ュ彛鍏煎 URL 鍏ュ弬锛涙柊澧� `POST /mes/wm/trace/scan-preview` 缁熶竴棰勮 |
+| PC 鍓嶇鍩虹 | 鍏叡 `extractCode`锛涢�氱敤鎵爜缁勪欢锛堟憚鍍忓ご + 鎵爜鏋� + 鎵嬪姩杈撳叆锛� |
+| PC 鍗曟嵁鎺ュ叆 | 绗� 4 鑺� 12 绫诲崟鎹帴鍏ユ壂鐮佸甫鍑猴紝纭鍚庢柊澧炴槑缁嗚 |
+| 绉诲姩绔熀纭� | 澶嶇敤鍏叡 `extractCode` 涓庢壂鐮佺粍浠� |
+| 绉诲姩绔帴鍏� | 琛ラ綈鐩樼偣銆佺Щ搴撱�侀噰璐��璐с�侀攢鍞��璐с�佺敓浜ч��鏂欓〉闈紱鐜版湁椤甸潰鎺ュ叆鍏叡瑙f瀽 |
+
+## 13. 鐜板満寰呴獙璇�
+
+1. **杩芥函缃戝潃澶氱幆澧�**锛氱幇鍦烘棫鏍囩鍙兘鏄� HTTP 鍦板潃鎴栦笉鍚屽煙鍚嶏紝瑙f瀽鍙彇 `code` 鍙傛暟銆�
+2. **鎵爜鏋粨鏉熺**锛氶渶鐜板満纭璁惧鏄惁鍦ㄧ爜鍊煎悗杩藉姞鍥炶溅 / 鎹㈣锛岀粍浠舵寜 `\r`銆乣\n` 浣滀负缁撴潫绗﹀鐞嗐��
+
+## 13. 楠岃瘉鏂瑰紡
+
+- 鍚庣锛歚mvn compile -pl yudao-module-mes -am -q`锛涗负鐮佸�兼彁鍙栥�侀瑙堝彲鐢ㄦ�с�佸悇鍗曟嵁鎵爜琛ュ厖鍗曞厓娴嬭瘯銆�
+- PC 绔細娴忚鍣ㄦ憚鍍忓ご瀹炴祴鎵拷婧簩缁寸爜銆佹壂鐮佹灙杈撳叆銆佹墜鍔ㄨ緭鍏ヤ笁绉嶆柟寮忥紱鏍稿纭鍚庢槑缁嗘纭�佸簱瀛樻祦姘存纭��
+- 绉诲姩绔細娌跨敤 `node scripts/mobile-ui-smoke.cjs` 鍥炲綊锛屽苟琛ュ厖鏂伴〉闈㈢敤渚嬨��
+- 鐜板満锛氱敤瀹為檯鏍囩锛堣拷婧簩缁寸爜锛夊湪鐩爣鎵嬫満銆丳DA銆丳C 涓婂悇鎵竴閬嶏紝纭鐩告満鏉冮檺銆佺爜鍊兼彁鍙栥�佺粨鏉熺銆�
+
+## 14. 瀹炴柦杩涘害锛�2026-10-29锛�
+
+### 鍚庣
+
+| 鍐呭 | 鐘舵�� | 璇存槑 |
+|------|------|------|
+| 缁熶竴鐮佸�兼彁鍙� | 宸插畬鎴� | `MesTraceCodeUtils.extractCode`锛屾帴鍏� `resolve-type`銆佹壂鐮佸叆搴撱�侀攢鍞嚭搴撴嫞璐с�佺洏鐐规壂鐮� |
+| 鍚勬壂鐮佹帴鍙e吋瀹� URL 鍏ュ弬 | 宸插畬鎴� | 璇嗗埆杩芥函缃戝潃涓殑 `code` 鍙傛暟 |
+
+### PC 绔�
+
+| 涓氬姟 | 鐘舵�� | 璇存槑 |
+|------|------|------|
+| 鐢熶骇棰嗘枡 | 宸插畬鎴� | 鎵爜甯﹀嚭鐗╂枡涓庢暟閲忥紝鏂板棰嗘枡琛� |
+| 鍏朵粬鍑哄簱 | 宸插畬鎴� | 鍖归厤搴撳瓨璁板綍锛屽甫鍑哄簱浣�/鎵规/鏁伴噺 |
+| 搴撳瓨绉诲簱 | 宸插畬鎴� | 鍖归厤搴撳瓨璁板綍锛屽甫鍑虹Щ鍑哄簱浣�/鎵规/鏁伴噺 |
+| 鐢熶骇閫�鏂� | 宸插畬鎴� | 鍖归厤绾胯竟搴擄紙virtualFilter=only锛夊簱瀛� |
+| 閿�鍞��璐� | 宸插畬鎴� | 鍏宠仈鍑哄簱鍗曟椂鍖归厤鍙��琛岋紝鍚﹀垯鎸� WM 鎵规鍖归厤 |
+| 閿�鍞嚭搴撴嫞璐� | 宸插畬鎴� | 鑷姩璇嗗埆琚�/鎵樼洏/鎵规 |
+| 鐩樼偣浠诲姟 | 宸插畬鎴� | 鎵爜鏋�/鎽勫儚澶磋緭鍏� + 鏁伴噺锛屾彁浜ょ洏鐐圭粨鏋� |
+
+### 绉诲姩绔�
+
+| 椤甸潰 | 鐘舵�� | 璇存槑 |
+|------|------|------|
+| `productissue` 鐢熶骇棰嗘枡 | 宸插畬鎴� | 鑽夌鍗� 鈫� 鎵爜 鈫� 鏂板棰嗘枡琛� |
+| `miscissue` 鍏朵粬鍑哄簱 | 宸插畬鎴� | 鑽夌鍗� 鈫� 鎵爜鍖归厤搴撳瓨 鈫� 鏂板鍑哄簱琛� |
+| `transfer` 搴撳瓨绉诲簱 | 宸插畬鎴� | 鑽夌鍗� 鈫� 鎵爜鍖归厤搴撳瓨 鈫� 鏂板绉诲簱琛� |
+| `stocktaking` 鐩樼偣浠诲姟 | 宸插畬鎴� | 鐩樼偣涓换鍔★紙status=2锛夆啋 鎵爜 + 鏁伴噺 鈫� 鎻愪氦鐩樼偣 |
+| `returnsales` 閿�鍞��璐� | 宸插畬鎴� | 鑽夌鍗� 鈫� 鍏宠仈鍑哄簱鍗曞尮閰嶅彲閫�琛岋紝鍚﹀垯鎸� WM 鎵规 |
+| `returnissue` 鐢熶骇閫�鏂� | 宸插畬鎴� | 鑽夌鍗� 鈫� 鍖归厤绾胯竟搴撳簱瀛� 鈫� 鏂板閫�鏂欒 |
+
+绉诲姩绔彍鍗曢�氳繃鍚庣 `MobileMenuAdapter` 浠� PC 鑿滃崟鏄犲皠鐢熸垚锛屽凡鍦� `PAGES` 澧炲姞 6 鏉℃槧灏勫苟鍚屾鍗曟祴锛涘墠绔� `routes.ts`銆乣access.ts` 澧炲姞瀵瑰簲璺敱涓庡姛鑳藉叆鍙o紝鏈柊澧炴暟鎹簱鑿滃崟銆�
+
+閲囪喘鍏ュ簱銆佸澶栧叆搴撱�佸叾浠栧叆搴撱�侀噰璐��璐ф寜绗� 11 鑺傚喅绛�**涓嶆帴鍏�**鎵爜銆�
+
+### 瀹炵幇瑕佺偣
+
+- 杩芥函瀵硅薄 `itemId` 涓庡簱瀛�/鎵规鍚屼负 `mdm_item` ID 浣撶郴锛涗絾 WM 鎵规 ID 涓庣敓浜ф壒娆� ID 涓嶅悓锛屽啓鏄庣粏鏃舵壒娆� ID 涓�寰嬪彇搴撳瓨璁板綍鐨� `batchId`锛屽簱瀛樻煡璇㈡寜 `batchCode` 瀛楃涓插尮閰嶃��
+- 鏄庣粏鏂板瑕佹眰鐖跺崟涓鸿崏绋匡紱鐩樼偣鎵爜瑕佹眰浠诲姟鐘舵�佷负瀹℃壒涓紙`APPROVING=2`锛夈��
+- 鎵爜瀵硅薄鎵�灞炴壒娆�/鑷韩宸蹭綔搴熸椂锛屽墠鍚庣缁熶竴鎷︽埅锛屼笉鍏佽鍐欐搷浣溿��
diff --git a/yudao-module-mes/src/main/java/cn/iocoder/yudao/module/mes/controller/admin/pro/trace/MesProTraceResolveController.java b/yudao-module-mes/src/main/java/cn/iocoder/yudao/module/mes/controller/admin/pro/trace/MesProTraceResolveController.java
index 66730e6..9060081 100644
--- a/yudao-module-mes/src/main/java/cn/iocoder/yudao/module/mes/controller/admin/pro/trace/MesProTraceResolveController.java
+++ b/yudao-module-mes/src/main/java/cn/iocoder/yudao/module/mes/controller/admin/pro/trace/MesProTraceResolveController.java
@@ -1,6 +1,7 @@
 package cn.iocoder.yudao.module.mes.controller.admin.pro.trace;
 
 import cn.iocoder.yudao.framework.common.pojo.CommonResult;
+import cn.iocoder.yudao.module.mes.framework.qrcode.MesTraceCodeUtils;
 import cn.iocoder.yudao.module.mes.service.pro.bagcode.MesProBagCodeService;
 import cn.iocoder.yudao.module.mes.service.pro.batch.MesProBatchService;
 import cn.iocoder.yudao.module.mes.service.pro.pallet.MesProPalletService;
@@ -38,13 +39,14 @@
     @Parameter(name = "code", description = "缂栫爜锛堜簩缁寸爜鍐呭锛�", required = true)
     @PreAuthorize("@ss.hasAnyPermissions('mes:pro-bag-code:query', 'mes:pro-pallet:query', 'mes:pro-batch:query')")
     public CommonResult<String> resolveType(@RequestParam("code") String code) {
-        if (bagCodeService.getBagCodeByScanCode(code) != null) {
+        String scanCode = MesTraceCodeUtils.extractCode(code);
+        if (bagCodeService.getBagCodeByScanCode(scanCode) != null) {
             return success("bag");
         }
-        if (palletService.getPalletByScanCode(code) != null) {
+        if (palletService.getPalletByScanCode(scanCode) != null) {
             return success("pallet");
         }
-        if (batchService.getBatchByScanCode(code) != null) {
+        if (batchService.getBatchByScanCode(scanCode) != null) {
             return success("batch");
         }
         return success(null);
diff --git a/yudao-module-mes/src/main/java/cn/iocoder/yudao/module/mes/framework/qrcode/MesTraceCodeUtils.java b/yudao-module-mes/src/main/java/cn/iocoder/yudao/module/mes/framework/qrcode/MesTraceCodeUtils.java
new file mode 100644
index 0000000..ee71963
--- /dev/null
+++ b/yudao-module-mes/src/main/java/cn/iocoder/yudao/module/mes/framework/qrcode/MesTraceCodeUtils.java
@@ -0,0 +1,46 @@
+package cn.iocoder.yudao.module.mes.framework.qrcode;
+
+import cn.hutool.core.util.StrUtil;
+import org.springframework.web.util.UriComponentsBuilder;
+
+/**
+ * 杩芥函鐮佹彁鍙栧伐鍏枫��
+ *
+ * <p>鐜板満鏍囩鍗扮殑鏄拷婧簩缁寸爜锛屽唴瀹逛负 {@code {杩芥函缃戝潃}?code={杩芥函鐮亇}锛�
+ * 鎵爜鏋篃鍙兘鎶婃暣娈电綉鍧�鐩存帴鎻愪氦銆傛墍鏈夋帴鏀剁爜鍊肩殑鎺ュ彛閮藉簲鍏堢粡杩囨湰绫昏鑼冨寲锛�
+ * 閬垮厤鎶婄綉鍧�褰撲綔鐮佸�兼煡璇€�傚墠绔� {@code src/utils/traceCode.ts} 淇濇寔鍚屼竴鍙e緞銆�
+ */
+public final class MesTraceCodeUtils {
+
+    private static final int MAX_CODE_LENGTH = 64;
+
+    private MesTraceCodeUtils() {
+    }
+
+    /**
+     * 浠庢壂鎻忓師鏂囦腑鎻愬彇杩芥函鐮侊細缃戝潃鍙� {@code code} 鍙傛暟锛屽叾浣欏師鏍蜂娇鐢ㄣ��
+     */
+    public static String extractCode(String raw) {
+        String value = StrUtil.trim(raw);
+        if (StrUtil.isEmpty(value)) {
+            throw new IllegalArgumentException("璇锋壂鎻忔垨杈撳叆杩芥函鐮�");
+        }
+        if (value.regionMatches(true, 0, "http://", 0, 7) || value.regionMatches(true, 0, "https://", 0, 8)) {
+            String code;
+            try {
+                code = UriComponentsBuilder.fromUriString(value).build().getQueryParams().getFirst("code");
+            } catch (Exception ex) {
+                throw new IllegalArgumentException("杩芥函缃戝潃鏍煎紡涓嶆纭�");
+            }
+            if (StrUtil.isBlank(code)) {
+                throw new IllegalArgumentException("璇ヨ拷婧綉鍧�涓嶅寘鍚拷婧爜");
+            }
+            value = code.trim();
+        }
+        if (value.length() > MAX_CODE_LENGTH || value.chars().anyMatch(Character::isWhitespace)) {
+            throw new IllegalArgumentException("杩芥函鐮佹牸寮忎笉姝g‘");
+        }
+        return value;
+    }
+
+}
diff --git a/yudao-module-mes/src/main/java/cn/iocoder/yudao/module/mes/service/pro/scan/MesProScanEventServiceImpl.java b/yudao-module-mes/src/main/java/cn/iocoder/yudao/module/mes/service/pro/scan/MesProScanEventServiceImpl.java
index f9412cc..56a5a4e 100644
--- a/yudao-module-mes/src/main/java/cn/iocoder/yudao/module/mes/service/pro/scan/MesProScanEventServiceImpl.java
+++ b/yudao-module-mes/src/main/java/cn/iocoder/yudao/module/mes/service/pro/scan/MesProScanEventServiceImpl.java
@@ -17,6 +17,7 @@
 import cn.iocoder.yudao.module.mes.enums.MesProScanEventStatusEnum;
 import cn.iocoder.yudao.module.mes.enums.wm.MesWmStockStateEnum;
 import cn.iocoder.yudao.module.mes.enums.wm.MesWmTransactionTypeEnum;
+import cn.iocoder.yudao.module.mes.framework.qrcode.MesTraceCodeUtils;
 import cn.iocoder.yudao.module.mes.service.wm.batch.MesWmBatchService;
 import cn.iocoder.yudao.module.mes.service.wm.transaction.MesWmTransactionService;
 import cn.iocoder.yudao.module.mes.service.wm.transaction.dto.MesWmTransactionSaveReqDTO;
@@ -61,13 +62,15 @@
     @Override
     @Transactional(rollbackFor = Exception.class)
     public MesProScanEventDO createInbound(MesProScanEventCreateReqVO req) {
+        // 杩芥函浜岀淮鐮佸唴瀹规槸銆岃拷婧綉鍧�?code=鐮佸�笺�嶏紝鎵爜鏋篃鍙兘鐩翠紶鏁存缃戝潃锛屽厛缁熶竴鎻愬彇鐮佸��
+        String scanCode = MesTraceCodeUtils.extractCode(req.getBagCode());
         String scanType = (req.getScanType() == null || req.getScanType().isBlank()) ? SCAN_TYPE_BAG : req.getScanType();
         if (!List.of(SCAN_TYPE_BAG, SCAN_TYPE_PALLET, SCAN_TYPE_BATCH).contains(scanType)) {
             throw new ServiceException(400, "涓嶆敮鎸佺殑鎵爜绫诲瀷");
         }
         MesProScanEventDO existing = eventMapper.selectByEventIdForUpdate(req.getEventId());
         if (existing != null) {
-            boolean contentMatch = req.getBagCode().equals(existing.getBagCode())
+            boolean contentMatch = scanCode.equals(existing.getBagCode())
                     && Objects.equals(req.getDeviceCode(), existing.getDeviceCode())
                     && Objects.equals(req.getLineCode(), existing.getLineCode())
                     && Objects.equals(scanType, existing.getScanType())
@@ -82,7 +85,7 @@
             return existing;
         }
         MesProScanEventDO event = new MesProScanEventDO();
-        event.setEventId(req.getEventId()).setBagCode(req.getBagCode()).setScanType(scanType)
+        event.setEventId(req.getEventId()).setBagCode(scanCode).setScanType(scanType)
                 .setQuantity(req.getQuantity()).setDeviceCode(req.getDeviceCode()).setLineCode(req.getLineCode())
                 .setRemark(req.getRemark()).setLocationId(req.getLocationId()).setAreaId(req.getAreaId())
                 .setStatus(MesProScanEventStatusEnum.FAILED).setReceivedTime(LocalDateTime.now());
@@ -96,7 +99,7 @@
         Long bagCodeId = null;
         String bagCode = null;
         if (SCAN_TYPE_PALLET.equals(scanType)) {
-            MesProPalletDO pallet = palletMapper.selectByScanCodeForUpdate(req.getBagCode());
+            MesProPalletDO pallet = palletMapper.selectByScanCodeForUpdate(scanCode);
             if (pallet == null) return failed(event, "MES_SCAN_PALLET_NOT_EXISTS", "鎵樼洏鐮佷笉瀛樺湪");
             if (MesProPalletStatusEnum.CANCELED.getStatus().equals(pallet.getStatus()))
                 return failed(event, "MES_SCAN_PALLET_CANCELED", "鎵樼洏宸蹭綔搴燂紝涓嶅彲鍏ュ簱");
@@ -107,13 +110,13 @@
             targetId = pallet.getId();
             quantity = BigDecimal.valueOf(bagCodeMapper.selectPendingInboundCountByPalletId(pallet.getId()));
         } else if (SCAN_TYPE_BATCH.equals(scanType)) {
-            batch = batchMapper.selectByScanCodeForUpdate(req.getBagCode());
+            batch = batchMapper.selectByScanCodeForUpdate(scanCode);
             if (batch == null) return failed(event, "MES_SCAN_BATCH_NOT_EXISTS", "鐢熶骇鎵规涓嶅瓨鍦�");
             batchId = batch.getId();
             targetId = batch.getId();
             quantity = BigDecimal.valueOf(bagCodeMapper.selectPendingInboundCountByBatchId(batch.getId()));
         } else {
-            MesProBagCodeDO bag = bagCodeMapper.selectByScanCodeForUpdate(req.getBagCode());
+            MesProBagCodeDO bag = bagCodeMapper.selectByScanCodeForUpdate(scanCode);
             if (bag == null) return failed(event, "MES_SCAN_BAG_NOT_EXISTS", "琚嬬爜涓嶅瓨鍦�");
             if (MesProBagCodeStatusEnum.CANCELED.getStatus().equals(bag.getStatus()))
                 return failed(event, "MES_SCAN_BAG_CANCELED", "琚嬬爜宸蹭綔搴燂紝涓嶅彲鍏ュ簱");
@@ -167,7 +170,7 @@
             return event;
         } catch (Exception ex) {
             log.error("[createInbound] 搴撳瓨浜嬪姟澶勭悊澶辫触锛宔ventId={}, bagCode={}, batchId={}, itemId={}",
-                    req.getEventId(), req.getBagCode(), batchId, batch.getItemId(), ex);
+                    req.getEventId(), scanCode, batchId, batch.getItemId(), ex);
             throw ex;
         }
     }
diff --git a/yudao-module-mes/src/main/java/cn/iocoder/yudao/module/mes/service/wm/productsales/MesWmProductSalesServiceImpl.java b/yudao-module-mes/src/main/java/cn/iocoder/yudao/module/mes/service/wm/productsales/MesWmProductSalesServiceImpl.java
index 9ea5427..1b67a0c 100644
--- a/yudao-module-mes/src/main/java/cn/iocoder/yudao/module/mes/service/wm/productsales/MesWmProductSalesServiceImpl.java
+++ b/yudao-module-mes/src/main/java/cn/iocoder/yudao/module/mes/service/wm/productsales/MesWmProductSalesServiceImpl.java
@@ -32,6 +32,7 @@
 import cn.iocoder.yudao.module.mes.enums.wm.MesWmSalesNoticeStatusEnum;
 import cn.iocoder.yudao.module.mes.enums.wm.MesWmStockReserveBizTypeEnum;
 import cn.iocoder.yudao.module.mes.enums.wm.MesWmTransactionTypeEnum;
+import cn.iocoder.yudao.module.mes.framework.qrcode.MesTraceCodeUtils;
 import cn.iocoder.yudao.module.crm.api.customer.CrmCustomerApi;
 import cn.iocoder.yudao.module.crm.api.customer.dto.CrmCustomerRespDTO;
 import cn.iocoder.yudao.module.mes.service.wm.materialstock.MesWmMaterialStockService;
@@ -254,7 +255,7 @@
     /** 鍙璇嗗埆锛屽苟杩斿洖姣忚鐨勫彲閫夌姸鎬侊紝涓嶅垱寤哄簱瀛樻壒娆℃垨鎷h揣璁板綍銆� */
     @Override
     public MesWmProductSalesScanRespVO previewScan(String code, String scanType, Long salesId) {
-        PickingScope scope = pickingScope(code, scanType, false);
+        PickingScope scope = pickingScope(MesTraceCodeUtils.extractCode(code), scanType, false);
         if (salesId != null) {
             MesWmProductSalesDO sales = validateProductSalesExists(salesId);
             if (!Integer.valueOf(2).equals(sales.getStatus())) throw exception(WM_PRODUCT_SALES_CANNOT_PICK);
@@ -284,7 +285,7 @@
         MesWmProductSalesDO sales = productSalesMapper.selectByIdForUpdate(reqVO.getSalesId());
         if (sales == null) throw exception(WM_PRODUCT_SALES_NOT_EXISTS);
         if (!Integer.valueOf(2).equals(sales.getStatus())) throw exception(WM_PRODUCT_SALES_CANNOT_PICK);
-        PickingScope scope = pickingScope(reqVO.getScanContent(), reqVO.getScanType(), true);
+        PickingScope scope = pickingScope(MesTraceCodeUtils.extractCode(reqVO.getScanContent()), reqVO.getScanType(), true);
         List<Long> ids = reqVO.getBagIds();
         if (ids == null && "BAG".equals(scope.type())) ids = List.of(scope.id());
         if (ids == null || ids.isEmpty() || new HashSet<>(ids).size() != ids.size())
diff --git a/yudao-module-mes/src/main/java/cn/iocoder/yudao/module/mes/service/wm/stocktaking/task/MesWmStockTakingTaskServiceImpl.java b/yudao-module-mes/src/main/java/cn/iocoder/yudao/module/mes/service/wm/stocktaking/task/MesWmStockTakingTaskServiceImpl.java
index d1883c0..a0baeac 100644
--- a/yudao-module-mes/src/main/java/cn/iocoder/yudao/module/mes/service/wm/stocktaking/task/MesWmStockTakingTaskServiceImpl.java
+++ b/yudao-module-mes/src/main/java/cn/iocoder/yudao/module/mes/service/wm/stocktaking/task/MesWmStockTakingTaskServiceImpl.java
@@ -23,6 +23,7 @@
 import cn.iocoder.yudao.module.mes.enums.MesBizTypeConstants;
 import cn.iocoder.yudao.module.mes.enums.wm.MesWmStockTakingTaskStatusEnum;
 import cn.iocoder.yudao.module.mes.enums.wm.MesWmTransactionTypeEnum;
+import cn.iocoder.yudao.module.mes.framework.qrcode.MesTraceCodeUtils;
 import cn.iocoder.yudao.module.mes.service.pro.batch.MesProBatchService;
 import cn.iocoder.yudao.module.mes.service.wm.batch.MesWmBatchService;
 import cn.iocoder.yudao.module.mes.service.wm.materialstock.MesWmMaterialStockService;
@@ -285,10 +286,12 @@
     /**
      * 瑙f瀽杩芥函鐮佸畾浣嶄粨搴撴壒娆★細渚濇鍖归厤鎵规鍙枫�佽鐮併�佹墭鐩樼爜锛岀敓浜ф壒娆$粡妗ユ帴杩斿洖浠撳簱鎵规
      */
-    private MesWmBatchDO resolveWmBatchByScanCode(String scanCode) {
-        if (StrUtil.isBlank(scanCode)) {
+    private MesWmBatchDO resolveWmBatchByScanCode(String rawCode) {
+        if (StrUtil.isBlank(rawCode)) {
             return null;
         }
+        // 杩芥函浜岀淮鐮佸唴瀹逛负銆岃拷婧綉鍧�?code=鐮佸�笺�嶏紝鍏堢粺涓�鎻愬彇鐮佸�煎啀鍖归厤
+        String scanCode = MesTraceCodeUtils.extractCode(rawCode);
         // 1. 鐩存帴鍛戒腑浠撳簱鎵规鍙�
         MesWmBatchDO wmBatch = mesWmBatchService.getBatchByCode(scanCode);
         if (wmBatch != null) {
diff --git a/yudao-module-system/src/main/java/cn/iocoder/yudao/module/system/controller/admin/auth/MobileMenuAdapter.java b/yudao-module-system/src/main/java/cn/iocoder/yudao/module/system/controller/admin/auth/MobileMenuAdapter.java
index 68c6185..09a4b09 100644
--- a/yudao-module-system/src/main/java/cn/iocoder/yudao/module/system/controller/admin/auth/MobileMenuAdapter.java
+++ b/yudao-module-system/src/main/java/cn/iocoder/yudao/module/system/controller/admin/auth/MobileMenuAdapter.java
@@ -8,15 +8,21 @@
 /** Maps already-authorized, visible menus to implemented mobile pages. Does not grant permissions. */
 public final class MobileMenuAdapter {
     private MobileMenuAdapter() { }
-    private static final Map<String, String> PAGES = Map.of(
-            "mes/pro/scan-in/index", "inbound",
-            "mes/pro/bagCode/index", "bags",
-            "mes/pro/pallet/index", "pallets",
-            "mes/pro/batch/index", "batches",
-            "wls/materialstock/index", "stock",
-            "mes/qc/seedQuality/index", "quality",
-            "mes/qc/seedQuality/record", "quality-records",
-            "wls/productsales/index", "sales");
+    private static final Map<String, String> PAGES = Map.ofEntries(
+            Map.entry("mes/pro/scan-in/index", "inbound"),
+            Map.entry("mes/pro/bagCode/index", "bags"),
+            Map.entry("mes/pro/pallet/index", "pallets"),
+            Map.entry("mes/pro/batch/index", "batches"),
+            Map.entry("wls/materialstock/index", "stock"),
+            Map.entry("mes/qc/seedQuality/index", "quality"),
+            Map.entry("mes/qc/seedQuality/record", "quality-records"),
+            Map.entry("wls/productsales/index", "sales"),
+            Map.entry("wls/productissue/index", "productissue"),
+            Map.entry("wls/miscissue/index", "miscissue"),
+            Map.entry("wls/transfer/index", "transfer"),
+            Map.entry("wls/stocktaking/task/index", "stocktaking"),
+            Map.entry("wls/returnsales/index", "returnsales"),
+            Map.entry("wls/returnissue/index", "returnissue"));
 
     public static List<MenuVO> adapt(List<MenuVO> menus) {
         List<MenuVO> result = new ArrayList<>();
diff --git a/yudao-module-system/src/test/java/cn/iocoder/yudao/module/system/controller/admin/auth/MobileMenuAdapterTest.java b/yudao-module-system/src/test/java/cn/iocoder/yudao/module/system/controller/admin/auth/MobileMenuAdapterTest.java
index 95040ec..e91d431 100644
--- a/yudao-module-system/src/test/java/cn/iocoder/yudao/module/system/controller/admin/auth/MobileMenuAdapterTest.java
+++ b/yudao-module-system/src/test/java/cn/iocoder/yudao/module/system/controller/admin/auth/MobileMenuAdapterTest.java
@@ -23,6 +23,16 @@
     assertEquals(3,root.getChildren().size());
     assertTrue(MobileMenuAdapter.adapt(null).isEmpty());
   }
+  @Test void mapsWarehouseOperationMenusToMobilePages() {
+    var root=menu(1L,null,true);
+    root.setChildren(List.of(
+        menu(2L,"wls/productissue/index",true),menu(3L,"wls/miscissue/index",true),
+        menu(4L,"wls/transfer/index",true),menu(5L,"wls/stocktaking/task/index",true),
+        menu(6L,"wls/returnsales/index",true),menu(7L,"wls/returnissue/index",true)));
+    assertEquals(List.of("/mobile/productissue","/mobile/miscissue","/mobile/transfer",
+        "/mobile/stocktaking","/mobile/returnsales","/mobile/returnissue"),
+        MobileMenuAdapter.adapt(List.of(root)).stream().map(MenuVO::getPath).toList());
+  }
   private MenuVO menu(Long id,String component,boolean visible) {
     return MenuVO.builder().id(id).name("menu").component(component).visible(visible).build();
   }

--
Gitblit v1.9.3