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/mes_bag_code_package_refactor_integration.md | 96 ++++++++++++++++++++++++++++++++++++++++++++++++
1 files changed, 96 insertions(+), 0 deletions(-)
diff --git a/docs/mes_bag_code_package_refactor_integration.md b/docs/mes_bag_code_package_refactor_integration.md
new file mode 100644
index 0000000..a24ef59
--- /dev/null
+++ b/docs/mes_bag_code_package_refactor_integration.md
@@ -0,0 +1,96 @@
+# 涓�琚嬩竴鐮佺敓浜ч�昏緫鏀归�� - 鍓嶇鑱旇皟鏂规
+
+> 閰嶅闇�姹傛柟妗堬細`docs/mes_bag_code_package_refactor_requirements.md`銆傛湰鏂规瑕嗙洊鎺ュ彛鍙樻洿涓庨〉闈㈡暟鎹甫鍏ワ紝鍓嶇涓讳綋鏀瑰姩宸查殢鏈鏀归�犲悓姝ュ畬鎴愶紝渚涜仈璋冨洖褰掍娇鐢ㄣ��
+
+## 娑夊強椤甸潰
+
+- 璧嬬爜绠＄悊锛堣鐮侊級锛氱敓鎴愭暟鎹寘寮圭獥銆佺敓鎴愬師濮嬭鐮佸脊绐椼�佽鐮佸垪琛ㄣ�佸綍鍏ユ壒娆°�佺粦瀹氭墭鐩樸�佽拷婧脊绐�
+- 鐢熶骇鎵规锛氭柊澧�/缂栬緫/琛ュ綍琛ㄥ崟锛堟柊澧炪�岀粦瀹氭墭鐩樸�嶅閫夛級銆佸垪琛ㄣ�佹悳绱㈠尯
+- 鎵樼洏绠＄悊锛氶鐢熸垚寮圭獥銆佸垪琛ㄣ�佺粦瀹氭壒娆″脊绐�
+- 鍏叡 H5 婧簮椤点�佹壂鐮佽拷婧脊绐楋紙鍥炲綊锛�
+
+## 涓氬姟娴佺▼涓庢暟鎹甫鍏�
+
+1. 鐢熸垚鏁版嵁鍖咃細閫夊搧绉� 鈫� 鍓嶇鎸夊搧绉嶄富璁￠噺鍗曚綅绫诲瀷鑱斿姩锛堟煡 `/mdm/item/get` 鍙� `unitMeasureId`锛屽啀鏌� `/mdm/unit/get?id=` 鍙� `type`锛夛細
+ - `48鍗冨厠`/`100鍗冨厠` 鈫� 杈撳叆**鎵樼洏鏁�**锛岄瑙堛�屾瘡鎵� N 琚� 脳 鎵樼洏鏁� = 琚嬬爜鏁般��
+ - `鍚╜ 鈫� 杈撳叆**琚嬬爜鏁�**锛堟棤鎵樼洏锛�
+ - 绫诲瀷鏈厤缃� 鈫� 鎻愮ず鍓嶅線銆岃閲忓崟浣嶃�嶇淮鎶わ紝鎻愪氦鏃跺悗绔篃浼氬厹搴曟姤閿�
+2. 鐢熸垚缁撴灉锛氬悓涓� uuid 琚嬬爜缁� + 鑷姩鐢熸垚鐨勪复鏃舵墭鐩橈紙PL-搴忓彿锛夛紝琚嬬爜宸插甫鍝佺銆佸凡缁戞墭鐩樸��
+3. 褰曞叆鎵规锛氬嬀閫夎鐮� 鈫� 閫夌敓浜ф壒娆°�傚悗绔骇鑱旓細涓存椂鎵樼洏鍗囨寮忕爜锛堟壒娆″彿-P搴忓彿锛夊苟缁戞壒娆°�佸洖鍐欒鐮佸啑浣欐墭鐩樼爜銆傛贩鍝佺浼氳鎷︽埅銆�
+4. 鎵规涓嶅啀褰曞叆/灞曠ず鍝佺锛涘搧绉嶄俊鎭叏閮ㄧ敱琚嬬爜鏁版嵁鍖呮惡甯︺��
+5. 鏂板/琛ュ綍/缂栬緫鎵规鏃跺潎鍙�夈�岀粦瀹氭墭鐩樸�嶏紙澶氶�夈�侀潪蹇呭～锛屾暟鎹簮 `GET /mes/pro/pallet/unbound-list`锛屽睍绀轰复鏃舵墭鐩樼爜+宸茶琚嬫暟锛夛細鍕鹃�夊悗鎵规鐘舵�佺洿鎺ヤ负**鐢熶骇涓�**锛屽悗绔悓浜嬪姟澶嶇敤鎵樼洏缁戝畾鎵规閫昏緫锛堟墭鐩樺崌姝ｅ紡鐮併�佹墭鐩樹笅琚嬬爜绾ц仈褰曞叆锛夛紝浠讳竴鏍￠獙澶辫触鏁翠綋鍥炴粴锛涚紪杈戞椂浠呴渶鍕鹃�夋湰娆℃柊澧炵殑鎵樼洏锛堝凡缁戝畾鎵樼洏涓嶅湪涓嬫媺涓�佷笉鍙В缁戯級銆�
+
+## API
+
+| 鏂规硶 | 璺緞 | 鍙樻洿 |
+|------|------|------|
+| POST | /mes/pro/bag-code/generate | 璇锋眰/鍝嶅簲缁撴瀯鍙樻洿锛堣涓嬶級 |
+| POST | /mes/pro/bag-code/raw-generate | **鏂板**锛氱敓鎴愬師濮嬭鐮侊紝璇锋眰 `{ itemId, count, remark? }`锛涗粎鎸夋暟閲忕敓鎴愩�佷笉鎹㈢畻璁￠噺鍗曚綅绫诲瀷銆佷笉鐢熸垚鎵樼洏锛涘搷搴旂粨鏋勫悓 generate锛坄type/perPallet` 涓虹┖銆乣palletIds` 绌烘暟缁勶級 |
+| PUT | /mes/pro/bag-code/bind-batch | 璺緞涓嶅彉锛涙柊澧炲搧绉嶄竴鑷存牎楠屻�佹墭鐩樼骇鑱旂粦瀹氾紱宸插鍑哄嵃鍒凤紙PRINTED锛夎鐮佷篃鍏佽褰曞叆鎵规 |
+| PUT | /mes/pro/pallet/bind-batch | 璺緞涓嶅彉锛涙墭鐩樼粦瀹氭壒娆℃椂锛屾墭鐩樹笅鏈粦鎵规鐨勮鐮佽嚜鍔ㄧ骇鑱斿綍鍏ュ悓涓�鎵规锛堝搧绉嶄竴鑷存牎楠屻�佸洖鍐欐壒娆¤鏁帮級 |
+| DELETE | /mes/pro/bag-code/delete-by-uuid | 璺緞涓嶅彉锛涚骇鑱斿垹闄ゆ湰缁勮嚜鍔ㄧ敓鎴愭墭鐩� |
+| POST | /mes/pro/bag-code/replace | 涓嶅彉锛涙柊琚嬬爜鑷姩缁ф壙鍘熷搧绉� |
+| GET | /mes/pro/bag-code/page銆乴ist-by-uuid銆乬et-by-code | 鍝嶅簲鏂板鍝佺瀛楁锛沺age 鏂板鍙�夋煡璇㈠弬鏁� `itemId`锛堝搧绉嶏紝绛夊�煎尮閰嶏紱瀵煎嚭 Excel 鍚屽彛寰勶級 |
+| POST | /mes/pro/pallet/batch-create銆乸re-generate | 璇锋眰鍘绘帀 capacity |
+| GET | /mes/pro/pallet/page | 鍝嶅簲鍘绘帀 capacity锛屼繚鐣� autoGenerated |
+| POST/PUT | /mes/pro/batch/create銆乽pdate銆乫ill-info | 璇锋眰鍘绘帀 itemId锛涗笁鑰呭潎鏂板鍙�� `palletIds`锛堢粦瀹氭椂鎵规杩涘叆鐢熶骇涓級 |
+| GET | /mes/pro/pallet/unbound-list | **鏂板**锛氭湭缁戝畾鎵规鐨勪复鏃舵墭鐩樺垪琛紙鏉冮檺 mes:pro-pallet:query锛夛紝渚涙壒娆℃柊澧�/琛ュ綍缁戝畾鎵樼洏涓嬫媺 |
+| GET | /mes/pro/batch/page銆乬et銆乻imple-list | 鍝嶅簲鍘绘帀 itemId/itemCode/itemName/itemSpecification |
+
+**鐢熸垚鏁版嵁鍖呰姹傚弬鏁帮細**
+
+| 鍙傛暟 | 绫诲瀷 | 蹇呭～ | 璇存槑 |
+|------|------|------|------|
+| itemId | Long | 鏄� | 鍝佺缂栧彿 |
+| palletCount | Integer | 鏉′欢蹇呭～ | 鎵樼洏鏁帮紙绫诲瀷=N鍗冨厠锛� |
+| bagCount | Integer | 鏉′欢蹇呭～ | 琚嬬爜鏁帮紙绫诲瀷=鍚級 |
+| remark | String | 鍚� | 澶囨敞 |
+
+**鐢熸垚鏁版嵁鍖呭搷搴旂ず渚嬶細**
+
+```json
+{
+ "code": 0,
+ "data": {
+ "uuid": "鐢熸垚缁刄UID",
+ "type": "48鍗冨厠",
+ "perPallet": 48,
+ "totalCount": 96,
+ "palletIds": [101, 102]
+ }
+}
+```
+
+## 瀛楁灞曠ず瑙勫垯
+
+| 瀛楁 | 灞曠ず浣嶇疆 | 璇存槑 |
+|------|----------|------|
+| 鍝佺缂栫爜/鍚嶇О锛坕temCode/itemName锛� | 琚嬬爜鍒楄〃銆佽拷婧�佸鍑� Excel | 鐢熸垚鏃剁粦瀹氬湪琚嬬爜涓� |
+| autoGenerated | 鎵樼洏鍒楄〃銆岃嚜鍔ㄧ敓鎴愩�峊ag | 鏁版嵁鍖呰嚜鍔ㄥ垱寤虹殑鎵樼洏鏍囪瘑 |
+| 鍝佺锛堟壒娆￠〉锛� | 涓嶅啀灞曠ず | 琛ㄥ崟/鍒楄〃/鎼滅储鍧囧凡绉婚櫎 |
+
+## 涓氬姟瑙勫垯璇存槑
+
+| 鍦烘櫙 | 瑙勫垯 |
+|------|------|
+| 绫诲瀷=N鍗冨厠 鐢熸垚 | 琚嬬爜鏁� = N 脳 鎵樼洏鏁帮紝鑷姩寤� N 涓墭鐩樺苟鍧囧垎缁戝畾 |
+| 绫诲瀷=鍚� 鐢熸垚 | 鏃犳墭鐩橈紝琚嬬爜浠呯粦鎵规 |
+| 鐢熸垚鍘熷琚嬬爜 | 浠呴渶鍝佺+鏁伴噺锛涜鐮佸甫鍝佺銆佷笉缁戞壒娆�/鎵樼洏锛屽悗缁綍鍏ユ壒娆°�佺粦鎵樼洏銆佸鍑哄嵃鍒枫�佸垹闄ょ粍涓庢暟鎹寘琚嬬爜瀹屽叏涓�鑷达紱涓嶆牎楠屽搧绉嶈閲忓崟浣嶇被鍨� |
+| 褰曞叆鎵规娣峰搧绉� | 鎶ラ敊銆屽綍鍏ユ壒娆＄殑琚嬬爜蹇呴』灞炰簬鍚屼竴鍝佺銆嶏紙涓庢壒娆″凡鏈夎鐮佷竴骞舵牎楠岋級 |
+| 鎵樼洏缁戝畾鎵规 | 鎵樼洏涓嬫湭缁戞壒娆＄殑琚嬬爜锛堝凡鐢熸垚/宸插鍑哄嵃鍒凤級鑷姩闅忔墭鐩樺綍鍏ュ悓涓�鎵规锛岃鐮佸啑浣欐墭鐩樼爜鍚屾鏇存柊涓烘寮忕爜 |
+| 鎵规鏂板/琛ュ綍/缂栬緫缁戝畾鎵樼洏 | palletIds 闈炵┖鏃舵壒娆＄姸鎬佺洿鎺ョ疆銆岀敓浜т腑銆嶏紝鍚屼簨鍔″鐢ㄦ墭鐩樼粦瀹氭壒娆￠�昏緫锛堟寮忕爜+琚嬬爜绾ц仈+鍝佺涓�鑷存牎楠岋級锛屽け璐ユ暣浣撳洖婊氾紱鏂板/琛ュ綍鏈嬀閫夊垯缁存寔鑽夌锛涚紪杈戝彇娑堝嬀閫変笉鍥為��鐘舵�併�佸凡缁戝畾鎵樼洏涓嶅彲瑙ｇ粦 |
+| 缁戞墭鐩樺閲� | 鏃犱笂闄愶紝鑷姩鎵樼洏鍙户缁墜鍔ㄧ粦鍏� |
+| 鍒犻櫎鏁版嵁鍖� | 缁勫唴鎵樼洏宸茬粦鎵规鎴栨湁姝ｅ紡鐮佸垯涓嶅彲鍒狅紝鍚﹀垯绾ц仈鍒犺嚜鍔ㄦ墭鐩� |
+| 杩芥函鍝佺 | 浼樺厛琚嬬爜鍝佺锛涘巻鍙茶鐮佸洖閫�鎵规鍝佺锛堝叕鍏� H5 鍚屾鏀寔锛� |
+| 鎵规鍙� | PC + yyyyMMdd + 浜х嚎缂栫爜 + 娴佹按鍙凤紙涓嶅啀鍚搧绉嶇紪鐮侊級 |
+
+## 娉ㄦ剰浜嬮」
+
+- `generate` 鏃у弬鏁� `count` 宸插簾寮冿紝鍙紶 `palletCount` 鎴� `bagCount`锛堟寜鍝佺绫诲瀷浜岄�変竴锛夈��
+- 鎵规 `itemId` 鐩稿叧瀛楁宸蹭粠鎺ュ彛绉婚櫎锛屽嬁鍐嶅紩鐢紙鎵规杩芥函瑙嗗浘 `get-by-code` 鐨勫搧绉嶅瓧娈典繚鐣欙紝鍙兘涓虹┖=鏂版壒娆★級銆�
+- 鎵樼洏杩芥函瑙嗗浘锛圥alletTrace/qr-trace-modal锛変粛杩斿洖 `capacity` 渚涘巻鍙叉暟鎹睍绀猴紝鏂版墭鐩樹负绌恒��
+- 鑰佹暟鎹紙鍘嗗彶绌虹櫧琚嬬爜锛夊搧绉嶄负绌哄睘姝ｅ父锛岃拷婧蛋鎵规鍥為��銆�
+- `palletIds` 鍦� create/update/fill-info 鍧囩敓鏁堬紱涓嬫媺姣忔鎵撳紑寮圭獥閲嶆柊鎷夊彇 `unbound-list`锛岃嫢鎻愪氦鏃舵墍閫夋墭鐩樺凡琚粬浜虹粦瀹氾紝鍚庣鏁翠綋鎶ラ敊鍥炴粴锛堟湰娆℃壒娆℃搷浣滀笉鐢熸晥锛夛紝鎻愮ず鐢ㄦ埛鍒锋柊閲嶈瘯銆�
+- 琚嬬爜鍒嗛〉锛坄/page`锛夊悗绔凡鏀逛负**鍒涘缓鏃堕棿鍊掑簭**锛堝悓绉掑唴鎸夌紪鍙峰�掑簭锛夛紝鍓嶇鏃犻渶鍐嶄紶鎺掑簭鍙傛暟锛涘鍑� Excel 鍚屽彛寰勩��
+- 鍘熷琚嬬爜涓庢暟鎹寘琚嬬爜鍚岃〃鍚岃鍒欙紙uuid 鎴愮粍銆佸彲鏁寸粍鍒犻櫎锛夛紝鍒楄〃椤甸�氳繃鐢熸垚缁� UUID 鍖哄垎鏉ユ簮銆�
+- 鍒楄〃鎼滅储鍖烘柊澧炪�屽搧绉嶃�嶆潯浠讹紙澶嶇敤 `MdmItemSelect`锛屽彲娓呯┖锛夛紝浼� `itemId` 绛夊�艰繃婊わ紱瀵煎嚭 Excel 鎼哄甫鍚屼竴鏌ヨ鏉′欢鍚屽彛寰勭敓鏁堛�傚巻鍙茬┖鐧借鐮佸搧绉嶄负绌猴紝鎸夊搧绉嶇瓫閫変笉浼氬懡涓��
--
Gitblit v1.9.3