From 3aa3f9e730127147236c9e7627920dd8aacf3a36 Mon Sep 17 00:00:00 2001
From: 云 <2163098428@qq.com>
Date: 星期三, 15 七月 2026 15:49:59 +0800
Subject: [PATCH] 1.仓储物流-批次号优化覆盖数据 2.仓储物流-新增自定义出入库流水查询 3.采购管理-清理无用代码和表 4.销售管理-清理无用代码和表 5.销售流程状态字段数据回游
---
docs/item_type_integration.md | 145 +++++++++++++++++++++++++----------------------
1 files changed, 77 insertions(+), 68 deletions(-)
diff --git a/docs/item_type_integration.md b/docs/item_type_integration.md
index 2132109..5c83110 100644
--- a/docs/item_type_integration.md
+++ b/docs/item_type_integration.md
@@ -1,111 +1,120 @@
-# 鐗╂枡鍒嗙被缁熶竴浣跨敤 mes_md_item_type - 鍓嶇鑱旇皟鏂规
+# 鐗╂枡鍒嗙被缁熶竴浣跨敤 mdm_item_category - 鍓嶇鑱旇皟鏂规
+
+## 鍙樻洿璇存槑
+
+鐗╂枡鍒嗙被宸蹭粠 MES 妯″潡杩佺Щ鍒� MDM 妯″潡缁熶竴绠＄悊锛�
+- 鍘� MES 鍒嗙被琛� `mes_md_item_type` 淇濈暀浣嗕笉鍐嶇淮鎶�
+- 缁熶竴浣跨敤 MDM 鍒嗙被琛� `mdm_item_category`
+- MES 妯″潡閫氳繃鍏煎灞傝鍙� MDM 鍒嗙被鏁版嵁
## 娑夊強椤甸潰
-- MDM 鐗╂枡绠＄悊椤甸潰锛堟柊澧�/缂栬緫鐗╂枡锛�
-- MES 鐗╂枡绠＄悊椤甸潰锛堟柊澧�/缂栬緫鐗╂枡锛�
+- MDM 鐗╂枡鍒嗙被绠＄悊椤甸潰锛堜富瑕佺淮鎶ゅ叆鍙ｏ級
+- MDM 鐗╂枡绠＄悊椤甸潰锛堟柊澧�/缂栬緫鐗╂枡閫夋嫨鍒嗙被锛�
+- MES 鐗╂枡绠＄悊椤甸潰锛堟柊澧�/缂栬緫鐗╂枡閫夋嫨鍒嗙被锛�
## 涓氬姟娴佺▼涓庢暟鎹甫鍏�
-1. 鐗╂枡鍒嗙被缁熶竴浣跨敤 `mes_md_item_type` 琛紝MDM 鍜� MES 妯″潡鍏辩敤鍚屼竴濂楀垎绫绘暟鎹�
-2. 鐗╂枡绫诲瀷瀛楁 `itemType` 鐢ㄤ簬蹇�熼�夋嫨锛�1鍘熸枡銆�2鍗婃垚鍝併��3鎴愬搧銆�4杈呮枡
-3. 褰撻�夋嫨 `categoryId` 鏃讹紝鐩存帴鍏宠仈鍒嗙被 ID锛涘綋鍙�夋嫨 `itemType` 鏃讹紝绯荤粺鑷姩鍖归厤瀵瑰簲鍚嶇О鐨勫垎绫�
+1. 鐗╂枡鍒嗙被缁熶竴浣跨敤 `mdm_item_category` 琛紝MDM 鍜� MES 妯″潡鍏辩敤鍚屼竴濂楀垎绫绘暟鎹�
+2. 鍒嗙被鏂板 `itemOrProduct` 瀛楁鍏煎 MES 鐨� ITEM/PRODUCT 鏍囪瘑
+3. 鐗╂枡绫诲瀷瀛楁 `itemType` 鐢ㄤ簬蹇�熼�夋嫨锛�1鍘熸枡銆�2鍗婃垚鍝併��3鎴愬搧銆�4杈呮枡
+
+## 瀛楁鏄犲皠
+
+| MDM 瀛楁 (mdm_item_category) | MES 瀛楁 (mes_md_item_type) | 璇存槑 |
+|------------------------------|----------------------------|------|
+| id | id | 鍒嗙被缂栧彿 |
+| code | code | 鍒嗙被缂栫爜 |
+| name | name | 鍒嗙被鍚嶇О |
+| parentId | parentId | 鐖跺垎绫荤紪鍙� |
+| itemType (Integer) | itemOrProduct (String) | 绫诲瀷鏍囪瘑 |
+| sort | sort | 鎺掑簭 |
+| status | status | 鐘舵�� |
+| remark | remark | 澶囨敞 |
+
+### itemType 涓� itemOrProduct 鏄犲皠鍏崇郴
+
+| itemType | 璇存槑 | itemOrProduct |
+|----------|------|---------------|
+| 1 | 鐗╂枡 | ITEM |
+| 2 | 浜у搧 | PRODUCT |
+| 3 | 鍗婃垚鍝� | ITEM |
+| NULL | 鍏ㄩ儴 | - |
## API
-### 鑾峰彇鐗╂枡鍒嗙被鍒楄〃
+### MDM 鍒嗙被绠＄悊锛堜富瑕佹帴鍙ｏ級
| 鏂规硶 | 璺緞 | 璇存槑 |
|------|------|------|
-| GET | /admin-api/mes/md/item-type/list | 鑾峰彇鐗╂枡鍒嗙被鍒楄〃 |
+| POST | /admin-api/mdm/category/create | 鍒涘缓鐗╂枡鍒嗙被 |
+| PUT | /admin-api/mdm/category/update | 鏇存柊鐗╂枡鍒嗙被 |
+| DELETE | /admin-api/mdm/category/delete | 鍒犻櫎鐗╂枡鍒嗙被 |
+| GET | /admin-api/mdm/category/get | 鑾峰彇鍗曚釜鍒嗙被 |
+| GET | /admin-api/mdm/category/list | 鑾峰彇鍒嗙被鍒楄〃 |
+| GET | /admin-api/mdm/category/list-all-simple | 鑾峰彇鍚敤鐨勫垎绫诲垪琛紙涓嬫媺妗嗭級 |
-**璇锋眰鍙傛暟锛�**
+**璇锋眰鍙傛暟锛圡dmItemCategorySaveReqVO锛夛細**
| 鍙傛暟 | 绫诲瀷 | 蹇呭～ | 璇存槑 |
|------|------|------|------|
-| status | Integer | 鍚� | 鐘舵�佺瓫閫� |
-
-**鍝嶅簲瀛楁锛�**
-
-| 瀛楁 | 绫诲瀷 | 璇存槑 |
-|------|------|------|
-| id | Long | 鍒嗙被缂栧彿 |
-| code | String | 鍒嗙被缂栫爜 |
-| name | String | 鍒嗙被鍚嶇О |
-| parentId | Long | 鐖跺垎绫荤紪鍙� |
-| itemOrProduct | String | 鐗╂枡/浜у搧鏍囪瘑 |
-| sort | Integer | 鎺掑簭 |
-| status | Integer | 鐘舵�� |
+| id | Long | 鍚� | 鍒嗙被缂栧彿锛堟洿鏂版椂蹇呭～锛� |
+| parentId | Long | 鍚� | 鐖跺垎绫荤紪鍙� |
+| code | String | 鏄� | 鍒嗙被缂栫爜 |
+| name | String | 鏄� | 鍒嗙被鍚嶇О |
+| itemType | Integer | 鍚� | 閫傜敤鐗╂枡绫诲瀷锛�1鐗╂枡銆�2浜у搧銆�3鍗婃垚鍝併�丯ULL鍏ㄩ儴 |
+| itemOrProduct | String | 鍚� | 鐗╂枡/浜у搧鏍囪瘑锛欼TEM銆丳RODUCT锛堝吋瀹筂ES锛� |
+| sort | Integer | 鍚� | 鎺掑簭 |
+| status | Integer | 鏄� | 鐘舵�侊細0鍚敤銆�1绂佺敤 |
+| remark | String | 鍚� | 澶囨敞 |
**鍝嶅簲绀轰緥锛�**
```json
{
"code": 0,
- "data": [
- {
- "id": 1,
- "code": "RAW001",
- "name": "鍘熸枡",
- "parentId": 0,
- "itemOrProduct": "1",
- "sort": 1,
- "status": 0
- }
- ]
+ "data": {
+ "id": 1,
+ "parentId": 0,
+ "code": "RAW001",
+ "name": "鍘熸枡",
+ "itemType": 1,
+ "itemOrProduct": "ITEM",
+ "sort": 0,
+ "status": 0
+ }
}
```
-### 鑾峰彇鐗╂枡鍒嗙被璇︽儏
+### MES 鍒嗙被鎺ュ彛锛堝吋瀹逛繚鐣欙級
| 鏂规硶 | 璺緞 | 璇存槑 |
|------|------|------|
-| GET | /admin-api/mes/md/item-type/get | 鑾峰彇鐗╂枡鍒嗙被璇︽儏 |
+| GET | /admin-api/mes/md/item-type/list | 鑾峰彇鐗╂枡鍒嗙被鍒楄〃 |
+| GET | /admin-api/mes/md/item-type/simple-list | 鑾峰彇绮剧畝鍒楄〃锛堜笅鎷夋锛� |
-**璇锋眰鍙傛暟锛�**
-
-| 鍙傛暟 | 绫诲瀷 | 蹇呭～ | 璇存槑 |
-|------|------|------|------|
-| id | Long | 鏄� | 鍒嗙被缂栧彿 |
-
-### 淇濆瓨鐗╂枡鍒嗙被
-
-| 鏂规硶 | 璺緞 | 璇存槑 |
-|------|------|------|
-| POST | /admin-api/mes/md/item-type/create | 鍒涘缓鐗╂枡鍒嗙被 |
-| PUT | /admin-api/mes/md/item-type/update | 鏇存柊鐗╂枡鍒嗙被 |
-
-**璇锋眰鍙傛暟锛�**
-
-| 鍙傛暟 | 绫诲瀷 | 蹇呭～ | 璇存槑 |
-|------|------|------|------|
-| id | Long | 鍚� | 鍒嗙被缂栧彿锛堟洿鏂版椂蹇呭～锛� |
-| code | String | 鏄� | 鍒嗙被缂栫爜 |
-| name | String | 鏄� | 鍒嗙被鍚嶇О |
-| parentId | Long | 鍚� | 鐖跺垎绫荤紪鍙� |
-| itemOrProduct | String | 鍚� | 鐗╂枡/浜у搧鏍囪瘑 |
-| sort | Integer | 鍚� | 鎺掑簭 |
-| status | Integer | 鍚� | 鐘舵�� |
+> 娉ㄦ剰锛歁ES 鍒嗙被鎺ュ彛搴曞眰宸叉敼涓鸿鍙� MDM 鍒嗙被鏁版嵁锛屽缓璁墠绔粺涓�浣跨敤 MDM 鍒嗙被鎺ュ彛銆�
## 瀛楁灞曠ず瑙勫垯
| 瀛楁 | 灞曠ず浣嶇疆 | 璇存槑 |
|------|----------|------|
-| categoryId | 鏂板/缂栬緫琛ㄥ崟 | 鐗╂枡鍒嗙被涓嬫媺妗嗭紝鏁版嵁鏉ユ簮锛歮es_md_item_type |
+| categoryId / itemTypeId | 鏂板/缂栬緫琛ㄥ崟 | 鐗╂枡鍒嗙被涓嬫媺妗嗭紝鏁版嵁鏉ユ簮锛歮dm_item_category |
| itemType | 鏂板/缂栬緫琛ㄥ崟 | 鐗╂枡绫诲瀷蹇嵎閫夋嫨锛�1鍘熸枡銆�2鍗婃垚鍝併��3鎴愬搧銆�4杈呮枡 |
+| itemOrProduct | 鍒嗙被琛ㄥ崟 | 鐗╂枡/浜у搧鏍囪瘑锛岀敤浜� MES 鍏煎 |
## 涓氬姟瑙勫垯璇存槑
| 鍦烘櫙 | 瑙勫垯 |
|------|------|
-| 鐗╂枡鍒嗙被閫夋嫨 | 浣跨敤 `mes_md_item_type` 琛紝MDM 鍜� MES 鍏辩敤鍚屼竴濂楀垎绫绘暟鎹� |
-| itemType 涓� categoryId 鍏崇郴 | 褰� categoryId 涓虹┖鏃讹紝鍙牴鎹� itemType 鑷姩鍖归厤瀵瑰簲鍚嶇О鐨勫垎绫� |
-| itemType 鏄犲皠 | 1鈫掑師鏂欙紝2鈫掑崐鎴愬搧锛�3鈫掓垚鍝侊紝4鈫掕緟鏂� |
-| 鍒嗙被鏍￠獙 | 淇濆瓨鐗╂枡鏃讹紝浼氶�氳繃 RPC API 鏍￠獙鍒嗙被鏄惁瀛樺湪 |
+| 鍒嗙被绠＄悊 | 缁熶竴鍦� MDM 妯″潡绠＄悊锛孧ES 妯″潡鍙 |
+| 鍒嗙被鍒犻櫎 | 鏈夊瓙鍒嗙被鎴栨湁鐗╂枡寮曠敤鏃朵笉鍙垹闄� |
+| 鐗╂枡鍚屾 | MDM 鐗╂枡鍚屾鍒� MES 鏃讹紝鍒嗙被 ID 淇濇寔涓�鑷� |
+| 鍏煎鎬� | MES 鍒嗙被鏈嶅姟浼樺厛浠� MDM 鑾峰彇锛屾湰鍦拌〃浣滀负鍥為�� |
## 娉ㄦ剰浜嬮」
-- 鐗╂枡鍒嗙被鏁版嵁鍦� MES 妯″潡绠＄悊锛孧DM 妯″潡閫氳繃 RPC API 璋冪敤鑾峰彇
-- `itemType` 鏄揩鎹烽�夋嫨瀛楁锛屾渶缁堜細杞崲涓哄搴旂殑鍒嗙被缂栫爜
-- 濡傛灉鍚屾椂璁剧疆浜� `categoryId` 鍜� `itemType`锛屼紭鍏堜娇鐢� `categoryId`
-- 鍒嗙被鏀寔鏍戝舰缁撴瀯锛屽彲閫氳繃 `parentId` 鏋勫缓灞傜骇鍏崇郴
+1. **鑿滃崟鍙樻洿**锛歁ES 鐨�"鐗╂枡浜у搧鍒嗙被"鑿滃崟宸茬鐢紝缁熶竴浣跨敤 MDM 鐨�"鐗╂枡鍒嗙被"鑿滃崟
+2. **鏁版嵁涓�鑷存��**锛氫袱琛ㄦ暟鎹凡鍚屾锛屽悗缁淮鎶ゅ彧闇�鎿嶄綔 MDM 鍒嗙被
+3. **API 鍏煎**锛歁ES 鍒嗙被鎺ュ彛淇濈暀锛屽簳灞傝鍙� MDM 鏁版嵁锛屽墠绔彲缁х画浣跨敤
+4. **瀛楁杞崲**锛氬墠绔睍绀烘椂锛宍itemOrProduct` 鍊奸渶杞崲涓轰腑鏂囷紙ITEM=鐗╂枡锛孭RODUCT=浜у搧锛�
\ No newline at end of file
--
Gitblit v1.9.3